路由參數 · thinkphp6文檔

## 路由參數路由分組及規則定義支持指定路由參數，這些參數主要完成路由匹配檢測以及后續行為。 > 路由參數可以在定義路由規則的時候直接傳入（批量），推薦使用方法配置更加清晰。 | 參數 | 說明 | 方法名 | | --- | --- | --- | | 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 | 用法舉例： ~~~ Route::get('new/:id', 'News/read') ->ext('html') ->https(); ~~~ > 這些路由參數可以混合使用，只要有任何一條參數檢查不通過，當前路由就不會生效，繼續檢測后面的路由規則。如果你需要批量設置路由參數，也可以使用`option`方法。 ~~~ Route::get('new/:id', 'News/read') ->option([ 'ext' => 'html', 'https' => true ]); ~~~ ### URL后綴 > URL后綴如果是全局統一的話，可以在應用配置文件`route.php`中設置`url_html_suffix`參數，如果當前訪問的URL地址中的URL后綴是允許的偽靜態后綴，那么后綴本身是不會被作為參數值傳入的。不同參數設置的區別如下： | 配置值 | 描述 | | --- | --- | | `false` | 禁止偽靜態訪問 | | 空字符串 | 允許任意偽靜態后綴 | | `html` | 只允許設置的偽靜態后綴 | | `html|htm` | 允許多個偽靜態后綴 | ~~~ // 定義GET請求路由規則并設置URL后綴為html的時候有效 Route::get('new/:id', 'News/read') ->ext('html'); ~~~ 支持匹配多個后綴，例如： ~~~ 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 ]); ~~~ ### 追加額外參數可以在定義路由的時候隱式追加額外的參數，這些參數不會出現在URL地址中。 ~~~ Route::get('blog/:id', 'Blog/read') ->append(['app_id' => 1, 'status' => 1]); ~~~ 在路由請求的時候會同時傳入`app_id`和`status`兩個參數。 ### 路由綁定模型路由規則和分組支持綁定模型數據，例如： ~~~ Route::get('hello/:id', 'index/hello') ->model('id', '\app\index\model\User'); ~~~ 會自動給當前路由綁定`id`為當前路由變量值的`User`模型數據。如果你的模型綁定使用的是`id`作為查詢條件的話，還可以簡化成下面的方式 ~~~ Route::get('hello/:id', 'index/hello') ->model('\app\index\model\User'); ~~~ 默認情況下，如果沒有查詢到模型數據，則會拋出異常，如果不希望拋出異常，可以使用 ~~~ 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`參數來進行權限檢查。