用途:面向 Laravel Eloquent ORM 的编码规范与优化指南,帮助开发者写出高效、可维护的数据库查询代码。
主要能力:
- 查询优化:始终使用 with() 预加载关联避免 N+1;用 select() 只取所需列;用查询作用域(scope)复用查询逻辑。
- 关联管理:为关联方法声明返回类型(如 BelongsTo、HasMany);用 withCount 高效统计关联数量。
- 安全与类型:通过 $fillable 白名单或 $guarded 黑名单做批量赋值保护,避免 $guarded = [];用 $casts 定义 datetime、array、boolean、integer 等类型转换。
- 大数据集:用 chunk(200, ...) 或 lazy()->each() 分块处理以节省内存。
- 数据库层操作:用 update()、increment() 等单条 SQL 替代循环逐条更新。
- 模型事件:在 booted() 中合理使用 creating、deleting 等事件。
- 常见陷阱:避免循环内查询(改用 whereIn);为外键和查询列建立索引,必要时使用复合索引;开发环境用 Model::preventLazyLoading(!app()->isProduction()) 阻止懒加载。
使用方式:作为 Claude 代理技能加载,在编写或审查 Laravel Eloquent 代码时提供上述实践建议与示例。
适用场景:Laravel 项目的数据模型设计、查询编写、性能调优与代码审查。
限制:资料未提供安装命令、版本要求、收费信息及具体平台支持细节。