Laravel5.7 Eloquent ORM快速入门详解_php实例_

简介

Laravel 内置的 Eloquent ORM 提供了一个美观、简单的与数据库打交道的 ActiveRecord 实现，每张数据表都对应一个与该表进行交互的模型（Model），通过模型类，你可以对数据表进行查询、插入、更新、删除等操作。

在开始之前，确保在 config/database.php 文件中配置好了数据库连接。更多关于数据库配置的信息，请查看文档。

定义模型

我们从创建一个 Eloquent 模型开始，模型类通常位于 app 目录下，你也可以将其放在其他可以被 composer.json 文件自动加载到的地方。所有 Eloquent 模型都继承自 Illuminate\Database\Eloquent\Model 类。

创建模型实例最简单的办法就是使用 Artisan 命令 make:model：

 php artisan make:model Flight

如果你想要在生成模型时生成数据库迁移，可以使用 --migration 或 -m 选项：

 php artisan make:model Flight --migration php artisan make:model Flight -m

Eloquent 模型约定

现在，让我们来看一个 Flight 模型的例子，我们将用该类获取和存取数据表 flights 中的信息：

表名

注意我们并没有告诉 Eloquent 我们的 Flight 模型使用哪张表，默认规则是小写的模型类名复数格式作为与其对应的表名（除非在模型类中明确指定了其它名称）。所以，在本例中，Eloquent 认为 Flight 模型存储记录在 flights 表中。你也可以在模型中定义 table 属性来指定自定义的表名：

主键

Eloquent 默认每张表的主键名为 id，你可以在模型类中定义一个 $primaryKey 属性来覆盖该约定。

此外，Eloquent 默认主键字段是自增的整型数据，这意味着主键将会被自动转化为 int 类型，如果你想要使用非自增或非数字类型主键，必须在对应模型中设置 $incrementing 属性为 false，如果主键不是整型，还要设置 $keyType 属性值为 string。

时间戳

默认情况下，Eloquent 期望 created_at 和 updated_at 已经存在于数据表中，如果你不想要这些 Laravel 自动管理的数据列，在模型类中设置 $timestamps 属性为 false：

如果你需要自定义时间戳格式，设置模型中的 $dateFormat 属性。该属性决定日期被如何存储到数据库中，以及模型被序列化为数组或 JSON 时日期的格式：

如果你需要自定义用于存储时间戳的字段名称，可以在模型中设置 CREATED_AT 和 UPDATED_AT 常量：

数据库连接

默认情况下，所有的 Eloquent 模型使用应用配置中的默认数据库连接，如果你想要为模型指定不同的连接，可以通过 $connection 属性来设置：

获取模型

创建完模型及其关联的数据表后，就可以从数据库中获取数据了。将 Eloquent 模型看作功能强大的查询构建器，你可以使用它来流畅的查询与其关联的数据表。例如：

name; } 

添加额外约束

Eloquent 的 all 方法返回模型表的所有结果，由于每一个 Eloquent 模型都是一个查询构建器，你还可以添加约束条件到查询，然后使用 get 方法获取对应结果：

 $flights = App\Flight::where('active', 1) ->orderBy('name', 'desc') ->take(10) ->get(); 

注：由于 Eloquent 模型本质上就是查询构建器，你可以在 Eloquent 查询中使用查询构建器的所有方法。

集合

对 Eloquent 中获取多个结果的方法（比如 all 和 get）而言，其返回值是 Illuminate\Database\Eloquent\Collection 的一个实例，Collection 类提供了多个有用的函数来处理 Eloquent 结果集：

 $flights = $flights->reject(function ($flight) { return $flight->cancelled; }); 

当然，你也可以像数组一样循环遍历该集合：

 foreach ($flights as $flight) { echo $flight->name; } 

组块结果集

