我們先從建立一個 Eloquent 模型開始。模型通常放在 app 目錄下，但是您可以將它們放在任何地方，只要能通過 composer.json 自動載入。所有的 Eloquent 模型都繼承于 Illuminate\Database\Eloquent\Model 。 ## 定義一個 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 Illuminate\Database\Eloquent\ModelNotFoundException; 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); ~~~