SuperAPI AI 工具集

laravel-best-practices

编程与开发

查看项目

更新于 10-16 03:49

技能介绍

用途:在编写、审查或重构 Laravel PHP 代码时应用最佳实践,覆盖控制器、模型、迁移、表单请求等场景。

主要能力:以规则文件索引组织,按关注点映射到具体规则文件,例如数据库性能、复杂查询、Eloquent、安全、验证、路由、迁移、队列任务、缓存、HTTP 客户端、错误处理、事件与通知、邮件、调度、集合、Blade 视图、配置、测试、代码风格与架构。

使用方式:先检查改动文件、邻近代码、项目配置与相关测试中的既有模式;若已有模式则遵循,不引入第二种写法。将受影响的关注点映射到规则索引,编辑前阅读对应规则文件,跳过无关文件。做最小且连贯的改动,保持现有架构与命名。对版本敏感的 Laravel API,用 search-docs 核实已安装版本,或直接检查已安装框架。先运行最相关的测试,必要时再运行格式化与静态分析检查,完成后对照每条映射规则复查 diff。

适用场景:Laravel 项目的日常开发、代码审查与重构,尤其是涉及数据库访问、验证、队列、缓存、测试等横切关注点时。

限制:规则是尚无既有模式时的默认值,而非覆盖项目约定的强制规则;仅在正确性或安全缺陷时才偏离既有模式,并需说明偏离原因。避免推测性抽象,仅在形成清晰领域边界、消除有意义重复或使行为可独立测试时抽取代码。数据库访问不得放入 Blade 视图,并防止控制器、资源、任务与序列化中的隐藏 N+1 查询。具体 API 语法需另行核实,资料未提供完整代码示例与安装命令。