使用 Composer 管理 PHP 代码质量工具是现代开发标准,通过 composer require --dev 安装 PHPStan 和 Psalm 可确保环境一致;运行 init 命令生成配置文件 phpstan.neon 和 psalm.xml,并调整扫描级别与路径;在 composer.json 中添加 analyse、phpstan、psalm 脚本实现一键检查;集成到 Git 钩子、CI/CD 流程及编辑器插件中,提升团队协作效率与代码健壮性,需定期更新工具版本与配置以保持有效性。

推荐将 PHPStan、Psalm 等作为 dev 依赖安装到项目中,这样每个开发者和 CI 环境都能使用相同的版本。
1. 安装 PHPStan
运行以下命令:
composer require --dev phpstan/phpstan- 可选:安装扩展包,如
phpstan/phpstan-phpunit
安装完成后,可通过 vendor/bin/phpstan 执行。
2. 安装 Psalm
运行命令:
立即学习“PHP免费学习笔记(深入)”;
composer require --dev vimeo/psalm
首次运行 vendor/bin/psalm 会自动生成配置文件 psalm.xml。
3. 创建配置文件
为工具创建配置文件,以定义扫描范围、级别、忽略路径等。
本文档主要讲述的是maven使用方法;Maven是基于项目对象模型的(pom),可以通过一小段描述信息来管理项目的构建,报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码,运行测试,生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
-
PHPStan:运行
vendor/bin/phpstan init-config生成phpstan.neon -
Psalm:运行
vendor/bin/psalm --init生成psalm.xml
根据项目需要调整配置,例如设置 level=5 或排除测试目录。
4. 添加 Composer 脚本
在 composer.json 中添加脚本,简化调用:
"scripts": {
"analyse": [
"phpstan analyse src/",
"psalm"
],
"phpstan": "phpstan analyse",
"psalm": "psalm"
}
之后可通过 composer analyse 一键运行所有检查。
5. 集成到开发流程
让代码质量检查成为开发习惯:
- 在 Git 提交钩子中调用
composer analyse(可用 composer-scripts 或 husky + lint-staged) - 在 CI 中(如 GitHub Actions、GitLab CI)添加步骤执行检查
- 结合编辑器插件(如 PHPStorm 的 PHPStan 插件)实时提示
基本上就这些。通过 Composer 管理 PHP 代码质量工具,能有效避免“在我机器上能跑”的问题,统一团队标准,提升项目长期可维护性。不复杂但容易忽略的是保持配置更新和定期升级工具版本。









