在 CentOS 上使用 PhpStorm 进行代码分析
一 环境准备
- 安装 PHP 与常用扩展（CLI 必备，用于运行分析与 Composer）
- 执行：
sudo yum install -y php php-cli php-xml php-json
- 验证：
php -v
- 安装 Composer（全局管理分析工具）
- 参考官方安装脚本或使用系统包管理器安装后，执行：
composer global require "squizlabs/php_codesniffer=*" "phpmd/phpmd=*" "phpstan/phpstan" "vimeo/psalm"
- 确认工具可执行：
~/.composer/vendor/bin/phpcs --version、~/.composer/vendor/bin/phpmd --version
- 安装并启动 PhpStorm
- 从 JetBrains 下载 Linux 版，解压至如 /opt/phpstorm，运行：
/opt/phpstorm/bin/phpstorm.sh
- 首次启动按提示完成配置与激活。
二 配置 PHP 解释器与代码质量工具
- 设置 PHP 解释器
- 打开：File → Settings → Languages & Frameworks → PHP
- 在 CLI Interpreter 选择或添加 /usr/bin/php，应用设置
- 配置 PHP_CodeSniffer（风格规范）
- 路径：Settings → Languages & Frameworks → PHP → Code Sniffer
- 指定 phpcs 路径（如：~/.composer/vendor/bin/phpcs），点击 Validate 验证
- 启用检查：Editor → Inspections → PHP → PHP Code Sniffer Validation，选择规则集（如 PSR2/PSR12）
- 配置 PHPMD（代码坏味道）
- 路径：Settings → Languages & Frameworks → PHP → Quality Tools → PHP Mess Detector
- 指定 phpmd 路径（如：~/.composer/vendor/bin/phpmd），验证后启用相应 Inspection
- 配置 PHPStan / Psalm（静态分析）
- 路径：Settings → Languages & Frameworks → PHP → Code Quality Tools → PHPStan / Psalm
- 指定各自可执行文件路径，按需设置配置文件（如 phpstan.neon、psalm.xml）并启用
- 说明：PhpStorm 提供对上述工具的集成入口与 Inspection 开关，便于统一配置与联动。
三 运行分析与查看结果
- 实时分析
- 编码时自动进行语法/规范/静态分析检查，问题以红黄波浪线提示
- 悬停查看说明，按 Alt+Enter 执行快速修复（如补全 docblock、导入类、调整格式）
- 全量/局部检查
- 执行：Code → Inspect Code，选择范围（项目/目录/文件）与检查配置文件
- 在 Inspection Results 面板按严重级别（Error/Warning）浏览问题，支持批量修复与跳转定位。
四 常见问题与优化建议
- 工具未找到或无法验证
- 确认 Composer 全局 bin 目录已加入 PATH（常见为 ~/.composer/vendor/bin）
- 在 PhpStorm 工具配置页点击 Validate，若失败检查可执行权限与路径是否正确
- 规则集与配置
- 在 Editor → Inspections 调整检查项与严重级别；为 phpcs 选择 PSR2/PSR12 或在项目根目录提供自定义规则集
- 为 PHPStan/Psalm 提供层级配置（如 phpstan.neon 的 level、paths；psalm.xml 的 ignoreFiles/plugins）
- 性能优化
- 在 PhpStorm 的 Help → Edit Custom VM Options 中适当增加内存（如
-Xms2048m -Xmx2048m，视机器内存而定）
- 关闭不需要的插件、减少无关文件索引范围以提升分析速度。