一.定义模型 1.命令 php artisan make:model User 如果你想要在生成模型时生成数据库迁移,可以使用--migration 或-m 选项: php artisan make:model User --migration或-m 2.Eloquent使用的表名 默认规则是模型类名的复数作为与其对应的表名,除非在模型类中明确指定了其它名称 在model中定义 $table = 'my_flights'; 3.主键 Eloquent 默认每张表的主键名为id ,你可以在模型类中定义一个$primaryKey 属性来覆盖该约定 4.时间戳 默认情况下,Eloquent 期望created_at 和updated_at 已经存在于数据表中,如果你不想要这些 Laravel自动管理的列,在模型类中设置$timestamps 属性为false 如果你需要自定义时间戳格式,设置模型中的$dateFormat 属性,该属性决定日期被如何存储到数据库中,以及模型被序列化为数组或 JSON 时日期的格式 二.常用方法 1.获取所有记录 $flights = Flight::all(); 2.访问列值 $flight->name; 3.每一个 Eloquent 模型都是一个查询构建器,所以适用于数据库操作中查询的所有方法 如 $flights = AppFlight::where('active', 1) ->orderBy('name', 'desc') ->take(10) ->get(); 三.集合 组块结果集 如果你需要处理成千上万个 Eloquent 结果,可以使用chunk 命令。chunk 方法会获取一个“组块”的 Eloquent 模型,并将其填充到给定闭包进行处理。使用chunk 方法能够在处理大量数据集合时有效减少内存消耗: Flight::chunk(200, function ($flights) { foreach ($flights as $flight) { // } }); 四.单条记录/聚合结果 1.单条记录 // 通过主键获取模型... $flight = AppFlight::find(1); // 获取匹配查询条件的第一个模型... $flight = AppFlight::where('active', 1)->first(); firstOrFail/firstOrFail //如果记录没找到,返回404错误 2.聚合结果 $count = AppFlight::where('active', 1)->count(); $max = AppFlight::where('active', 1)->max('price'); 五.插入/更新记录 1.基本插入 $flight = new Flight; $flight->name = $request->name; $flight->save(); 2.基本更新 $flight = AppFlight::find(1); $flight->name = 'New Flight Name'; $flight->save(); 3.批量赋值 批量赋值,需要在模型中指定$fillable或guarded属性,前者表示那些字段能被赋值,后者表示那些字段不能被赋值 class Flight extends Model{ /** * 不能被批量赋值的属性 * * @var array */ protected $guarded = ['price']; } 使用create 方法在数据库中插入一条新的记录,create 方法返回保存后的模型实例 $flight = AppFlight::create(['name' => 'Flight 10']); 4.firstOrCreate/firstOrNew firstOrCreate 方法先尝试通过给定列/值对在数据库中查找记录,如果没有找到的话则通过给定属性创建一个新的记录 firstOrNew 方法和firstOrCreate 方法一样先尝试在数据库中查找匹配的记录,如果没有找到,则返回一个的模型实例。注意通过firstOrNew 方法返回的模型实例并没有持久化到数据库中,你还需要调用save 方法手动持久化 // 通过属性获取航班, 如果不存在则创建... $flight = AppFlight::firstOrCreate(['name' => 'Flight 10']); // 通过属性获取航班, 如果不存在初始化一个新的实例... $flight = AppFlight::firstOrNew(['name' => 'Flight 10']); 六.删除模型 1.通过主键删除 AppFlight::destroy(1); AppFlight::destroy([1, 2, 3]); AppFlight::destroy(1, 2, 3); 2.where删除 $deletedRows = AppFlight::where('active', 0)->delete(); 3.软删除 如删除是,如果数据表有deleted_at字段,如果该字段为非空,那么该模型就表示已经被软删除了. 在模型中启用软删除 class Flight extends Model{ use SoftDeletes; } 这样在调用delete时,将会启用软删除 4.判断模型是否被软删除 if ($flight->trashed()){....} 5.软删除的记录,在使用模型查询时将会自动从查询结果中排除掉,如果要包含软删除的记录 $flights = AppFlight::withTrashed()->where('account_id', 1)->get(); $flight->history()->withTrashed()->get() 6.只获取软删除的记录 $flights = AppFlight::onlyTrashed()->where('airline_id', 1)->get(); 7.恢复软删除记录 $flight->restore(); AppFlight::withTrashed()->where('airline_id', 1)->restore(); $flight->history()->restore(); 8.彻底从数据库中删除 // 强制删除单个模型实例... $flight->forceDelete(); // 强制删除所有关联模型... $flight->history()->forceDelete(); 七.查询作用域 1.基本 public function scopePopular($query) { return $query->where('votes', '>', 100); } 调用 $users = AppUser::popular()->orderBy('created_at')->get(); 2.动态作用域 public function scopeOfType($query, $type) { return $query->where('type', $type); } $users = AppUser::ofType('admin')->get(); 八.事件 Eloquent 模型可以触发事件,允许你在模型生命周期中的多个时间点调用如下这些方法:
creating , created ,updating , updated , saving , saved , deleting , deleted , restoring , restored 。
事件允许你在一个指定模型类每次保存或更新的时候执行代码。 一个新模型被首次保存的时候, creating 和created 事件会被触发。
如果一个模型已经在数据库中存在并调用save/方法, updating/updated 事件会被触发。
举个例子,我们在服务提供者中定义一个 Eloquent 事件监听器,在事件监听器中,我们会调用给定模型的isValid 方法,如果模型无效会返回false 。如果从 Eloquent 事件监听器中返回false 则取消save/update 操作: <?php namespace AppProviders; use AppUser; use IlluminateSupportServiceProvider; class AppServiceProvider extends ServiceProvider{ /** * 启动所有应用服务 * * @return void */ public function boot() { User::creating(function ($user) { if ( ! $user->isValid()) { return false; } }); } /** * 注册服务提供者. * * @return void */ public function register() { // } }