审查或编写 PHP 8.x 代码时，先确认 PHP 版本…

当需要审查、编写或审计 PHP 代码并确保其符合 PHP 8.x、PSR、SOLID 与安全最佳实践时使用。

适用场景

解决思路

1. 在给任何建议前，检查项目 PHP 版本：查看 composer.json 的 require.php，例如 ^8.1 -> 8.1 及以下规则，^8.3 -> 8.3 及以下规则，>=8.4 -> 8.4 及以下规则。
2. 同时检查运行时版本：运行 php -v，例如 PHP 8.3.12。
3. 根据版本只建议该项目可用的语法：8.0+ 联合类型、match、nullsafe、命名参数、构造器属性提升、attributes；8.1+ 枚举、readonly 属性、交集类型、一等可调用、never、fibers；8.2+ readonly 类、DNF 类型、true/false/null 独立类型；8.3+ 类型化类常量、#[\Override]、json_validate()；8.4+ 属性钩子、非对称可见性、#[\Deprecated]、无括号 new；8.5+ 管道操作符 |>。
4. 不要建议检测到的版本不存在的语法；若用户询问升级或新特性，说明各版本新增特性。
5. 按优先级检查/应用规则：先 Type System (CRITICAL)，再 Modern PHP Features (CRITICAL)，再 PSR Standards (HIGH)，再 SOLID Principles (HIGH)，再 Error Handling (HIGH)，再 Performance (MEDIUM)，再 Security (CRITICAL)。
6. 应用 Type System 9 条规则：在每个文件声明 strict types；始终声明返回类型；为所有参数加类型；为类属性加类型；有效使用联合类型；使用交集类型；正确处理可空类型；在合适的返回场景使用 void/never；尽可能避免 mixed 类型。
7. 应用 Modern PHP Features 16 条规则：8.0+ 使用构造器属性提升；用 match 表达式替代 switch；用命名参数提升清晰度；用 nullsafe 操作符 ?->；用 attributes 存放元数据；8.1+ 用枚举替代常量；用带方法和接口的枚举；用 readonly 实现不可变数据；使用一等可调用语法；使用箭头函数（7.4+，与 8.1+ 特性配合良好）；8.2+ 使用 readonly 类；8.3+ 使用类型化类常量 const string NAME = 'foo'；使用 #[\Override] 捕获父方法拼写错误；8.4+ 用属性钩子替代 getter/setter；用非对称可见性 public private(set) 控制访问；8.5+ 用管道操作符 |> 进行函数式链式调用。
8. 应用 PSR Standards 6 条规则：遵循 PSR-4 自动加载；遵循 PSR-12 编码风格；遵循类命名约定；遵循方法命名约定；每个文件一个类；正确使用命名空间。
9. 应用 SOLID Principles 5 条规则：单一职责，只有一个变更原因；开闭原则，扩展而非修改；里氏替换，子类型必须可替换；接口隔离，使用小而专注的接口；依赖倒置，依赖抽象。
10. 应用 Error Handling 5 条规则：为不同错误创建具体异常；把异常组织成有意义的层次结构；捕获具体异常，而不是通用 \Exception；用 finally 保证资源清理；绝不使用 @ 错误抑制运算符。
11. 应用 Performance 5 条规则：避免全局变量，使用依赖注入；延迟加载昂贵操作直到需要时；优先使用原生数组函数而不是手写循环；优先使用原生字符串函数而不是正则；用生成器处理大数据集。
12. 应用 Security 5 条规则：验证并清理所有外部输入；根据上下文（HTML、JS、URL）转义输出；使用 password_hash/password_verify，绝不用 MD5/SHA1；所有 SQL 查询使用预处理语句；验证文件类型、大小、名称，并把上传文件存储在 web root 之外。
13. 阅读详细规则文件：rules/type-strict-mode.md、rules/modern-constructor-promotion.md、rules/modern-enums.md、rules/solid-srp.md。
14. 使用快速参考模式：declare(strict_types=1);；8.0+ 构造器提升 + 8.1+ readonly；8.1+ 带方法枚举；8.0+ match；8.0+ nullsafe；8.3+ 类型化类常量和 #[\Override]；8.4+ 属性钩子和非对称可见性；8.5+ 管道操作符。
15. 审计代码时按 file:line - [category] Description of issue 格式输出发现；例如 src/Services/UserService.php:15 - [type] Missing return type declaration，src/Models/Order.php:42 - [modern] Use match expression instead of switch，src/Controllers/ApiController.php:28 - [solid] Class has multiple responsibilities。
16. 如何使用时读取各规则文件，例如 rules/modern-constructor-promotion.md、rules/type-strict-mode.md、rules/solid-srp.md。

适用边界 · 注意事项

• 不适用于非 PHP 项目。
• 当项目使用 PHP 7.x 或更早版本时，不要套用 8.0+ 现代语法建议；仅可参考与版本无关的 PSR、SOLID、错误处理、性能和通用安全规则。