框架的路由定義方式

路由是定位要存取的伺服器資源的技術!

註冊路由

最基礎的路由定義方法是：`Route::rule('路由表達式', '路由位址', '請求類型')`

use think\facade\Route;

以單一應用為例：

// 注册路由到News控制器的read操作
Route::rule('new/:id','News/read');

我們造訪：

http://serverName/new/5

會自動路由到：

http://serverName/news/read/id/5

且原來的存取位址會自動失效。

可以在rule方法中指定請求類型（不指定的話預設為任何請求類型有效），例如：

Route::rule('new/:id', 'News/update', 'POST');

請求類型參數不區分大小寫。

表示定義的路由規則在POST請求下才有效。如果要定義GET和POST請求支援的路由規則，可以用：

Route::rule('new/:id','News/read','GET|POST');

不過通常我們更推薦使用對應請求類型的快捷方法，包括：

##GETGET請求getPOSTPOST請求postPUTPUT請求put#DELETEDELETE請求delete

類型	描述
#GET

################################# #######PATCH######PATCH請求######patch############*######任何請求類型##### #any############

快速註冊方法的用法為：

Route::快捷方法名稱('路由表達式', '路由位址')

#使用範例如下：

Route::get('new/<id>','News/read'); // 定义GET请求路由规则
Route::post('new/<id>','News/update'); // 定义POST请求路由规则
Route::put('new/:id','News/update'); // 定义PUT请求路由规则
Route::delete('new/:id','News/delete'); // 定义DELETE请求路由规则
Route::any('new/:id','News/read'); // 所有请求都支持的路由规则

註冊多個路由規則後，系統會依序遍歷註冊過的滿足請求類型的路由規則，一旦配對到正確的路由規則後則開始執行最終的調度方法，後續規則就不再檢測。

規則表達式

#規則表達式通常包含靜態規則和動態規則，以及兩個規則的結合，例如下面都屬於有效的規則表達式：

Route::rule('/', 'index'); // 首页访问路由
Route::rule('my', 'Member/myinfo'); // 静态地址路由
Route::rule('blog/:id', 'Blog/read'); // 静态地址和动态地址结合
Route::rule('new/:year/:month/:day', 'News/read'); // 静态地址和动态地址结合
Route::rule(':user/:blog_id', 'Blog/read'); // 全动态地址

規則表達式的定義以/為參數分割符（無論你的PATH_INFO分隔符號設定是什麼，請確保在定義路由規則表達式的時候統一使用/進行URL參數分割，除非是使用組合變數的情況）。

每個參數可以包含動態變量，例如:變數或<變數>都表示動態變數（新版推薦使用第二種方式，更利於混合變數定義），並且會自動綁定到操作方法的對應參數。

你的URL存取PATH_INFO分隔符號使用pathinfo_depr配置，但無論如何配置，都不影響路由的規則表達式的路由分隔符號定義。

可選變數

支援對路由參數的可選定義，例如：

Route::get('blog/:year/[:month]','Blog/archive');
// 或者
Route::get('blog/<year>/<month?>','Blog/archive');

變數用[ ]包含起來後就表示該變數是路由匹配的可選變數。

以上定義路由規則後，下面的URL存取位址都可以被正確的路由匹配：

http://serverName/index.php/blog/2015
http://serverName/index.php/blog/2015/12

採用可選變數定義後，之前需要定義兩個或多個路由規則才能處理的情況可以合併為一個路由規則。

可選參數只能放到路由規則的最後，如果在中間使用了可選參數的話，後面的變數都會變成可選參數。

完全匹配

規則匹配偵測的時候預設只是對URL從頭開始匹配，只要URL位址開頭包含了定義的路由規則就會匹配成功，如果希望URL進行完全匹配，可以在路由表達式最後使用$符號，例如：

Route::get('new/:cate$', 'News/category');

這樣定義後

http://serverName/index.php/new/info

會匹配成功,而

http://serverName/index.php/new/info/2

則不會匹配成功。

如果是採用

Route::get('new/:cate', 'News/category');

方式定義的話，則兩種方式的URL存取都可以符合成功。

如果需要全域進行URL完全匹配，可以在路由設定檔中設定

// 开启路由完全匹配
'route_complete_match'   => true,

#額外參數

在路由跳轉的時候支援額外傳入參數對（額外參數指的是不在URL裡面的參數，隱式傳入需要的操作中，有時候能夠起到一定的安全防護作用，後面我們會提到）。例如：

Route::get('blog/:id','blog/read')
    ->append(['status' => 1, 'app_id' =>5]);

上面的路由規則定義中status和app_id參數都是URL裡面不存在的，屬於隱含傳值，當然不一定需要用到，只是在需要的時候可以使用。可以針對不同的路由設定不同的額外參數。

如果append方法中的變數和路由規則有衝突的話，append方法傳入的優先。

路由標識

如果你需要快速的根據路由產生URL位址，可以在定義路由的時候指定產生標識（但要確保唯一）。

例如

// 注册路由到News控制器的read操作
Route::rule('new/:id','News/read')
    ->name('new_read');

產生路由位址的時候就可以使用

url('new_read', ['id' => 10]);

如果不定義路由標識的話，系統會預設使用路由位址作為路由標識，例如可以使用下面的方式產生

url('News/read', ['id' => 10]);

強制路由
在路由設定檔中設定

'url_route_must'		=>  true,

首頁的路由規則採用/定義即可，例如下面把網站首頁路由輸出Hello,world!

Route::get('/', function () {
    return 'Hello,world!';
})

框架的路由定義方式

PHP中文網