如果你需要处理数据量很大的 Eloquent 结果集，可以使用 chunk 方法。chunk 方法会获取一个指定数量的 Eloquent 模型“组块”，并将其填充到给定闭包进行处理。使用 chunk 方法在处理大量数据集合时能够有效减少内存消耗：

 Flight::chunk(200, function ($flights) { foreach ($flights as $flight) { // } }); 

传递给该方法的第一个参数是你想要获取的“组块”数目，闭包作为第二个参数被传入用于处理每个从数据库获取的组块数据。

使用游标

cursor 方法允许你使用游标迭代处理数据库记录，一次只执行单个查询，在处理大批量数据时，cursor 方法可大幅减少内存消耗：

 foreach (Flight::where('foo', 'bar')->cursor() as $flight) { // } 

获取单个模型/聚合结果

当然，除了从给定表中获取所有记录之外，还可以使用 find 和 first 获取单个记录。这些方法返回单个模型实例而不是模型集合：

 // 通过主键获取模型... $flight = App\Flight::find(1); // 获取匹配查询条件的第一个模型... $flight = App\Flight::where('active', 1)->first(); 

还可以通过传递主键数组来调用 find 方法，这将会返回匹配记录集合：

 $flights = App\Flight::find([1, 2, 3]); 

Not Found 异常

有时候你可能想要在模型找不到的时候抛出异常，这在路由或控制器中非常有用，findOrFail 和 firstOrFail 方法会获取查询到的第一个结果。不过，如果没有任何查询结果，Illuminate\Database\Eloquent\ModelNotFoundException 异常将会被抛出：

 $model = App\Flight::findOrFail(1); $model = App\Flight::where('legs', '>', 100)->firstOrFail(); 

如果异常没有被捕获，那么 HTTP 404 响应将会被发送给用户，所以在使用这些方法的时候没有必要对返回 404 响应编写额外的检查：

 Route::get('/api/flights/{id}', function ($id) { return App\Flight::findOrFail($id); }); 

获取聚合结果

当然，你还可以使用查询构建器提供的聚合方法，例如 count、sum、max，以及其它查询构建器提供的聚合函数。这些方法返回计算后的结果而不是整个模型实例：

 $count = App\Flight::where('active', 1)->count(); $max = App\Flight::where('active', 1)->max('price'); 

插入/更新模型

插入

想要在数据库中插入新的记录，只需创建一个新的模型实例，设置模型的属性，然后调用 save 方法：

name = $request->name; $flight->save(); } } 

在这个例子中，我们只是简单分配 HTTP 请求中的 name 参数值给 App\Flight 模型实例的 name 属性，当我们调用 save 方法时，一条记录将会被插入数据库。created_at 和 updated_at 时间戳在 save 方法被调用时会自动被设置，所以没必要手动设置它们。

更新

save 方法还可以用于更新数据库中已存在的模型。要更新一个模型，应该先获取它，设置你想要更新的属性，然后调用 save 方法。同样，updated_at 时间戳会被自动更新，所以没必要手动设置其值：

 $flight = App\Flight::find(1); $flight->name = 'New Flight Name'; $flight->save();

批量更新

更新操作还可以同时修改给定查询提供的多个模型实例，在本例中，所有有效且 destination=San Diego 的航班都被标记为延迟：

 App\Flight::where('active', 1) ->where('destination', 'San Diego') ->update(['delayed' => 1]);

update 方法要求以数组形式传递键值对参数，代表着数据表中应该被更新的列。

注：通过 Eloquent 进行批量更新时，saved 和 updated 模型事件将不会在更新模型时触发。这是因为在进行批量更新时并没有从数据库获取模型。

批量赋值

还可以使用 create 方法保存一个新的模型。该方法返回被插入的模型实例。但是，在此之前，你需要指定模型的 fillable 或 guarded 属性，因为所有 Eloquent 模型都通过批量赋值（Mass Assignment）进行保护，这两个属性分别用于定义哪些模型字段允许批量赋值以及哪些模型字段是受保护的，不能显式进行批量赋值。

当用户通过 HTTP 请求传递一个不被期望的参数值时就会出现安全隐患，然后该参数以不被期望的方式修改数据库中的字段值。例如，恶意用户通过 HTTP 请求发送一个 is_admin 参数，然后该参数映射到模型的 create 方法，从而允许用户将自己变成管理员。

所以，你应该在模型中定义哪些属性是可以进行赋值的，使用模型上的 $fillable 属性即可实现。例如，我们设置 Flight 模型上的 name 属性可以被赋值：

设置完可以被赋值的属性之后，我们就可以使用 create 方法在数据库中插入一条新的记录。create 方法返回保存后的模型实例：

 $flight = App\Flight::create(['name' => 'Flight 10']);

如果你已经有了一个模型实例，可以使用 fill 方法通过数组属性来填充：

 $flight->fill(['name' => 'Flight 22']);

黑名单属性

$fillable 就像是可以被赋值属性的“白名单”，还可以选择使用 $guarded。$guarded 属性包含你不想被赋值的属性数组。所以不被包含在其中的属性都是可以被赋值的，因此，$guarded 功能就像“黑名单”。当然，这两个属性你只能同时使用其中一个而不能一起使用，因为它们是互斥的。下面的例子中，除了 price 之外的所有属性都是可以赋值的：

如果你想要让所有属性都是可批量赋值的，可以将 $guarded 属性设置为空数组：

 /** * The attributes that aren't mass assignable. * * @var array */ protected $guarded = []; 

其它创建方法

firstOrCreate/firstOrNew

还有其它两种可以用来创建模型的方法：firstOrCreate 和 firstOrNew。firstOrCreate 方

提示： 本文由神整理自网络，如有侵权请联系本站删除！
本站声明：
1、本站所有资源均来源于互联网，不保证100%完整、不提供任何技术支持；
2、本站所发布的文章以及附件仅限用于学习和研究目的;不得将用于商业或者非法用途；否则由此产生的法律后果，本站概不负责！