Eloquent ['eləkwənt] 时，数据库查询构造器的方法对模型类也是也用的，使用上只是省略了DB::table(‘表名’)部分。
在模型中使用protected成员变量$table指定绑定的表名。
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;class Flight extends Model{ /**
* The table associated with the model.
*
* @var string
*/
protected $table = 'my_flights';
}Eloquent 假设每个表都有一个名为id的主键，可以通过$primaryKey成员变量覆盖该字段名称，另外，Eloquent假设主键字段是自增的整数，如果你想用非自增的主键或者非数字的主键的话，必须指定模型中的public属性$incrementing为false。
默认情况下，Eloquent期望表中存在created_at和updated_at两个字段，字段类型为timestamp，如果不希望这两个字段的话，设置$timestamps为false
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;class Flight extends Model{ /**
* Indicates if the model should be timestamped.
*
* @var bool
*/
public $timestamps = false; /**
* The storage format of the model's date columns.
*
* @var string
*/
protected $dateFormat = 'U';
}使用protected $connection = ‘connection-name’指定模型采用的数据库连接。
基本查询操作#
方法all用于返回模型表中所有的结果
$flights = Flight::all();foreach ($flights as $flight) { echo $flight->name;
}也可以使用get方法为查询结果添加约束
$flights = App\Flight::where('active', 1)
->orderBy('name', 'desc')
->take(10)
->get();可以看到，查询构造器的方法对模型类也是可以使用的
在eloquent ORM中，get和all方法查询出多个结果集，它们的返回值是一个Illuminate\Database\Eloquent\Collection对象，该对象提供了多种对结果集操作的方法
public function find($key, $default = null); public function contains($key, $value = null); public function modelKeys(); public function diff($items)...
该对象的方法有很多，这里只列出一小部分，更多方法参考API文档 Collection 和使用说明文档。对大量结果分段处理，同样是使用chunk方法
Flight::chunk(200, function ($flights) {
foreach ($flights as $flight) { //
}
});使用find和first方法查询单个结果，返回的是单个的模型实例
// 通过主键查询模型...$flight = App\Flight::find(1); // 使用约束...$flight = App\Flight::where('active', 1)->first();
使用find方法也可以返回多个结果，以Collection对象的形式返回，参数为多个主键
$flights = App\Flight::find([1, 2, 3]);
如果查询不到结果的话，可以使用findOrFail或者firstOrFail方法，这两个方法在查询不到结果的时候会抛出Illuminate\Database\Eloquent\ModelNotFound<a href="//m.sbmmt.com/wiki/265.html" target="_blank">Exception</a>异常
$model = App\Flight::findOrFail(1);$model = App\Flight::where('legs', '>', 100)->firstOrFail();
如果没有捕获这个异常的话，laravel会自动返回给用户一个404的响应结果，因此如果希望找不到的时候返回404，是可以直接使用该方法返回的
Route::get('/api/flights/{id}', function ($id) {
return App\Flight::findOrFail($id);
});与查询构造器查询方法一样，可以使用聚集函数返回结果，常见的比如max， min，avg，sum，count等
$count = App\Flight::where('active', 1)->count();$max = App\Flight::where('active', 1)->max('price');
分页查询可以直接使用paginate函数
LengthAwarePaginator paginate(
int $perPage = null,
array $columns = array('*'),
string $pageName = 'page',
int|null $page = null)参数说明
参数 类型 说明
perPage int 每页显示数量
columns array 查询的列名
pageName string 页码参数名称
page int 当前页码
返回值为 LengthAwarePaginator 对象。
$limit = 20;$page = 1;return Enterprise::paginate($limit, ['*'], 'page', $page);
基本插入操作#
插入新的数据只需要创建一个新的模型实例，然后设置模型属性，最后调用save方法即可
$flight = new Flight;$flight->name = $request->name;$flight->save();
在调用save方法的时候，会自动为created_at和updated_at字段设置时间戳，不需要手动指定
批量赋值插入#
使用create方法可以执行批量为模型的属性赋值的插入操作，该方法将会返回新插入的模型，在执行create方法之前，需要先在模型中指定fillable和guarded属性，用于防止不合法的属性赋值（例如避免用户传入的is_admin属性被误录入数据表）。
指定$fillable属性的目的是该属性指定的字段可以通过create方法插入，其它的字段将被过滤掉，类似于白名单，而$guarded则相反，类似于黑名单。
protected $fillable = ['name'];// ORprotected $guarded = ['price'];
执行create操作就只有白名单或者黑名单之外的字段可以更新了
$flight = App\Flight::create(['name' => 'Flight 10']);
除了create方法，还有两外两个方法可以使用firstOrNew和firstOrCreate。
firstOrCreate方法用来使用给定的列值对查询记录，如果查不到则插入新的。fristOrNew与firstOrCreate类似，不同在于如果不存在，它会返回一个新的模型对象，不过该模型是未经过持久化的，需要手动调用save方法持久化到数据库。
// 使用属性检索flight，如果不存在则创建...$flight = App\Flight::firstOrCreate(['name' => 'Flight 10']); // 使用属性检索flight，如果不存在则创建一个模型实例...$flight = App\Flight::firstOrNew(['name' => 'Flight 10']);
基本更新操作#
方法save不仅可以要用来插入新的数据，也可以用来更新数据，只需先使用模型方法查询出要更新的数据，设置模型属性为新的值，然后再save就可以更新了，updated_at字段会自动更新。
$flight = App\Flight::find(1);$flight->name = 'New Flight Name';$flight->save();
也可使用update方法对多个结果进行更新
App\Flight::where('active', 1)
->where('destination', 'San Diego')
->update(['delayed' => 1]);基本删除操作#
使用delete方法删除模型
$flight = App\Flight::find(1);$flight->delete();
上述方法需要先查询出模型对象，然后再删除，也可以直接使用主键删除模型而不查询，使用destroy方法
App\Flight::destroy(1);App\Flight::destroy([1, 2, 3]);App\Flight::destroy(1, 2, 3);
使用约束条件删除，返回删除的行数
$deletedRows = App\Flight::where('active', 0)->delete();
软删除是在表中增加deleted_at字段，当删除记录的时候不会真实删除记录，而是设置该字段的时间戳，由Eloquent模型屏蔽已经设置该字段的数据。
要启用软删除，可以在模型中引用Illuminate\Database\Eloquent\SoftDeletes这个Trait，并且在dates属性中增加deleted_at字段。
<?phpnamespace App;use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;class Flight extends Model{
use SoftDeletes; /**
* The attributes that should be mutated to dates.
*
* @var array
*/
protected $dates = ['deleted_at'];
}要判断一个模型是否被软删除了的话，可以使用trashed方法
if ($flight->trashed()) { //}查询软删除的模型#
包含软删除的模型#
如果模型被软删除了，普通查询是不会查询到该结果的，可以使用withTrashed方法强制返回软删除的结果
$flights = App\Flight::withTrashed()
->where('account_id', 1)
->get();// 关联操作中也可以使用
$flight->history()->withTrashed()->get();只查询软删除的模型#
$flights = App\Flight::onlyTrashed()
->where('airline_id', 1)
->get();还原软删除的模型#
查询到软删除的模型实例之后，调用restore方法还原
$flight->restore();
也可以在查询中使用
App\Flight::withTrashed()
->where('airline_id', 1)
->restore();// 关联操作中也可以使用
$flight->history()->restore();强制删除（持久化删除）#
// Force deleting a single model instance...$flight->forceDelete(); // Force deleting all related models...$flight->history()->forceDelete();
上述操作后，数据会被真实删除。
Atas ialah kandungan terperinci Laravel框架-EloquentORM基础部分详解. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!
![[Web front-end] Permulaan pantas Node.js](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
