Laravel中正确使用Eloquent需：一、创建模型并配置$table、$primaryKey、$fillable；二、用all()、find()、first()、findOrFail()、get()执行查询；三、通过new+save、create或forceCreate插入数据；四、用实例save、update或where+update更新；五、用delete、destroy或where+delete删除。
如果您在 Laravel 项目中需要与数据库交互，但尚未正确配置或调用 Eloquent 模型，则可能导致查询失败、数据无法写入或关联加载异常。以下是使用 Eloquent 模型的具体方法：
一、创建并配置模型类
模型是 Eloquent 操作数据库的入口，必须继承 Illuminate\Database\Eloquent\Model，且需遵循命名与表名约定或显式声明映射关系。未正确声明 $table、$fillable 或主键可能导致批量赋值拒绝、查询定位错误或时间戳异常。
1、在终端执行 Artisan 命令生成模型文件：php artisan make:model User。
2、打开生成的 app/Models/User.php，确认类继承自 Model，并根据实际表结构调整属性：
3、若数据库表名为 my_users（非默认复数形式），需显式设置：protected $table = 'my_users';。
4、若主键字段为 user_id 而非 id，添加：protected $primaryKey = 'user_id';。
5、若需允许批量赋值（如 create() 方法），定义可填充字段：protected $fillable = ['name', 'email', 'password'];。
二、执行基础查询操作
Eloquent 提供多种静态方法获取数据，不同方法返回类型与异常处理机制不同，误用可能导致空对象访问或静默失败。
1、获取全部记录：User::all()，返回 Illuminate\Database\Eloquent\Collection 实例。
2、按主键查找单条记录：User::find(1)，查无结果时返回 null。
3、按条件查找首条匹配记录：User::where('email', 'test@example.com')->first()。
4、查无结果时抛出 404 异常：User::findOrFail(1)，适用于路由模型绑定场景。
5、按条件获取多条记录：User::where('active', 1)->get()，返回集合，支持链式调用如 orderBy、limit。
三、插入新数据
插入方式分为实例化后保存与批量创建两类，区别在于是否触发模型事件（如 creating、created）及是否校验 $fillable 配置。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
1、实例化后逐字段赋值并保存：$user = new User; $user->name = 'Tom'; $user->email = 'tom@example.com'; $user->save();。
2、使用 create() 批量赋值：User::create(['name' => 'Jerry', 'email' => 'jerry@example.com']);，要求字段已在 $fillable 中声明。
3、若需跳过 $fillable 检查而强制插入，改用 forceCreate()：User::forceCreate(['name' => 'Admin', 'email' => 'admin@local']);。
四、更新已有记录
更新操作存在实例更新与静态批量更新两种路径，前者触发模型事件和访问器/修改器，后者绕过模型生命周期且不验证字段合法性。
1、先查后改再保存：$user = User::find(1); $user->name = 'Updated Name'; $user->save();。
2、使用 update() 静态方法批量更新：User::where('id', 1)->update(['name' => 'New Name']);。
3、对已加载模型实例调用 update()：$user->update(['email' => 'new@example.com']);，此方式仍触发事件。
4、若需更新多个字段且避免 N+1 查询，推荐结合 where + update，而非遍历模型集合逐个 save。
五、删除数据记录
删除行为分软删除与硬删除，Eloquent 默认执行硬删除；启用软删除需引入 SoftDeletes trait 并迁移添加 deleted_at 字段。
1、通过模型实例删除：$user = User::find(1); $user->delete();。
2、使用 destroy() 静态方法按主键删除：User::destroy(1);，支持传入多个 ID：User::destroy([1, 2, 3]);。
3、按条件批量删除：User::where('created_at', 'subDays(30))->delete();。
4、启用软删除后，上述 delete() 和 destroy() 不真正移除数据，仅设置 deleted_at 时间戳；查询时自动排除已软删除记录，除非显式调用 withTrashed() 或 onlyTrashed()。
