定义Eloquent模型

模型通常放在app/models目录中，但是您可以自由地把它们放在任何地方，只要它能根据您的composer.json文件自动加载。除非显示地指定表名，Eloquent默认情况下将模型类名的小写，复数形式作为表名。如我们定义的模型为Game,那么它将操作games数据表。

  1. <?php
  2. // app/models/Game.php
  3. classGameextendsEloquent
  4. {
  5. //
  6. }

然后就可以使用该模型

  1. Route::get('/',function()
  2. {
  3. $game =newGame;
  4. $game->name ='Assassins Creed';
  5. $game->description ='Assassins VS templars.';
  6. $game->save();
  7. });

这是会提示错误，因为模型默认每个表创建时都有$table->timestamps();,所以你需要为表添加这两个字段或是在模型中关闭

  1. public $timestamps =false;

你可以为模型指定数据表

  1. public $table ='gamezilla_roar';

Eloquent 将假设每张表有一个名为 id 的主键。您可以定义 primaryKey 属性来覆盖这个约定。同样，您可以定义一个 connection 属性来覆盖在使用这个模型时所用的数据库连接。

读取模型数据

获取所有所有记录

  1. $games =Game::all();

根据主键获取一条记录

  1. $games =Game::fine(1);

[查询构建器] 中适用的函数在 Eloquent 模型的查询中同样适用。具体参考官方API手册

根据主键获取一条记录或者抛出一个异常

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

注册错误处理器，请监听 ModelNotFoundException

  1. useIlluminateDatabaseEloquentModelNotFoundException;
  3. App::error(function(ModelNotFoundException $e)
  4. {
  5. returnResponse::make('Not Found',404);
  6. });

指定查询的数据库连接

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

插入

  1. $user =newUser;
  2. $user->name ='John';
  3. $user->save();

通常您的 Eloquent 模型将有自动递增的键。然而，如果您希望指定您自定义的键，在模型中设置 incrementing 属性为 false。

您也可以使用 create 函数在一行代码中保存一个新的模型。被插入的模型实例将从函数中返回。但是，在您这样做之前，您需要在模型中指定 fillable 或者 guarded 属性，因为所有 Eloquent 模型默认阻止集体赋值。

  1. $user =User::create(array('name'=>'John'));

更新

  1. $user =User::find(1);
  2. $user->email ='john@foo.com';
  3. $user->save();

有时您可能希望不仅保存模型，还有它的所有关系。为此，您可以使用 push 函数：

  1. $user->push();

在一组模型上运行更新：

  1. $affectedRows =User::where('votes','>',100)->update(array('status'=>2));

删除

  1. $user =User::find(1);
  2. $user->delete();

根据主键删除一个模型

  1. User::destroy(1);
  2. User::destroy(1,2,3);

一组模型中运行删除查询

  1. $affectedRows =User::where('votes','>',100)->delete();

如果您希望简单的在一个模型中更新时间戳，可以使用 touch 函数

  1. $user->touch();

软删除

并没有真的从数据库中删除。相反，一个 deleted_at 时间戳在记录中被设置。为一个模型开启软删除，在模型中指定 softDelete 属性

  1. classUserextendsEloquent{
  2. protected $softDelete =true;
  3. }

在您的表中添加一个 deleted_at 字段，您可以在迁移中使用 softDeletes 函数：

  1. $table->softDeletes();

当您在一个模型中调用 delete 函数，deleted_at字段将被设置为当前的时间戳。在使用软删除的模型中查询，被软删除的模型将不被包含进查询结果中。为了强制已删除的模型出现在结果集中，在查询中使用 withTrashed 函数：

  1. $users =User::withTrashed()->where('account_id',1)->get();

希望在结果集中只包含软删除的模型，您可以使用 onlyTrashed 函数

  1. $users =User::onlyTrashed()->where('account_id',1)->get();

恢复一个已被软删除的记录，使用 restore 函数：

  1. $user->restore();

在查询中使用 restore 函数：

  1. User::withTrashed()->where('account_id',1)->restore();

restore 函数也可以在关系中被使用：

  1. $user->posts()->restore();

从数据库中真正删除一个模型，您可以使用 forceDelete 函数：

  1. $user->forceDelete();

检测一个给定的模型实例是否被软删除，可以使用 trashed 函数：

  1. if($user->trashed())
  2. {
  3. //
  4. }

查询范围

范围允许您容易在模型中重用查询逻辑。定义一个范围，简单的用 scope 为模型添加前缀

  1. classUserextendsEloquent{
  2. publicfunction scopePopular($query)
  3. {
  4. return $query->where('votes','>',100);
  5. }
  6. }

使用一个查询范围

  1. $users =User::popular()->orderBy('created_at')->get();

使用参数

  1. classUserextendsEloquent{
  2. publicfunction scopeOfType($query, $type)
  3. {
  4. return $query->whereType($type);
  5. }
  6. }

然后在范围函数调用中传递参数：

  1. $users =User::ofType('member')->get();

结束