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