SuperAPI AI 工具集

php-best-practices

测试与质量

查看项目

更新于 10-15 17:20

技能介绍

用途:用于编写或审查 PHP 代码、实现类与接口、使用 PHP 8.x 现代特性、保证类型安全、遵循 PSR 标准以及应用设计模式时参考。核心前提是先检测项目 PHP 版本,避免建议项目版本不存在的语法:检查 composer.json 的 require.php(如 ^8.1、^8.3、>=8.4),并运行 php -v 查看运行时版本,只建议已检测版本支持的特性。

主要能力:共 51 条规则,按优先级分为七类。类型系统(type-,9 条,CRITICAL):严格模式、返回类型、参数类型、属性类型、联合类型、交叉类型、可空类型、void/never、避免 mixed。现代特性(modern-,16 条,CRITICAL):构造器属性提升、match 表达式、命名参数、nullsafe 运算符、attributes(8.0+);枚举及带方法的枚举、readonly 属性、一等可调用、箭头函数(8.1+);readonly 类(8.2+);类型化类常量、#[\Override](8.3+);属性钩子、非对称可见性(8.4+);管道运算符 |>(8.5+)。PSR 标准(psr-,6 条,HIGH):PSR-4 自动加载、PSR-12 编码风格、类与方法命名、文件结构、命名空间使用。SOLID(solid-,5 条,HIGH):单一职责、开闭、里氏替换、接口隔离、依赖倒置。错误处理(error-,5 条,HIGH):自定义异常、异常层级、捕获具体异常、finally 清理、禁止 @ 抑制。性能(perf-,5 条,MEDIUM):避免全局变量、延迟加载、原生数组函数、原生字符串函数、生成器。安全(sec-,5 条,CRITICAL):输入校验、按上下文转义输出、密码哈希、预处理语句、文件上传校验并存放于 web 根目录之外。

使用方式:阅读各规则文件(如 rules/type-strict-mode.md、rules/modern-constructor-promotion.md、rules/solid-srp.md)获取示例与说明;审计代码时按 file:line - [category] 描述 的格式输出结果,例如 src/Services/UserService.php:15 - [type] Missing return type declaration。

限制:具体规则文件内容、安装方式与收费情况暂未提供;仅在项目已支持的 PHP 版本范围内提建议,升级或新特性相关问题需说明各版本可用的能力。