使用 Eloquent ORM

Laravel 工作坊
使用 Eloquent ORM
shengyou @ 彰師大資工系學會 (2014.12.07)

階段任務
• 學習 Eloquent ORM 的使用方式，了解
Laravel 操作資料庫的方法
• 學習如何使用 artisan tinker、dd() 等工具
來協助測試 Model 程式碼

什麼是 ORM？
• ORM = Object-relational mapping
• 簡單來說，就是把資料庫裡一筆一筆的資
料變成物件來操作。些物件透過繼承可
以增加更多的方法，讓資料庫的操作
(CRUD) 更加直覺、方便

為什麼要用 ORM？
• 原本在寫資料庫查詢時，往往需要自行依
照需求寫 SQL 查詢式，當查詢式變
長、關聯日趨複雜時，很難直覺了解該查
詢式的作用
• 自行處理 SQL 查詢式時，也需確認輸入
的字串是否都有 Escape 以防安全性疑慮

Model 慣例
• Laravel 的相關慣例複習
- 一個 resource 對應到 DB 裡的一個 table
- 一個 model 對應到 table 裡的一個 row
- table 名稱用複數； model 名稱用單數
- 從資料表取出來的東西是 Collection，
可當陣列(array) 使用

tinker 小幫手
• PHP 本身有內建互動指令 (REPL) 模式，
可用 php -a 進入，可在其中測試程式碼
• tinker 則是 Laravel 提供的 artisan 指令，除
了進入 PHP 的 REPL 模式外，加載 Laravel
所有物件環境，可讓我們在其中測試
Laravel 的程式碼
★ tinker 說明：http://laravel-recipes.com/recipes/280/interacting-with-your-application

artisan tinker
• 進入 PHP 互動模式，並載入 Laravel 環境
- 可以直接在指令模式下操作 Laravel 各元
件，測試程式寫法
- 要結束請用 exit; 指令
• 範例：
$
php
artisan
tinker
[1]
>
exit;
★ 由於 tinker 相依的 extension pcntl 在 Windows 上沒有實作，因此無
法全功能支援 tinker 功能：http://php.net/manual/en/pcntl.installation.php

dd() 測試工具
• Laravel 內建一個 debug 輔助函式：dd()
- 其實就是把變數丟進 var_dump 後 exit
- 可以在任何地方使用，測試程式碼流
程、邏輯、了解物件內容
• 範例：
$post
=
Post::find(1);
dd($post);
★ dd() 說明：http://laravel.com/docs/4.2/helpers#miscellaneous

新增資料
• 使用 new 建構式
- 直接使用 new 建構式產生 Model 實體，
再存
• 範例：
$post
=
new
Post;
$post-‐>title
=
‘My
Title’;
$post-‐>save();

新增資料
• create($array);
- 從陣列新增資料，陣列的 key 值自動對
應到資料表的欄位
• 範例：
$post
=
Post::create($input);

Mass Assignment
• Laravel 的 ORM 可以直接用 Mass
Assignment 的方式直接新增資料，語法簡
潔、快速方便，但有可能會有安全性問題
• 在 generator 產生的 Model 裡，ﬁllable 的
屬性就是在設定些欄位可以使用 Mass
Assignment 做為防禦手段
★ 官網文件：http://laravel.tw/docs/4.2/eloquent#mass-assignment

設定 ﬁllable、guarded
• 在 Model 內設定 ﬁllable 屬性，指定些欄
位可以透過 Mass Assignment 來寫入/更新
資料
• guarded 則是相反的屬性，設定後可以保
護特定欄位不使用 Mass Assignment
• 範例：
protected
$fillable
=
[‘title’,
‘content’,
‘category_id’];
protected
$guarded
=
[‘id’,
‘password’];

刪除資料
• delete();
- 先取出 Model 實體後，再刪除
• 範例：
$post
=
Post::find(1);
$post-‐>delete();

刪除資料
• destroy($id);
- 刪除一筆資料，使用 primary key
• destroy([1, 2, 3]);
- 刪除多筆資料，使用 array 傳值
• destroy(1, 2, 3);
- 刪除多筆資料，使用多參數傳值

更新資料
• save();
• 先取出 Model 實體後，再針對屬性更
新，全部完成後再存
• 範例：
$post
=
Post::find(1);
$post-‐>title
=
‘My
New
Title’;
$post-‐>save();

更新資料
• update($array);
- 從陣列更新資料，陣列的 key 值自動對
應到資料表的欄位
• 範例：
$post
=
Post::find(1);
$post-‐>update($input);

查尋資料
• all() // 取出全部資料
• ﬁnd($id); // 使用 primary key
• where(‘欄位’,‘條件’,‘值’);
• orderBy(‘欄位’,‘排序方式’);
• get(); // 回傳 Collection
• ﬁrst(); // 回傳 Model

Collection 逐筆取出
• 從 Model 查詢的結果，Eloquent 會回傳一
個 Collection，其行為就像陣列一樣，可
以支援用 foreach 取出資料
• 範例：
$posts
=
Post::all();
//
$posts
是
Collection
foreach($posts
as
$post)
{

echo
$post-‐>title;
//
$post
是
Model
}

特異功能
• paginate($per_page);
- 依設定的筆數在 Query 內加 Limit 語
法，在 view 上可自動支援分頁
• random($num);
- 從 Collection 隨機取出 n 筆資料

更多 ORM 操作方式
• 官方文件
- http://laravel.tw/docs/4.2/eloquent#insert-
update-delete
• Collection 用法
- http://jenssegers.be/blog/51/laravel-
collections-are-awesome

存點
• 試著把現在已經可以運作的程式碼加入版
本控制內
• 流程提醒：
- working directory > staging area > commit

Model 資料關聯
• 在 Model 內定義其與其他 Model 間的關聯
類型 Eloquent 就會自動將個關聯變成物
件間的屬性，而無需自行下 SQL 語法
• 範例：
public
function
{另一個
Model
的名稱(單/複數)}()
{

return
$this-‐>{關聯類型}(‘{Model
名稱}’);
}

關聯類型
• belongsTo(‘Model’);
- 歸屬於另一個 Model
• hasMany(‘Model’);
- 擁有多個 Model
★ 關聯類型詳細說明：http://laravel.tw/docs/4.2/eloquent#relationships

資料關聯設定
Post 關聯設定

資料關聯設定
Category 關聯設定

資料關聯設定
Comment 關聯設定

Model 內取用關聯
• 把資料間的關聯用物件的方式去思考，即
可透過 Model 的屬性值去取得關聯後的資
料內容
• 範例：
$post
=
Post::find(1);
echo
$post-‐>category-‐>name;
foreach($post-‐>comments
as
$comment)
{

echo
$comment-‐>content;
}

階段檢查表
• 在 routes.php 內測試 Eloquent ORM 用法
的 get request 規則數個
• 三個 Model 內都有對應的關聯邏輯設定

問與答
學員可開始練習、實作

單元小結
• 在個單元裡，我們說明學習如何使用
Eloquent ORM 進行資料操作，並從 tinker
及 route 內了解操作結果
• 下一個單元，我們將學習 Laravel 的流程
處理及 Route 設定

使用 Eloquent ORM

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Viewers also liked

Viewers also liked (12)

Similar to 使用 Eloquent ORM

Similar to 使用 Eloquent ORM (20)

More from Shengyou Fan

More from Shengyou Fan (20)

使用 Eloquent ORM