# 路由定義 ## 注冊路由規則 > `route`目錄下的任何路由定義文件都是有效的，默認的路由定義文件是`route.php`，但你完全可以更改文件名，或者添加多個路由定義文件（你可以進行模塊定義區分，但最終都會一起加載）。 ``` ├─route 路由定義目錄 │ ├─route.php 路由定義 │ ├─api.php 路由定義 │ └─... 更多路由定義 ``` 假設后面的路由定義內容我們統一在`route.php`文件里面定義，最基礎的路由定義方法是： > #### Route::rule('路由表達式','路由地址','請求類型'); 除了路由表達式和路由地址是必須的外，其它參數均為可選。`5.1`版本推薦采用方法的方式定義請求類型、路由參數及變量規則。 例如注冊如下路由規則： ``` // 注冊路由到index模塊的News控制器的read操作 Route::rule('new/:id','index/News/read'); ``` 我們訪問： ``` http://serverName/new/5 ``` 會自動路由到： ``` http://serverName/index/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請求putDELETEDELETE請求deletePATCHPATCH請求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'); ``` 變量用`[ ]`包含起來后就表示該變量是路由匹配的可選變量。 以上定義路由規則后，下面的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完全匹配，可以在`app.php`中設置 ``` // 開啟路由完全匹配 'route_complete_match' => true, ``` ### 額外參數 在路由跳轉的時候支持額外傳入參數對（額外參數指的是不在URL里面的參數，隱式傳入需要的操作中，有時候能夠起到一定的安全防護作用，后面我們會提到）。例如： ``` Route::get('blog/:id','blog/read?status=1&app_id=5'); ``` 上面的路由規則定義中額外參數的傳值方式都是等效的。`status`和`app_id`參數都是URL里面不存在的，屬于隱式傳值，當然并不一定需要用到，只是在需要的時候可以使用。 ### 路由標識 如果你需要快速的根據路由生成URL地址，可以在定義路由的時候指定生成標識（但要確保唯一）。 例如 ``` // 注冊路由到index模塊的News控制器的read操作 Route::name('new_read')->rule('new/:id','index/News/read'); ``` 生成路由地址的時候就可以使用 ``` url('new_read',['id'=>10]); ``` 如果不定義路由標識的話，使用下面的方式生成 ``` url('index/News/read',['id'=>10]); ``` > `V5.1.6+`版本開始，路由標識的用法調整，原來的用法： ``` // 注冊路由到index模塊的News控制器的read操作 Route::name('new_read')->rule('new/:id','index/News/read'); ``` 需要改為： ``` // 注冊路由到index模塊的News控制器的read操作 Route::rule('new/:id','index/News/read')->name('new_read'); ``` 因為后者更符合語義。