Agent Skills
返回列表
Laravel PHP 工程规范

Laravel PHP 工程规范

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-compound-eng-php-laravel。

技能介绍

要解决的具体问题

Laravel 项目常见的质量问题往往不在语法报错，而在工程边界：控制器堆积业务逻辑、验证散落在方法里、迁移文件可重复执行、Eloquent 查询引入 N+1、API 返回原始模型、第三方响应被当成可信数据。这套技能把 PHP 8.4 与 Laravel 的常见约束写成可执行规范，帮助模型和工程师生成更一致、更可审查的代码。

技能如何工作

核心能力：

  • 代码风格：要求 strict_types、早返回、?string 类型、void 返回、类导入、数组验证，以及 PHPStan level 8+。
  • 现代 PHP：使用 readonly 类、枚举、match、构造函数提升、new 链式调用、array_find() 等特性。
  • 架构：薄控制器、服务类、Action 类、Form Request、事件监听、特性文件夹组织。
  • 数据与 API：约束迁移、事务标志、Eloquent 查询、API Resource、统一错误信封、队列批处理与失败处理。
  • 测试：区分 Feature 与 Unit，使用工厂、Http::fake()、Queue::fake()、断言副作用与持久化。

适用边界或注意点

适用于 Laravel 后端、API、队列、迁移和 PHPUnit 场景。它偏重工程规范，不替代具体业务建模；对非 Laravel PHP 项目只取 PHP 风格部分；生成代码仍需结合项目依赖、权限模型和第三方契约进行人工审查。

使用场景

  • 在 Laravel 项目中重构控制器，把验证移到 Form Request、业务逻辑移到服务类，并生成薄控制器。
  • 为已有 API 统一响应信封和错误结构，使用 API Resource 控制序列化字段，并添加权限字段。
  • 编写迁移时处理外键索引、数据回填、事务标志和共享环境不可编辑已跑迁移。
  • 用 PHPUnit Feature 测试覆盖路由、验证、队列副作用与数据库断言，使用 Http::fake 和工厂。

适合人员

  • 负责 Laravel 后端维护的工程师：要统一控制器、服务、Form Request 与事件监听边界。
  • 编写 Eloquent 查询的开发者：要减少 N+1、控制序列化并避免批量更新绕过 Observer。
  • 维护数据库迁移的工程师：要安全处理回填、事务、索引和共享环境迁移约束。
  • 需要稳定 PHPUnit 用例的测试负责人：要覆盖 HTTP、验证、队列和数据库副作用断言。