[转]Laravel 4之Eloquent ORM

Laravel 4之Eloquent ORM

http://dingjiannan.com/2013/laravel-eloquent/

定义Eloquent模型

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

<?php
// app/models/Game.php
classGameextendsEloquent
{
//
}

然后就可以使用该模型

Route::get('/',function()
{
$game =newGame;
$game->name ='Assassins Creed';
$game->description ='Assassins VS templars.';
$game->save();
});

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

public $timestamps =false;

你可以为模型指定数据表

public $table ='gamezilla_roar';

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

读取模型数据

获取所有所有记录

$games =Game::all();

根据主键获取一条记录

$games =Game::fine(1);

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

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

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

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

useIlluminate\Database\Eloquent\ModelNotFoundException;
App::error(function(ModelNotFoundException $e)
{
returnResponse::make('Not Found',404);
});

指定查询的数据库连接

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

插入

$user =newUser;
$user->name ='John';
$user->save();

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

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

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

更新

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

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

$user->push();

在一组模型上运行更新：

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

删除

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

根据主键删除一个模型

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

一组模型中运行删除查询

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

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

$user->touch();

软删除

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

classUserextendsEloquent{
protected $softDelete =true;
}

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

$table->softDeletes();

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

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

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

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

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

$user->restore();

在查询中使用 restore 函数：

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

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

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

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

$user->forceDelete();

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

if($user->trashed())
{
//
}

查询范围

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

classUserextendsEloquent{
publicfunction scopePopular($query)
{
return $query->where('votes','>',100);
}
}

使用一个查询范围

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

使用参数

classUserextendsEloquent{
publicfunction scopeOfType($query, $type)
{
return $query->whereType($type);
}
}

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

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

结束

点击查看评论