## 路由參數 路由分組及規則定義支持指定路由參數，這些參數主要完成路由匹配檢測以及后續行為。 >[danger] 路由參數可以在定義路由規則的時候直接傳入（批量），推薦使用方法配置更加清晰。 |參數|說明|方法名| |---|---|---| |ext|URL后綴檢測，支持匹配多個后綴|ext| |deny_ext|URL禁止后綴檢測，支持匹配多個后綴|denyExt| |https|檢測是否https請求|https| |domain|域名檢測|domain| |complete_match|是否完整匹配路由|completeMatch| |model|綁定模型|model| |cache|請求緩存|cache| |ajax|Ajax檢測|ajax| |pjax|Pjax檢測|pjax| |json|JSON檢測|json| |validate|綁定驗證器類進行數據驗證|validate| |append|追加額外的參數|append| |middleware|注冊路由中間件|middleware| |filter|請求變量過濾|filter| |match|路由閉包檢測（`V6.0.12+`）|match| 用法舉例： ~~~ Route::get('new/:id', 'News/read') ->ext('html') ->https(); ~~~ > 這些路由參數可以混合使用，只要有任何一條參數檢查不通過，當前路由就不會生效，繼續檢測后面的路由規則。 如果你需要批量設置路由參數，也可以使用`option`方法。 ~~~ Route::get('new/:id', 'News/read') ->option([ 'ext' => 'html', 'https' => true ]); ~~~ ### URL后綴 >[danger] URL后綴如果是全局統一的話，可以在路由配置文件中設置`url_html_suffix`參數，如果當前訪問的URL地址中的URL后綴是允許的偽靜態后綴，那么后綴本身是不會被作為參數值傳入的。 不同參數設置的區別如下： 配置值|描述 ---|---|--- `false`|禁止偽靜態訪問 空字符串|允許任意偽靜態后綴 `html`|只允許設置的偽靜態后綴 `html|htm`|允許多個偽靜態后綴 ~~~ // 定義GET請求路由規則 并設置URL后綴為html的時候有效 Route::get('new/:id', 'News/read') ->ext('html'); ~~~ 支持匹配多個后綴，例如： ~~~php Route::get('new/:id', 'News/read') ->ext('shtml|html'); ~~~ > 如果`ext`方法不傳入任何值，表示不允許使用任何后綴訪問。 可以設置禁止訪問的URL后綴，例如： ~~~ // 定義GET請求路由規則 并設置禁止URL后綴為png、jpg和gif的訪問 Route::get('new/:id', 'News/read') ->denyExt('jpg|png|gif'); ~~~ > 如果`denyExt`方法不傳入任何值，表示必須使用后綴訪問。 ### 域名檢測 支持使用完整域名或者子域名進行檢測，例如： ~~~ // 完整域名檢測 只在news.thinkphp.cn訪問時路由有效 Route::get('new/:id', 'News/read') ->domain('news.thinkphp.cn'); // 子域名檢測 Route::get('new/:id', 'News/read') ->domain('news'); ~~~ > 如果需要給子域名定義批量的路由規則，建議使用`domain`方法進行路由定義。 ### `HTTPS`檢測 支持檢測當前是否`HTTPS`訪問 ~~~ // 必須使用HTTPS訪問 Route::get('new/:id', 'News/read') ->https(); ~~~ ### `AJAX`/`PJAX`/`JSON`檢測 可以檢測當前是否為`AJAX`/`PJAX`/`JSON`請求。 ~~~ // 必須是JSON請求訪問 Route::get('new/:id', 'News/read') ->json(); ~~~ ### 請求變量檢測 可以在匹配路由地址之外，額外檢查請求變量是否匹配，只有指定的請求變量也一致的情況下才能匹配該路由。 ~~~ // 檢查type變量 Route::post('new/:id', 'News/save') ->filter('type', 1); // 檢查多個請求變量 Route::post('new/:id', 'News/save') ->filter([ 'type' => 1,'status'=> 1 ]); ~~~ ### 閉包檢測 `V6.0.12+`開始，可以通過閉包來檢測當前路由或分組是否匹配 ~~~ // 閉包檢測 Route::get('new/:id', 'News/read') ->match(function(Rule $rule,Request $request) { // 如果返回false 則視為不匹配 return false; }); ~~~ ### 追加額外參數 可以在定義路由的時候隱式追加額外的參數，這些參數不會出現在URL地址中。 ~~~php Route::get('blog/:id', 'Blog/read') ->append(['app_id' => 1, 'status' => 1]); ~~~ 在路由請求的時候會同時傳入`app_id`和`status`兩個參數。 ### 路由綁定模型 路由規則和分組支持綁定模型數據，例如： ~~~php Route::get('hello/:id', 'index/hello') ->model('id', '\app\index\model\User'); ~~~ 會自動給當前路由綁定 `id`為 當前路由變量值的`User`模型數據。 如果你的模型綁定使用的是`id`作為查詢條件的話，還可以簡化成下面的方式 ~~~php Route::get('hello/:id', 'index/hello') ->model('\app\index\model\User'); ~~~ 默認情況下，如果沒有查詢到模型數據，則會拋出異常，如果不希望拋出異常，可以使用 ~~~php Route::rule('hello/:id', 'index/hello') ->model('id', '\app\index\model\User', false); ~~~ 可以定義模型數據的查詢條件，例如： ~~~ Route::rule('hello/:name/:id', 'index/hello') ->model('id&name', '\app\index\model\User'); ~~~ 表示查詢`id`和`name`的值等于當前路由變量的模型數據。 也可以使用閉包來自定義返回需要的模型對象 ~~~ Route::rule('hello/:id', 'index/hello') ->model(function ($id) { $model = new \app\index\model\User; return $model->where('id', $id)->find(); }); ~~~ 閉包函數的參數就是當前請求的URL變量信息。 > 綁定的模型可以直接在控制器的架構方法或者操作方法中自動注入，具體可以參考請求章節的依賴注入。 ## 請求緩存 可以對當前的路由請求進行請求緩存處理，例如： ~~~ Route::get('new/:name$', 'News/read') ->cache(3600); ~~~ 表示對當前路由請求緩存`3600`秒，更多內容可以參考請求緩存一節。 ## 動態參數 如果你需要額外自定義一些路由參數，可以使用下面的方式： ~~~ Route::get('new/:name$', 'News/read') ->option('rule','admin'); ~~~ 或者使用動態方法 ~~~ Route::get('new/:name$', 'News/read') ->rule('admin'); ~~~ 在后續的路由行為后可以調用該路由的`rule`參數來進行權限檢查。