零、什么是 Eloquent
Eloquent 是 Laravel 的 'ORM'，即 'Object Relational Mapping'，對(duì)象關(guān)系映射。ORM 的出現(xiàn)是為了幫我們把對(duì)數(shù)據(jù)庫的操作變得更加地方便。

Eloquent 讓一個(gè) 'Model類' 對(duì)應(yīng)一張數(shù)據(jù)庫表，并且在底層封裝了很多 'function'，可以讓 Model 類非常方便地調(diào)用。
來看一段如下代碼：

<?phpclass Article extends /Eloquent {protected $fillable = [];}

'protected $fillable = [];' 這一行代碼在這里沒有任何價(jià)值，是 generator 自動(dòng)生成的，在此我們不做討論。

這個(gè)類簡(jiǎn)直再簡(jiǎn)單不過了，沒有指定命名空間，沒有構(gòu)造函數(shù)，如果那一行沒有意義的代碼也不算上的話，這個(gè)文件就只有兩個(gè)有實(shí)際意義的東西： 'Article' 和 '/Eloquent'。沒錯(cuò)，Eloquent 就是這么屌炸天，只需要繼承一下 Eloquent 類，就可以干 'first() find() where() orderBy()' 等非常非常多的事情，這就是面向?qū)ο蟮膹?qiáng)大威力。

一、Eloquent 基本用法
Eloquent 中文文檔在：http://laravel-china.org/docs/eloquent

廢話不多說，下面我將直接展示 Eloquent 的幾種常見用法的代碼。

找到 id 為 2 的文章打印其標(biāo)題

$article = Article::find(2);echo $article->title;

查找標(biāo)題為“我是標(biāo)題”的文章，并打印 id

$article = Article::where('title', '我是標(biāo)題')->first();echo $article->id;

查詢出所有文章并循環(huán)打印出所有標(biāo)題

$articles = Article::all(); // 此處得到的 $articles 是一個(gè)對(duì)象集合，可以在后面加上 '->toArray()' 變成多維數(shù)組。foreach ($articles as $article) {  echo $article->title;}

查找 id 在 10~20 之間的所有文章并打印所有標(biāo)題

$articles = Article::where('id', '>', 10)->where('id', '<', 20)->get();foreach ($articles as $article) {  echo $article->title;}

查詢出所有文章并循環(huán)打印出所有標(biāo)題，按照 updated_at 倒序排序

$articles = Article::where('id', '>', 10)->where('id', '<', 20)->orderBy('updated_at', 'desc')->get();foreach ($articles as $article) {  echo $article->title;}

基礎(chǔ)使用要點(diǎn)
1. 每一個(gè)繼承了 Eloquent 的類都有兩個(gè) '固定用法' 'Article::find($number)' 'Article::all()'，前者會(huì)得到一個(gè)帶有數(shù)據(jù)庫中取出來值的對(duì)象，后者會(huì)得到一個(gè)包含整個(gè)數(shù)據(jù)庫的對(duì)象合集。

2. 所有的中間方法如 'where()' 'orderBy()' 等都能夠同時(shí)支持 '靜態(tài)' 和 '非靜態(tài)鏈?zhǔn)?#39; 兩種方式調(diào)用，即 'Article::where()...' 和 'Article::....->where()'。

3. 所有的 '非固定用法' 的調(diào)用最后都需要一個(gè)操作來 '收尾'，本片教程中有兩個(gè) '收尾操作'：'->get()' 和 '->first()'。

二、中間操作流
Builder 這個(gè)單詞可以直譯成構(gòu)造器，但是“中間操作流”更容易理解，因?yàn)閿?shù)據(jù)庫操作大部分時(shí)候都是鏈?zhǔn)讲僮鞯摹?/p>

中間操作流，請(qǐng)看代碼：

Article::where('id', '>', 10)->where('id', '<', 20)->orderBy('updated_at', 'desc')->get();

這段代碼的 `::where()->where()->orderBy()` 就是中間操作流。中間操作流用面向?qū)ο蟮姆椒▉砝斫?，可以總結(jié)成一句話：

創(chuàng)建一個(gè)對(duì)象，并不斷修改它的屬性，最后用一個(gè)操作來觸發(fā)數(shù)據(jù)庫操作。
如何找到中間操作流的蛛絲馬跡

