SuperAPI AI 工具集

laravel-best-practices

通用与其它

查看项目

更新于 10-15 18:31

技能介绍

用途:为 Laravel 13(PHP 8.3)应用开发提供规范指引,适用于创建控制器、模型、服务、迁移、数据库查询、验证与表单请求、API 设计及整体应用结构搭建时参考。

主要能力:包含 31 条规则,分 7 类并按优先级组织:架构与结构(CRITICAL,arch- 前缀,含服务类、Action 类、仓储模式、DTO、值对象、事件驱动、功能文件夹、队列路由);Eloquent 与数据库(CRITICAL,eloquent- 前缀,含预加载防 N+1、分块处理大数据集、查询作用域、模型事件与观察者、关系、类型转换、访问器与修改器、软删除、数据修剪、pgvector 向量搜索);控制器与路由(HIGH,含资源控制器、单动作控制器、RESTful 方法、表单请求、API 资源、中间件、依赖注入);验证与请求(HIGH,含表单请求类、自定义规则、条件规则、数组验证、后置钩子);安全(HIGH,仅 sec-mass-assignment 防批量赋值);性能(MEDIUM,暂无规则文件);API 设计(MEDIUM,暂无规则文件)。

使用方式:阅读 rules/ 目录下的单条规则文件(如 rules/arch-service-classes.md、rules/eloquent-eager-loading.md、rules/validation-form-requests.md、rules/_sections.md),每条含 YAML 元数据、原因说明及正反示例;完整文档见 AGENTS.md。参考资料中未提供具体安装命令。

适用场景:构建可扩展、易维护的 Laravel 13 应用,从中提取业务逻辑到服务类、优化数据库查询、规范 REST 接口与请求验证。

限制:部分分类(性能、API 设计)尚无实际规则文件;资料未说明收费、价格或平台支持范围。