SuperAPI AI 工具集

php-best-practices

编程与开发

查看项目

更新于 10-15 22:13

技能介绍

用途:按 PSR 编码规范、SOLID 原则与代码质量准则编写 PHP,适用于 PHP 风格、设计、重构、命名和守卫子句,不适用于其他语言或无关任务。优先级为 P1(高)。

主要能力:编码风格遵循 PSR-12,强制 4 空格缩进、函数与方法左花括号同行;组织上每文件一个类,use 语句跟在 namespace 之后,可用 PHP CS Fixer 的 PSR-12 预设;命名用 PascalCase(类,如 UserService)、camelCase(方法与变量,如 getUserById)、SNAKE_CASE(类常量,如 MAX_RETRIES)。SOLID 方面强调单一职责、依赖倒置(构造函数注入接口类型提示)、关注点分离。逻辑与性能方面建议守卫子句提前返回错误条件,return 后不再写 else,减少嵌套;用 Trait(如 HasTimestamps)承载横切行为,保持轻量;辅助函数放入类中,避免全局命名空间逻辑。

反模式:禁止巨型类、硬编码魔法数字(应定义命名类常量)、深层嵌套、在服务中 echo。

使用方式与限制:资料未提供安装命令或具体调用步骤,仅给出实施准则;结构示例为 src/ 下按领域分目录(如 Services、Repositories)和 Helpers(纯函数/Trait)。缺失的收费、价格、平台等信息暂未提供。