中間操作流這個(gè)東西，文檔里幾乎沒有任何有價(jià)值的信息，那么，我們?cè)撛趺凑页鲞@個(gè)玩意兒呢？很簡(jiǎn)單，使用以下代碼：

$builder = Article::where('title', "我是標(biāo)題")->title;

然后你就會(huì)看到下面的錯(cuò)誤：

為什么會(huì)出現(xiàn)錯(cuò)誤？因?yàn)?`Article::where()` 了之后依然是 `Builder` 對(duì)象，還不是 `Article` 對(duì)象，不能直接取 `title`。

“終結(jié)者”方法

所謂 “終結(jié)者” 方法，指的是在 N 個(gè)中間操作流方法對(duì)某個(gè) Eloquent 對(duì)象進(jìn)行加工以后，觸發(fā)最終的數(shù)據(jù)庫查詢操作，得到返回值。

`first()` `get()` `paginate()` `count()` `delete()` 是用的比較多的一些 “終結(jié)者” 方法，他們會(huì)在中間操作流的最后出現(xiàn)，把 SQL 打給數(shù)據(jù)庫，得到返回?cái)?shù)據(jù)，經(jīng)過加工返回一個(gè) Article 對(duì)象或者一群 Article 對(duì)象的集合。

復(fù)雜用法示例

三、模型間關(guān)系（關(guān)聯(lián)）
1.一對(duì)一關(guān)系

顧名思義，這描述的是兩個(gè)模型之間一對(duì)一的關(guān)系。這種關(guān)系是不需要中間表的。

假如我們有兩個(gè)模型：User 和 Account，分別對(duì)應(yīng)注冊(cè)用戶和消費(fèi)者，他們是一對(duì)一的關(guān)系，那么如果我們要使用 Eloquent 提供的一對(duì)一關(guān)系方法，表結(jié)構(gòu)應(yīng)該是這樣的：

user: id ... ... account_idaccount: id ... ... user_id

假設(shè)我們需要在 User 模型中查詢對(duì)應(yīng)的 Account 表的信息，那么代碼應(yīng)該是這樣的。 `/app/models/User.php`:

<?phpclass User extends Eloquent {  protected $table = 'users'; public function hasOneAccount() {   return $this->hasOne('Account', 'user_id', 'id'); }}

然后，當(dāng)我們需要用到這種關(guān)系的時(shí)候，該如何使用呢？如下：

$account = User::find(10)->hasOneAccount;

此時(shí)得到的 `$account` 即為 `Account` 類的一個(gè)實(shí)例。

這里最難的地方在于后面的兩個(gè) foreign_key 和 local_key 的設(shè)置，大家可以就此記?。涸?User 類中，無論 hasOne 誰，第二個(gè)參數(shù)都是 `user_id`，第三個(gè)參數(shù)一般都是 `id`。由于前面的 `find(10)` 已經(jīng)鎖定了 id = 10，所以這段函數(shù)對(duì)應(yīng)的 SQL 為： `select * from account where user_id=10`。

這段代碼除了展示了一對(duì)一關(guān)系該如何使用之外，還傳達(dá)了三點(diǎn)信息，也是我對(duì)于大家使用 Eloquent 時(shí)候的建議：

（1）. 每一個(gè) Model 中都指定表名

（2）. has one account 這樣的關(guān)系寫成 `hasOneAccount()` 而不是簡(jiǎn)單的 `account()`

（3）. 每次使用模型間關(guān)系的時(shí)候都寫全參數(shù)，不要省略
相應(yīng)的，如果使用 belongsTo() 關(guān)系，應(yīng)該這么寫：

<?phpclass Account extends Eloquent { protected $table = 'accounts';  public function belongsToUser() {  return $this->belongsTo('User', 'user_id', 'id'); }}

2.一對(duì)多關(guān)系

學(xué)會(huì)了前面使用一對(duì)一關(guān)系的基礎(chǔ)方法，后面的幾種關(guān)系就簡(jiǎn)單多了。

我們引入一個(gè)新的Model：Pay，付款記錄。表結(jié)構(gòu)應(yīng)該是這樣的：

user: id ... ...pay: id ... ... user_id

