# 路由地址 ## 路由地址 路由地址表示定義的路由表達式最終需要路由到的地址以及一些需要的額外參數，支持下面幾種方式定義： 定義方式定義格式方式1：路由到模塊/控制器'\[模塊/控制器/操作\]?額外參數1=值1&額外參數2=值2...'方式2：路由到重定向地址'外部地址'（默認301重定向） 或者 \['外部地址','重定向代碼'\]方式3：路由到控制器的方法'@\[模塊/控制器/\]操作'方式4：路由到類的方法'\\完整的命名空間類::靜態方法' 或者 '\\完整的命名空間類@動態方法'方式5：路由到閉包函數閉包函數定義（支持參數傳入）方式6：路由到Response對象Response對象定義及設置方式7：路由到模板文件使用`view`方法（`V5.1.3+`）其中方式5和6我們將會在下一節閉包支持中詳細描述。 ## 路由到模塊/控制器/操作 這是最常用的一種路由方式，把滿足條件的路由規則路由到相關的模塊、控制器和操作，然后由App類調度執行相關的操作。 同時會進行模塊的初始化操作（包括配置讀取、公共文件載入、行為定義載入、語言包載入等等）。 路由地址的格式為： > ### \[模塊/控制器/\]操作?參數1=值1&參數2=值2... 解析規則是從操作開始解析，然后解析控制器，最后解析模塊，例如： ``` // 路由到默認或者綁定模塊 Route::get('blog/:id','blog/read'); // 路由到index模塊 Route::get('blog/:id','index/blog/read'); ``` Blog類定義如下： ``` <?php namespace app\index\controller; class Blog { public function read($id) { return 'read:' . $id; } } ``` 路由地址中支持多級控制器，使用下面的方式進行設置： ``` Route::get('blog/:id','index/group.blog/read'); ``` 表示路由到下面的控制器類， ``` index/controller/group/Blog ``` Blog類定義如下： ``` <?php namespace app\index\controller\group; class Blog { public function read($id) { return 'read:' . $id; } } ``` 還可以支持路由到動態的模塊、控制器或者操作，例如： ``` // action變量的值作為操作方法傳入 Route::get(':action/blog/:id', 'index/blog/:action'); // 變量傳入index模塊的控制器和操作方法 Route::get(':c/:a', 'index/:c/:a'); ``` ### 額外參數 在這種方式路由跳轉的時候支持額外傳入參數對（額外參數指的是不在URL里面的參數，隱式傳入需要的操作中，有時候能夠起到一定的安全防護作用，后面我們會提到）。例如： ``` Route::get('blog/:id','blog/read?status=1&app_id=5'); ``` 上面的路由規則定義中額外參數`status`和`app_id`參數都是URL里面不存在的，屬于隱式傳值，當然并不一定需要用到，只是在需要的時候可以使用。 ## 路由到操作方法 路由地址的格式為： > ### @\[模塊/控制器/\]操作 這種方式看起來似乎和第一種是一樣的，本質的區別是直接執行某個控制器類的方法，而不需要去解析 **模塊/控制器/操作**這些，同時也不會去初始化模塊（因此不會調用模塊的初始化方法）。 例如，定義如下路由后： ``` Route::get('blog/:id','@index/blog/read'); ``` 相當于直接調用 `\app\index\controller\blog`類的`read`方法。 Blog類定義如下： ``` <?php namespace app\index\controller; class Blog { public function read($id) { return 'read:' . $id; } } ``` > 通常這種方式下面，由于沒有定義當前模塊名、當前控制器名和當前方法名 ，從而導致視圖的默認模板規則失效，所以這種情況下面，如果使用了視圖模板渲染，則必須傳入明確的參數而不是留空。 ## 路由到類的方法 路由地址的格式為（動態方法）： > ### \\類的命名空間\\類名@方法名 或者（靜態方法） > ### \\類的命名空間\\類名::方法名 這種方式更進一步，可以支持執行任何類的方法，而不僅僅是執行控制器的操作方法，例如： ``` Route::get('blog/:id','\app\index\service\Blog@read'); ``` 執行的是 `\app\index\service\Blog`類的`read`方法。 也支持執行某個靜態方法，例如： ``` Route::get('blog/:id','\app\index\service\Blog::read'); ``` 支持傳入額外的參數作為方法的參數調用（用于參數綁定），例如： ``` Route::get('blog/:id','\app\index\service\Blog::read?status=1'); ``` ## 路由到重定向地址 重定向的外部地址必須以“/”或者http開頭的地址。 如果路由地址以“/”或者“http”開頭則會認為是一個重定向地址或者外部地址，例如： ``` Route::get('blog/:id','/blog/read/id/:id'); ``` 和 ``` Route::get('blog/:id','blog/read'); ``` 雖然都是路由到同一個地址，但是前者采用的是301重定向的方式路由跳轉，這種方式的好處是URL可以比較隨意（包括可以在URL里面傳入更多的非標準格式的參數），而后者只是支持模塊和操作地址。舉個例子，如果我們希望`avatar/123`重定向到 /member/avatar/id/123\_small的話，只能使用： ``` Route::get('avatar/:id','/member/avatar/id/:id_small'); ``` 路由地址采用重定向地址的話，如果要引用動態變量，直接使用動態變量即可。 采用重定向到外部地址通常對網站改版后的URL遷移過程非常有用，例如： ``` Route::get('blog/:id','http://blog.thinkphp.cn/read/:id'); ``` 表示當前網站（可能是http://thinkphp.cn ）的 blog/123地址會直接重定向到 `http://blog.thinkphp.cn/read/123`。 路由重定向默認使用301狀態嗎，可以使用status方法單獨設置，例如： ``` Route::get('blog/:id','http://blog.thinkphp.cn/read/:id')->status(302); ``` `V5.1.3+`版本開始，可以直接使用`redirect`方法注冊一個重定向路由 ``` Route::redirect('blog/:id','http://blog.thinkphp.cn/read/:id',302); ``` ## 路由到模板（`V5.1.3`） `V5.1.3+`版本開始，支持路由直接渲染模板輸出。 ``` Route::view('hello/:name','index@hello'); ``` 表示該路由會渲染 index模塊下面的`view/hello.html`模板文件輸出。 模板文件中可以直接輸出當前請求的`param`變量，如果需要增加額外的模板變量，可以使用： ``` Route::view('hello/:name','index@hello',['city'=>'shanghai']); ``` 在模板中可以輸出`name`和`city`兩個變量。 ``` Hello,{$name}--{$city}！ ```