eloquent 是 laravel 自带的 orm 工具，通过模型类封装数据库操作，支持查询、增删改、关联关系及软删除等特性。
Eloquent 是 Laravel 框架自带的 ORM（对象关系映射）工具，它让数据库操作变得像操作 php 对象一样直观、简洁。无需手写 sql，也能完成查询、插入、更新、删除、关联等常见操作。
模型定义与基础配置
每个数据表对应一个 Eloquent 模型类，通常放在 app/Models 目录下。模型默认约定：类名用 PascalCase（如 User），对应表名是小写加下划线复数形式（users）。
- 继承
IlluminatedatabaseEloquentModel - 可显式指定表名：
protected $table = 'user_profiles'; - 主键默认为
id，如非标准可设置：protected $primaryKey = 'uid'; - 若主键不是自增整型，需声明：
public $incrementing = false;和protected $keyType = 'String'; - 时间戳字段默认为
created_at和updated_at，禁用则设：public $timestamps = false;
常用数据操作方法
所有操作都基于模型类调用静态方法，返回结果通常是模型实例或集合（IlluminateDatabaseEloquentCollection）。
- 查询：
User::find(1)（按主键查单条）、User::where('status', 1)->get()（条件查多条）、User::firstWhere('email', 'a@b.com')（查一条） - 新增：
User::create(['name' => 'Tom', 'email' => 't@b.com'])（需在模型中设置$fillable白名单） - 更新：
User::where('id', 2)->update(['name' => 'Jerry'])（批量更新），或先查后改：$user = User::find(2); $user->name = 'Jerry'; $user->save(); - 删除：
User::destroy(3)（按主键删）、User::where('status', 0)->delete()（条件删除）
模型关联关系定义
通过在模型中定义方法，描述表之间的关系，Eloquent 自动处理 JOIN 或额外查询。
立即学习“PHP免费学习笔记（深入）”；
- 一对多（如用户有多篇文章）：
在User模型中写：public function posts() { return $this->hasMany(Post::class); }
调用：$user->posts（获取集合），$user->posts()->where('published', 1)->get()（带条件） - 一对一（如用户有唯一档案）：
public function profile() { return $this->hasOne(UserProfile::class); } - 多对多（如角色与权限）：
public function permissions() { return $this->belongsToMany(Permission::class); }，默认中间表名为permission_role（按字母顺序） - 关联预加载避免 N+1 查询：
User::with('posts', 'profile')->get()
实用技巧与注意事项
写得顺手之后，几个关键点能帮你少踩坑：
- 批量赋值安全：务必设置
$fillable（白名单）或$guarded（黑名单），否则create()/fill()可能被恶意参数注入 - 软删除：使用
use SoftDeletes;trait 后，delete()不真正删记录，只设deleted_at；查时自动排除，恢复用restore()，查已删数据用withTrashed() - 访问器与修改器：在模型中定义
getFullNameAttribute()可添加虚拟属性$user->full_name；setPasswordAttribute($value)可自动哈希密码 - 查询作用域（Scopes）：把常用查询逻辑封装成方法，如
scopeActive($query)，调用时用User::active()->get()