SuperAPI AI 工具集

laravel-api-architect

编程与开发

查看项目

更新于 10-15 16:49

技能介绍

用途:为 Laravel 项目提供生产级 API 开发规范,覆盖控制器、服务层、仓储层、请求验证与响应转换,适用于构建 REST 端点、JSON 响应以及需要 Sanctum/Passport 认证的业务系统。

主要能力与架构约定:采用分层设计——控制器只处理 HTTP 请求与响应;Service 承载业务逻辑、事务与事件;Repository 处理复杂可复用查询(可选,按需使用);Model 负责数据、关系与作用域。要求全面类型标注(返回、参数、属性),验证放在 Form Request 中而非控制器,响应通过 API Resource 转换,不直接返回模型。

使用方式要点:控制器通过构造函数注入 Service,返回 JsonResponse 并使用 HTTP 状态常量(如 Response::HTTP_CREATED);Service 中使用 DB::transaction 包裹写操作并触发事件;Form Request 定义 authorize 与 rules;API Resource 中通过 whenLoaded 输出条件关系、通过 when 输出条件属性。推荐用 ->query() 获得 IDE 补全,服务和控制器使用 final class 与 readonly 构造属性,状态字段使用 Enum。

常用命令:php artisan make:model Order -mfsc、php artisan make:request StoreOrderRequest、php artisan make:resource OrderResource、php artisan make:policy OrderPolicy --model=Order、php artisan route:list --path=api、./vendor/bin/pint。

参考资料按需加载:Sanctum 认证(令牌、SPA、abilities)、Passport OAuth、Service-Repository 细节。

限制:资料未提供安装方式、支持的平台范围、收费与价格信息,暂未提供;其针对 PHP 8.4+ 与 Laravel 12+,低版本适用性未说明。