需全局安装PHPMD并配置至PhpStorm：先用composer global require安装，将bin目录加入PATH；再在Settings→PHP→Quality Tools中指定phpmd路径并验证；接着启用PHP Mess Detector inspection并选择规则集；最后通过违规代码验证波浪线提示是否生效。
如果您在PhpStorm中希望对PHP代码执行静态分析以识别复杂度过高、未使用变量、命名违规等潜在问题，则需正确配置PHP Mess Detector（PHPMD）。以下是完成PHPMD集成与规则设置的具体步骤：
一、安装PHPMD全局依赖
PHPMD必须先通过Composer全局安装，才能被PhpStorm调用。该工具不依赖项目级依赖，全局安装确保所有项目均可复用。
1、打开终端，确认Composer已正确安装并可用，执行 composer --version 验证。
2、执行全局安装命令：composer global require "phpmd/phpmd=*" 。
立即学习“PHP免费学习笔记（深入）”；
3、获取全局bin目录路径：composer global config bin-dir --absolute，记录返回路径（如 /home/username/.composer/vendor/bin）。
4、将该路径加入系统 $PATH 环境变量（如编辑 ~/.bashrc 或 ~/.zshrc），使 phpmd 命令可在任意位置直接调用。
二、配置PHPMD路径与验证
PhpStorm需明确知道phpmd可执行文件的位置，才能将其作为质量检查工具启用。此步骤在IDE设置中完成，且必须验证成功后才可启用检查。
1、在PhpStorm中依次点击 File → Settings → Languages & Frameworks → PHP → Quality Tools → PHP Mess Detector。
2、点击 Configuration 右侧的按钮（通常为“…”或“+”图标）。
3、在弹出窗口中，点击 Path to phpmd 输入框旁的文件夹图标，浏览至上一步获取的全局bin目录，选择 phpmd 文件（Linux/macOS无扩展名；Windows为 phpmd.bat）。
4、点击 Validate 按钮，确认状态显示为 Valid；若失败，请检查路径权限、PHP版本兼容性及是否遗漏Composer bin目录到PATH。
三、启用PHPMD实时检查并选择规则集
启用后，PHPMD将在编辑器中对当前PHP文件进行即时扫描，不符合规则的代码行下方将出现黄色波浪线，并附带phpmd前缀提示信息。
1、在相同设置页面（Settings → Editor → Inspections → PHP），向下滚动找到 PHP Mess Detector validation 项。
2、勾选该项，确保其处于激活状态。
3、点击右侧的 Options 按钮，进入规则配置界面。
4、在 Ruleset 下拉菜单中，可选择预设规则集，例如：cleancode、codesize、design、naming、unusedcode；也可点击 Custom ruleset 加载本地XML规则文件。
5、勾选所需规则集后点击 OK，再点击主设置窗口的 Apply 保存。
四、验证PHPMD是否生效
配置完成后需通过实际代码触发检测，以确认整个链路（安装→路径→启用→规则）正常工作。此验证不依赖外部运行，仅靠编辑器内响应即可判断。
1、新建或打开一个PHP文件，在类中添加明显违反规则的代码，例如：public function veryLongMethodNameThatExceedsNamingConvention() { $unusedVar = true; }。
2、保存文件，观察该函数名和未使用变量是否被标记为黄色波浪线。
3、将鼠标悬停于波浪线下方，确认提示信息以 phpmd: 开头，例如 phpmd: Avoid excessively long method names 或 phpmd: Avoid unused local variables。
4、若提示未出现，检查是否已重启PhpStorm、是否在正确项目上下文中启用检查、以及所选规则集是否覆盖当前违规类型。
五、自定义规则集XML文件配置
当预设规则集无法满足团队规范时，可通过XML文件精确控制每条规则的启用状态、严重等级与参数阈值，实现细粒度管控。
1、创建一个XML文件（如 phpmd-ruleset.xml），内容结构需符合PHPMD官方XSD格式，包含 <ruleset> 根节点。
2、在 <rule ref="codesize/NPathComplexity"> 下添加 <properties><property name="minimum" value="15"/></properties> 以调整复杂度阈值。
3、将该XML文件路径填入 PHP Mess Detector Options → Custom ruleset 字段。
4、点击 Validate 确认XML语法有效且规则可加载；无效XML将导致PHPMD检查整体失效。
