SuperAPI AI 工具集

eloquent-best-practices

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:面向 Laravel Eloquent ORM 的编码规范与优化指南,帮助开发者写出高效、可维护的数据库查询代码。

主要能力:

  1. 查询优化:始终使用 with() 预加载关联避免 N+1;用 select() 只取所需列;用查询作用域(scope)复用查询逻辑。
  2. 关联管理:为关联方法声明返回类型(如 BelongsTo、HasMany);用 withCount 高效统计关联数量。
  3. 安全与类型:通过 $fillable 白名单或 $guarded 黑名单做批量赋值保护,避免 $guarded = [];用 $casts 定义 datetime、array、boolean、integer 等类型转换。
  4. 大数据集:用 chunk(200, ...) 或 lazy()->each() 分块处理以节省内存。
  5. 数据库层操作:用 update()、increment() 等单条 SQL 替代循环逐条更新。
  6. 模型事件:在 booted() 中合理使用 creating、deleting 等事件。
  7. 常见陷阱:避免循环内查询(改用 whereIn);为外键和查询列建立索引,必要时使用复合索引;开发环境用 Model::preventLazyLoading(!app()->isProduction()) 阻止懒加载。

使用方式:作为 Claude 代理技能加载,在编写或审查 Laravel Eloquent 代码时提供上述实践建议与示例。

适用场景:Laravel 项目的数据模型设计、查询编写、性能调优与代码审查。

限制:资料未提供安装命令、版本要求、收费信息及具体平台支持细节。