基本用法

我们先从建立一个 Eloquent 模型开始。模型通常放在 app 目录下，但是您可以将它们放在任何地方，只要能通过 composer.json 自动载入。所有的 Eloquent 模型都继承于 IlluminateDatabaseEloquentModel 。

定义一个 Eloquent 模型

class User extends Model {}

你也可以通过 make:model 命令自动生成 Eloquent 模型：

php artisan make:model User

注意：我们并没有告诉 Eloquent User 模型会使用哪个数据库表。若没有特别指定，系统会默认自动对应名称为「类名称的小写复数形态」的数据库表。所以，在上面的例子中， Eloquent 会假设 User 模型将把数据存在 users 数据库表。您也可以在类中定义 table 属性自定义要对应的数据库表。

class User extends Model {
    protected $table = "my_users";
}

注意： Eloquent 也会假设每个数据库表都有一个字段名称为 id 的主键。您可以在类里定义 primaryKey 属性来重写。同样的，您也可以定义 connection 属性，指定模型连接到指定的数据库连接。

定义好模型之后，您就可以从数据库表新增及获取数据了。注意在默认情况下，在数据库表里需要有 updated_at 和 created_at 两个字段。如果您不想设定或自动更新这两个字段，则将类里的 $timestamps 属性设为 false即可。

取出所有模型数据

$users = User::all();

根据主键取出一条数据

$user = User::find(1);
var_dump($user->name);

提示： 所有查询构造器里的方法，查询 Eloquent 模型时也可以使用。

根据主键取出一条数据或抛出异常

有时, 您可能想要在找不到模型数据时抛出异常，通过 firstOrFail 方法。

$model = User::findOrFail(1);
$model = User::where("votes", ">", 100)->firstOrFail();

Doing this will let you catch the exception so you can log and display an error page as necessary. To catch the ModelNotFoundException, add some logic to your app/Exceptions/Handler.php file.

use IlluminateDatabaseEloquentModelNotFoundException;

class Handler extends ExceptionHandler {

    public function render($request, Exception $e)
    {
        if ($e instanceof ModelNotFoundException)
        {
            // Custom logic for model not found...
        }

        return parent::render($request, $e);
    }

}

Eloquent 模型结合查询语法

$users = User::where("votes", ">", 100)->take(10)->get();

foreach ($users as $user)
{
    var_dump($user->name);
}

Eloquent 聚合查询

当然，您也可以使用查询构造器的聚合查询方法。

$count = User::where("votes", ">", 100)->count();

如果没办法使用流畅接口产生出查询语句，也可以使用 whereRaw 方法：

$users = User::whereRaw("age > ? and votes = 100", [25])->get();

拆分查询

如果您要处理非常多（数千条）Eloquent 查询结果，使用 chunk 方法可以让您顺利工作而不会消耗大量内存：

User::chunk(200, function($users)
{
    foreach ($users as $user)
    {
        //
    }
});

传到方法里的第一个参数表示每次「拆分」要取出的数据数量。第二个参数的闭合函数会在每次取出数据时被调用。

指定查询时连接数据库

您也可以指定在执行 Eloquent 查询时要使用哪个数据库连接。只要使用 on 方法：

$user = User::on("connection-name")->find(1);

如果您在使用 读取 / 写入连接, 您可以通过如下命令来强制查询使用 写入 连接：

$user = User::onWriteConnection()->find(1);