在 2015 年 7 月至新北市樹林國小舉辦 Laravel 工作坊，讓參與的學員在 30 個小時內學會使用 Laravel 建置一個具 Open ID 認證功能的網路應用程式。

1. Route 路由控制
范聖佑 Shengyou Fan
新北市樹林國⼩小 (2015/07/07)
適
⽤用
5.1
版

2. 單元主題
• 什麼是 Route 路由？
• 使⽤用 Route 路由跟以往的作法有什麼不同？有什麼
好處？
• 如何設定 Laravel 的 Route？
• 依照⼯工作坊網站規劃書⽰示範如何設定 Route

3. Route
簡介

4. 什麼是 Route (路由)？
• 把它想像成是應⽤用程式的⼤大⾨門管理員，每⼀一個
Request 都要通過管理員，符合正確的條件才可以送
到後⽅方應⽤用程式做處理，⽽而管理員的放⾏行原則，就
是依照應⽤用程式設定的 Route 規則來驗證
• 簡單來說，Route 就是應⽤用程式的⾨門禁規則，規則內
指定每⼀一個 Route 可以接受的動作 (GET、POST、
PATCH、DELETE) 、對應的網址 (uri) 及傳⼊入的參數
• Route 會從規則表裡由上⽽而下逐⼀一⽐比對，符合就會執
⾏行、若找不到就會回傳 404 (Not Found)

5. 在使⽤用 Route 之前…
index.php
依 URL 對應⾄至各
php 檔案，找不
到檔案就是 404
Server
Request
Response
Client contact.php
search.php
posts.php
about.php GET
GET、POST
PATCH、DELETE
GET
GET、POST
GET
各 php 檔裡要⾃自⾏行處理可
接受的 HTTP 動作判斷

6. Laravel 的 Route 機制
Route
Controller
ModelView
index.php
Server
Request
Response
Client
app init
★ 參考說明：http://laravel-recipes.com/recipes/52/understanding-the-request-lifecycle

7. 為什麼要⽤用 Route？
• HTTP 伺服器的 Document Root 指定在 public，透過
框架進⼊入點 (index.php) 統⼀一管理所有路由，增加程
式碼安全性
• 搭配 HTTP 伺服器的 rewirte 模組 (Apache 和 Nginx
都有對應)，可以讓網站的網址變得更好看也更符合
RESTFul 語意
• 透過 Route 設計，應⽤用程式內所有可使⽤用的路徑就
⼀一⺫⽬目了然，增加團隊合作時的效率
• 在針對應⽤用程式除錯時，可以透過統⼀一的運作路徑
逐⼀一排除錯誤

8. Route
語法
★ 參考⽂文件：http://laravel.com/docs/5.1/routing

9. Laravel 的 Route 設定檔
• 由於 Route 處理所有 HTTP 相關的 Request，因此
Laravel 的 Route 規則設定檔根據功能放置在：
- app/Http/routes.php

10. 設定 Route 動作
• 接收 GET (讀取)
• 接收 POST (寫⼊入)
• 接收 PATCH (更新)
• 接收 DELETE (刪除)
Route::get('{uri}',
function()
{
//
Closure
});
Route::post('{uri}',
function()
{
//
Closure
});
Route::patch('{uri}',
function()
{
//
Closure
});
Route::delete('{uri}',
function()
{
//
Closure
});

11. Route 接收參數
• 接收必要參數
• 接收選擇性參數
Route::get('posts/{id}',
function($id)
{
return
'Post:
'.$id;
});
Route::get('users/{name?}',
function($name
=
'John')
{
return
'My
name
is
'.$name;
});

12. 限制參數格式
• 使⽤用 where 限制
• 使⽤用 pattern 限制
Route::get('posts/{id}',
function($id)
{
return
'Post:
'.$id;
})
-­‐>where('id',
'[0-­‐9]+');
Route::pattern('id',
'[0-­‐9]+');
Route::get('posts/{id}',
function($id)
{
return
'Post:
'.$id;
});

13. 有哪些 routes？
• 當應⽤用程式愈寫愈⼤大、Route 也因此愈設定愈多時，
尤其綜合使⽤用很多 Route 特異功能時，如何知道⺫⽬目
前的應⽤用程式有哪些 routes 呢？
答：artisan 有⼀一個指令，可以將⺫⽬目前所有 routes
規則整理成表格後印出，透過這個表格就可以知道
到底有多少條規則被設定了

14. $
php
artisan
route:list
(列出⺫⽬目前所有的
route
規則)

15. artisan
route:list
• 印出所有 route 表格
- 呼叫這個指令，artisan 會把⺫⽬目前應⽤用程式內所有
的 route 規則整理成表格印出在畫⾯面上
- -­‐-­‐name={...} 依名字搜尋 route
- -­‐-­‐path={...} 依路徑搜尋 route
• 範例：
$
php
artisan
route:list

16. 檢查 Route 設定
⽤用 artisan 指令列出⺫⽬目前的 Route 設定

17. 進階
Route
設定
★ 參考⽂文件：http://laravel.com/docs/5.1/routing

18. 進階 Route 設定
• Laravel 還可搭配進階技巧做出更多彈性的設計
- Named Routes
- Route 群組
‣ Route Prefixing
‣ Sub-Domain Routing

19. 為 Route 命名
• 可以為每⼀一個 Route 取⼀一個名字
• 之後在 view 上⾯面就可以直接⽤用 helper 產⽣生 url
Route::get('post/{id}',
['as'
=>
'posts.show',
function()
{
//
}]);
<a
href="{{
route('posts.show',
$id)
}}"></a>

20. Route 群組
• 將⼀一系列有相同設定的 Route 規則組成⼀一個群組來
⼀一同設定，除了少打⼀一些程式碼外，在管理上也⽐比
較⽅方便
Route::group(['{function}'
=>
'{setting}'],
function()
{
Route::get('{uri}',
function()
{
});
});

21. Route Prefixing
• 設定某些 Route 前都有共同的前置 uri
Route::group(['prefix'
=>
'admin'],
function()
{
Route::get('users',
function()
{
//
實際上的
URL
會是
"/admin/users"
});
});

22. Sub-Domain Routing
• 限制 Route 只能在某個 Sub-Domain 才接受
Route::group(['domain'
=>
'{account}.myapp.com'],
function()
{
Route::get('user/{id}',
function($account,
$id)
{
//
URL
若是
{account}.myapp.com
就會進⼊入這裡
});
});

23. 設定專案
Route

24. 專案網站架構圖

25. 預定完成的 Route

26. 直接回傳字串
• 在這個階段的實作裡，我們先直接在 Route 裡回傳
字串，先確認把通道打開即可
• 在瀏覽器裡預覽時，只要有看到字串顯⽰示在畫⾯面上
就表⽰示成功了
• 若發現打中⽂文是亂碼，是因為我們送出的內容裡沒
有編碼設定
Route::get('/',
function()
{
return
'home.index';
});

27. Route 規則表格
設定完 routes.php 後，執⾏行 artisan route:list 檢查結果

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

29. 單元總結
• 在這個單元裡我們學到了些什麼？
- 什麼是 Route 以及使⽤用 Route 的好處
- Laravel 的 Route 語法
- 設定專案應⽤用程式的 Route

30. Q & A
歡迎提問討論