User 和 Pay 具有一對(duì)多關(guān)系，換句話說就是一個(gè) User 可以有多個(gè) Pay，這樣的話，只在 Pay 表中存在一個(gè) `user_id` 字段即可。 `/app/models/User.php`:

<?phpclass User extends Eloquent {  protected $table = 'users'; public function hasManyPays() {  return $this->hasMany('Pay', 'user_id', 'id'); }}

然后，當(dāng)我們需要用到這種關(guān)系的時(shí)候，該如何使用呢？如下：

$accounts = User::find(10)->hasManyPays()->get();

此時(shí)得到的 `$accounts` 即為 `Illuminate/Database/Eloquent/Collection` 類的一個(gè)實(shí)例。大家應(yīng)該也已經(jīng)注意到了，這里不是簡(jiǎn)單的 `-> hasOneAccount` 而是 `->hasManyPays()->get()`，為什么呢？因?yàn)檫@里是 `hasMany`，操作的是一個(gè)對(duì)象集合。

相應(yīng)的 belongsTo() 的用法跟上面一對(duì)一關(guān)系一樣：

<?phpclass Pay extends Eloquent { protected $table = 'pays';  public function belongsToUser() {  return $this->belongsTo('User', 'user_id', 'id'); }}

3.多對(duì)多關(guān)系

多對(duì)多關(guān)系和之前的關(guān)系完全不一樣，因?yàn)槎鄬?duì)多關(guān)系可能出現(xiàn)很多冗余數(shù)據(jù)，用之前自帶的表存不下了。

我們定義兩個(gè)模型：Article 和 Tag，分別表示文章和標(biāo)簽，他們是多對(duì)多的關(guān)系。表結(jié)構(gòu)應(yīng)該是這樣的：

article: id ... ...tag: id ... ...article_tag: article_id tag_id

在 Model 中使用：

<?phpclass Tag extends Eloquent { protected $table = 'tags';  public function belongsToManyArticle() {  return $this->belongsToMany('Article', 'article_tag', 'tag_id', 'article_id'); }}

需要注意的是，第三個(gè)參數(shù)是本類的 id，第四個(gè)參數(shù)是第一個(gè)參數(shù)那個(gè)類的 id。

使用跟 hasMany 一樣：

$tagsWithArticles = Tag::take(10)->get()->belongsToManyArticle()->get();

這里會(huì)得到一個(gè)非常復(fù)雜的對(duì)象，可以自行 `var_dump()`。跟大家說一個(gè)訣竅，`var_dump()` 以后，用 Chrome 右鍵 “查看源代碼”，就可以看到非常整齊的對(duì)象/數(shù)組展開了。

在這里給大家展示一個(gè)少見用法（奇技淫巧）：

public function parent_video(){  return $this->belongsToMany($this, 'video_hierarchy', 'video_id', 'video_parent_id');}public function children_video(){  return $this->belongsToMany($this, 'video_hierarchy', 'video_parent_id', 'video_id');}

對(duì)，你沒有看錯(cuò)，可以 belongsToMany 自己。
其他關(guān)系

Eloquent 還提供 “遠(yuǎn)層一對(duì)多關(guān)聯(lián)”、“多態(tài)關(guān)聯(lián)” 和 “多態(tài)的多對(duì)多關(guān)聯(lián)” 這另外三種用法，經(jīng)過上面的學(xué)習(xí)，我們已經(jīng)掌握了 Eloquent 模型間關(guān)系的基本概念和使用方法，剩下的幾種不常用的方法就留到我們用到的時(shí)候再自己探索吧。

重要技巧：關(guān)系預(yù)載入
你也許已經(jīng)發(fā)現(xiàn)了，在一對(duì)一關(guān)系中，如果我們需要一次性查詢出10個(gè) User 并帶上對(duì)應(yīng)的 Account 的話，那么就需要給數(shù)據(jù)庫打 1 + 10 條 SQL，這樣性能是很差的。我們可以使用一個(gè)重要的特性，關(guān)系預(yù)載入：http://laravel-china.org/docs/eloquent#eager-loading

直接上代碼：

$users = User::with('hasOneAccount')->take(10)->get()

這樣生成的 SQL 就是這個(gè)樣子的：

select * from account where id in (1, 2, 3, ... ...)

這樣 1 + 10 條 SQL 就變成了 1 + 1 條，性能大增。