SuperAPI AI 工具集

php-quality-tooling

测试与质量

查看项目

更新于 10-16 05:48

技能介绍

用途:在非 Laravel 的 PHP 项目中搭建代码质量工具链,覆盖 PHPStan(静态分析、类型安全、死代码)、Rector(自动升级与重构)、PHP-CS-Fixer(编码规范格式化)三件互补工具,并接入 CI。三者不重叠,建议全部运行。

主要能力:提供新项目与遗留代码库的决策指南(PHPStan 级别与 baseline 策略、Rector 的 withPhpSets()/withPhpLevel()、PHP-CS-Fixer 规则集),以及 phpstan.neon、rector.php、.php-cs-fixer.dist.php 和 composer 脚本 CI 流水线的可复制模板。

使用方式:安装命令为 composer require --dev phpstan/phpstan rector/rector friendsofphp/php-cs-fixer;随后运行 vendor/bin/php-cs-fixer check(仅检查不写入)、vendor/bin/phpstan analyse、vendor/bin/rector process --dry-run 预览重构。技能要求先并行调用探索代码库、研究最新文档与查询配置 API 的代理,实现后用校验代理验证。

关键规则:同一仓库只用 PHP-CS-Fixer 或 Pint 之一;Rector 先跑 --dry-run 并先提交代码;采用高 PHPStan 级别加 baseline 而非降低级别;CI 顺序为格式化检查→PHPStan→测试;在 composer.json 中以 --dev 固定工具版本。

适用场景:新项目建议 PHPStan 8-9 级以上、PHP-CS-Fixer @PER-CS 或 @PER-CS3x0、Rector withPhpSets() 加 deadCode/codeQuality 预设;遗留项目从可通过的级别起步、生成 baseline 并逐 PR 提升一级。

限制:不适用于 Laravel 项目(应使用 Pint 与 Larastan)、测试框架搭建(php-testing)或语言语法问题(php-language-modern)。具体模板内容与完整配置细节暂未提供。