用途:面向 Laravel 项目的 Eloquent 模型与数据库层编码规范,适用于处理模型、数据库实体、Eloquent ORM 等场景。
主要能力:模型基本结构(casts、关系、自定义查询构建器);类型转换(integer、boolean、array、datetime、encrypted、枚举、DTO 等);关系(BelongsTo、HasMany、HasOne、BelongsToMany、HasManyThrough、MorphTo/MorphMany);访问器与修改器(Attribute::make 的 get/set);简单辅助方法;模型观察者处理生命周期钩子;模型 Concern(Trait)复用;路由模型绑定(隐式绑定、自定义键 {order:uuid}、resolveRouteBinding);软删除;集合操作;模型测试示例。
使用方式:在 AppServiceProvider::boot() 中调用 Model::unguard(),模型不使用 $fillable/$guarded;用 casts() 方法定义类型转换;用 newEloquentBuilder() 返回自定义查询构建器而非本地 scope;观察者在 AppServiceProvider 中通过 Order::observe(OrderObserver::class) 注册;输入需先在 Form Request 中验证。
适用场景:Laravel 应用的模型层设计与重构,统一团队对模型职责的约定。
限制:资料主张模型不包含业务逻辑(应放入 Actions)、不使用本地 scope 与 $fillable/$guarded,这属于该指南的约定而非框架强制;具体安装命令、版本要求与收费信息暂未提供。