用途:在编写、审查或重构 Laravel PHP 代码时应用的一套最佳实践规则,涵盖控制器、模型、迁移、表单请求等改动。能力:以规则文件索引组织,每个规则文件说明做什么及原因。索引按关注点映射规则文件,例如查询数量与索引读 db-performance,子查询与聚合读 advanced-queries,模型与关系读 eloquent,认证授权与输入安全读 security,验证读 validation,控制器与路由绑定读 routing,Schema 读 migrations,队列作业读 queue-jobs,缓存读 caching,外部请求读 http-client,异常读 error-handling,事件与通知、邮件、计划任务、集合、Blade、配置、测试、命名风格、架构各有对应规则文件。使用方式:先检查改动文件、邻近代码、项目配置和相关测试中的既有模式;Laravel 有多种可行写法,若代码库已采用某种模式就沿用,不引入第二种方式,规则只是无既有模式时的默认值。将每个受影响关注点映射到规则索引,编辑前阅读对应规则文件,跳过无关文件。做最小且自洽的改动,保持既有架构与命名。用 search-docs 核实与安装版本相关的 API,或直接检查已安装框架。先运行最相关的测试,必要时再运行格式化与静态分析检查,完成前对照每条映射规则复查 diff。决策规则:优先使用框架功能和既有抽象,而非新增辅助或依赖;避免推测性抽象,仅在形成清晰领域边界、消除实质重复或使行为可独立测试时抽取代码;数据库访问不得进入 Blade 视图,防止控制器、资源、作业和序列化中隐藏的 N+1 查询。限制:具体命令、安装方式和价格暂未提供。
laravel-best-practices
编程与开发
更新于 10-16 03:49