路由地址

路由地址定義

版本 新增功能
5.0.4 路由到類和控制器的方法支持傳入額外參數(shù)

路由地址表示定義的路由表達(dá)式最終需要路由到的地址以及一些需要的額外參數(shù),支持下面5種方式定義:

定義方式 定義格式
方式1:路由到模塊/控制器 '[模塊/控制器/操作]?額外參數(shù)1=值1&額外參數(shù)2=值2...'
方式2:路由到重定向地址 '外部地址'(默認(rèn)301重定向) 或者 ['外部地址','重定向代碼']
方式3:路由到控制器的方法 '@[模塊/控制器/]操作'
方式4:路由到類的方法 '\完整的命名空間類::靜態(tài)方法' 或者 '\完整的命名空間類@動(dòng)態(tài)方法'
方式5:路由到閉包函數(shù) 閉包函數(shù)定義(支持參數(shù)傳入)

其中方式5我們將會(huì)在下一個(gè)章節(jié)閉包支持中詳細(xì)描述。

路由到模塊/控制器/操作

這是最常用的一種路由方式,把滿足條件的路由規(guī)則路由到相關(guān)的模塊、控制器和操作,然后由App類調(diào)度執(zhí)行相關(guān)的操作。

同時(shí)會(huì)進(jìn)行模塊的初始化操作(包括配置讀取、公共文件載入、行為定義載入、語言包載入等等)。

路由地址的格式為:

[模塊/控制器/]操作?參數(shù)1=值1&參數(shù)2=值2...

解析規(guī)則是從操作開始解析,然后解析控制器,最后解析模塊,例如:

// 路由到默認(rèn)或者綁定模塊
'blog/:id'=>'blog/read',
// 路由到index模塊
'blog/:id'=>'index/blog/read',

Blog類定義如下:

namespace app\index\controller;

class Blog {
    public function read($id){
        return 'read:'.$id;
    }
}

路由地址中支持多級(jí)控制器,使用下面的方式進(jìn)行設(shè)置:

'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;
    }
}

還可以支持路由到動(dòng)態(tài)的模塊、控制器或者操作,例如:

// action變量的值作為操作方法傳入
':action/blog/:id' => 'index/blog/:action'
// 變量傳入index模塊的控制器和操作方法
':c/:a'=> 'index/:c/:a'

如果關(guān)閉路由功能的話,默認(rèn)也會(huì)按照該規(guī)則對(duì)URL進(jìn)行解析調(diào)度。

額外參數(shù)

在這種方式路由跳轉(zhuǎn)的時(shí)候支持額外傳入?yún)?shù)對(duì)(額外參數(shù)指的是不在URL里面的參數(shù),隱式傳入需要的操作中,有時(shí)候能夠起到一定的安全防護(hù)作用,后面我們會(huì)提到)。例如:

'blog/:id'=>'blog/read?status=1&app_id=5',

上面的路由規(guī)則定義中額外參數(shù)statusapp_id參數(shù)都是URL里面不存在的,屬于隱式傳值,當(dāng)然并不一定需要用到,只是在需要的時(shí)候可以使用。

路由到操作方法

路由地址的格式為:

@[模塊/控制器/]操作

這種方式看起來似乎和第一種是一樣的,本質(zhì)的區(qū)別是直接執(zhí)行某個(gè)控制器類的方法,而不需要去解析 模塊/控制器/操作這些,同時(shí)也不會(huì)去初始化模塊。
例如,定義如下路由后:

'blog/:id'=>'@index/blog/read',

系統(tǒng)會(huì)直接執(zhí)行

Loader::action('index/blog/read');

相當(dāng)于直接調(diào)用 \app\index\controller\blog類的read方法。

Blog類定義如下:

namespace app\index\controller;

class Blog {
    public function read($id){
        return 'read:'.$id;
    }
}

通常這種方式下面,由于沒有定義當(dāng)前模塊名、當(dāng)前控制器名和當(dāng)前方法名 ,從而導(dǎo)致視圖的默認(rèn)模板規(guī)則失效,所以這種情況下面,如果使用了視圖模板渲染,則必須傳入明確的參數(shù)。

路由到類的方法

路由地址的格式為(動(dòng)態(tài)方法):

\類的命名空間\類名@方法名

或者(靜態(tài)方法)

\類的命名空間\類名::方法名

這種方式更進(jìn)一步,可以支持執(zhí)行任何類的方法,而不僅僅是執(zhí)行控制器的操作方法,例如:

'blog/:id'=>'\app\index\service\Blog@read',

執(zhí)行的是 \app\index\service\Blog類的read方法。
也支持執(zhí)行某個(gè)靜態(tài)方法,例如:

'blog/:id'=>'\app\index\service\Blog::read',

V5.0.4+版本開始,支持傳入額外的參數(shù)作為方法的參數(shù)調(diào)用(用于參數(shù)綁定),例如:

'blog/:id'=>'\app\index\service\Blog::read?status=1',

路由到重定向地址

重定向的外部地址必須以“/”或者h(yuǎn)ttp開頭的地址。

如果路由地址以“/”或者“http”開頭則會(huì)認(rèn)為是一個(gè)重定向地址或者外部地址,例如:

'blog/:id'=>'/blog/read/id/:id'

'blog/:id'=>'blog/read'

雖然都是路由到同一個(gè)地址,但是前者采用的是301重定向的方式路由跳轉(zhuǎn),這種方式的好處是URL可以比較隨意(包括可以在URL里面?zhèn)魅敫嗟姆菢?biāo)準(zhǔn)格式的參數(shù)),而后者只是支持模塊和操作地址。舉個(gè)例子,如果我們希望avatar/123重定向到
/member/avatar/id/123_small的話,只能使用:

'avatar/:id'=>'/member/avatar/id/:id_small'

路由地址采用重定向地址的話,如果要引用動(dòng)態(tài)變量,直接使用動(dòng)態(tài)變量即可。

采用重定向到外部地址通常對(duì)網(wǎng)站改版后的URL遷移過程非常有用,例如:

'blog/:id'=>'http://blog.thinkphp.cn/read/:id'

表示當(dāng)前網(wǎng)站(可能是http://thinkphp.cn )的 blog/123地址會(huì)直接重定向到 http://blog.thinkphp.cn/read/123。

文檔最后更新時(shí)間:2018-04-25 19:29:05

文檔
目錄

深色
模式

切換
寬度