<p>首先通过 composer 安装 phpStan 为开发依赖,命令为 composer require –dev phpstan/phpstan;接着在项目根目录创建 phpstan.neon 配置文件,设置分析级别 level: 5 和扫描路径 paths: – src/;推荐在 composer.json 中添加 scripts 脚本 “analyse”: “phpstan analyse”,以便运行 composer analyse 执行检查;最后可将 PHPStan 集成到 CI/CD 如 gitLab CI 中,通过 .gitlab-ci.yml 添加步骤确保代码质量。</p>

PHPStan 是一个强大的 PHP 静态分析工具,能够帮助你发现代码中的潜在错误而无需实际运行代码。通过 Composer 可以轻松将 PHPStan 集成到你的 PHP 项目中,并作为开发阶段的检查工具。
安装 PHPStan
在项目根目录下使用 Composer 安装 PHP-Stan(推荐作为开发依赖):
composer require –dev phpstan/phpstan
这会将 PHPStan 安装到 vendor/bin 目录下,你可以通过 ./vendor/bin/phpstan 来运行它。
创建配置文件
在项目根目录创建一个 phpstan.neon 文件,用于定义分析规则级别和扫描范围:
立即学习“PHP免费学习笔记(深入)”;
parameters:
level: 5
paths:
– src/
- level:从 0 到 9,数字越高检查越严格。建议从 5 开始逐步提升。
- paths:指定要分析的目录,如 src/ 或 app/。
添加 Composer 脚本(可选但推荐)
为了更方便地执行分析,可以在 composer.json 中添加脚本命令:
“scripts”: {
“analyse”: “phpstan analyse”
}
之后就可以用以下命令运行静态分析:
composer analyse
结合 CI/CD 使用
你也可以在 github Actions、GitLab CI 或其他持续集成环境中调用 PHPStan,确保每次提交都通过代码质量检查。例如在 GitLab CI 的 .gitlab-ci.yml 中添加:
phpstan:
script:
– composer install
– ./vendor/bin/phpstan analyse
基本上就这些。通过 Composer 集成 PHPStan 简单高效,能显著提升代码健壮性。不复杂但容易忽略的是配置级别和路径设置,建议根据项目实际情况调整 level 并逐步优化。


