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

PHP 项目中，使用 Composer 管理代码质量工具（如 PHPStan、Psalm）是现代开发的标准做法。这些工具帮助你发现潜在错误、提升代码健壮性，而通过 Composer 安装和管理它们，可以确保团队环境一致、版本可控，并方便集成到 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。

Expanso json-flatten

通过 CLI 或 MCP 服务器，使用 Expanso Edge 管道扁平化嵌套 JSON 对象。

下载

3. 创建配置文件

为工具创建配置文件，以定义扫描范围、级别、忽略路径等。

• 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 代码质量工具，能有效避免“在我机器上能跑”的问题，统一团队标准，提升项目长期可维护性。不复杂但容易忽略的是保持配置更新和定期升级工具版本。