用途:在 Symfony 项目中执行代码质量检查,覆盖代码风格(PHP-CS-Fixer)、静态分析(PHPStan)与类型安全检查。适用时机包括提交或发起拉取请求之前、在 Symfony 项目中配置或调优 PHP-CS-Fixer 与 PHPStan,以及 CI 质量任务失败需要定位并修复原因时。
默认工作流:先检测项目已有的工具与配置文件(如 .php-cs-fixer.dist.php、phpstan.dist.neon);再以 dry-run 加 diff 方式运行风格修复工具,确认后再实际应用;随后按项目配置的级别运行 PHPStan 并修复报告的类型问题;最后在风格与分析均通过后再运行测试套件。
约束与护栏:不得通过提高 PHPStan 级别或添加 baseline 条目来让检查通过;仅涉及风格的改动应单独提交,与行为变更分开;不得在没有书面理由的情况下用 ignore 规则压制错误;应使用项目所用的运行方式(Docker 或宿主机),并遵循运行时上下文。
渐进式披露:该文件用于执行姿态与风险控制,需要深入实现细节时再打开引用文档。输出契约包括:运行的命令及其结果、已应用的修复(风格与类型分开)、仍需决策的遗留问题。参考资料为 reference.md。
限制:资料未提供具体命令示例、支持的 PHPStan 级别范围、版本要求或平台细节,暂未提供。