URI 路由
一般來(lái)說(shuō),URI字符串有著和它唯一對(duì)應(yīng)的控制器(controller)類/方法。URI的各個(gè)部分是如下模式(pattern):
example.com/class/function/id/
然而在一些例子中,你也許想重定向這種關(guān)系來(lái)調(diào)用一個(gè)不同的類/方法(class/function),而不是與URL一一對(duì)應(yīng)(的調(diào)用).
例如,你可能想使你的URL采用這種原型(prototype):
example.com/product/1/
example.com/product/2/
example.com/product/3/
example.com/product/4/
一般情況下,URL的第二個(gè)部分表示方法名,不過(guò)在上面的例子中,它表示一個(gè)產(chǎn)品的ID。CodeIgniter可以實(shí)現(xiàn)這個(gè)功能,讓用戶可以重新定向(remap)URI處理程序.
設(shè)定你自己的路由規(guī)則
路由規(guī)則定義在application/config/routes.php 文件中. 在此文件中,你可以看到一個(gè)名為 $route的數(shù)組,它可以讓你定義你自己的路由規(guī)則。 定義可以用兩種方式: 通配符(wildcards) 或者 正則表達(dá)式(Regular Expressions)
通配符
一個(gè)典型的通配符路由看起來(lái)是這樣的:
$route['product/(:num)'] = "catalog/product_lookup";
在一個(gè)路由中,數(shù)組的鍵包含著被匹配的URI,而數(shù)組的值包含著路由將被重定向的目的地.在上面的例子中,如果單詞“product”出現(xiàn)在URL的第一個(gè)部分中,而且數(shù)字(:num)出現(xiàn)在URI的第二個(gè)部分中,"catalog"類和"product_lookup"方法將被替代使用(即將被重定向).
你可以匹配文字的值或者使用以下兩種通配符類型:
:num 將匹配一個(gè)只包含有數(shù)字的segment(段).
:any 將匹配任何字符(可以是多個(gè)segment段).可以匹配多個(gè)值,如:
$route['product/(:any)'] = "catalog/product_lookup/$1/$2/$3/$4/$5"; //將整條url上的每一個(gè)參數(shù)全部傳遞給catalog控制器下的 product_lookup方法。
注意: 路由將會(huì)按照定義的順序來(lái)運(yùn)行.高層的路由總是優(yōu)先于低層的路由.
例子
下面是一些簡(jiǎn)單的例子:
$route['journals'] = "blogs";
如果URL的第一個(gè)分段(類名)是關(guān)鍵字"journals",那么將會(huì)重定向到"blogs"類中處理.
$route['blog/joe'] = "blogs/users/34";
如果URL的前兩個(gè)分段是"blog"和"joe",那么將會(huì)重定向到"blogs"類的"users"方法中處理.并且將ID"34"設(shè)為參數(shù).
$route['product/(:any)'] = "catalog/product_lookup";
當(dāng)"product"作為URL中第一個(gè)分段時(shí), 無(wú)論第二分段是什么都將被重定向到"catalog"類的"product_lookup"方法.
$route['product/(:num)'] = "catalog/product_lookup_by_id/$1";
當(dāng)“product”作為 URL 中第一個(gè)分段時(shí),如果第二分段是數(shù)字,則將被重定向到“catalog”類,并傳遞所匹配的內(nèi)容到“product_lookup_by_id”方法中。
重要提示: 不要在前面或后面加"/".
正則表達(dá)式
如果你喜歡可以使用正則表達(dá)式來(lái)自定義你的路由規(guī)則. 任何有效的正則表達(dá)式都是被允許的, 甚至逆向引用.
注意: 如果你使用逆向引用請(qǐng)將雙反斜線語(yǔ)法替換為美元符語(yǔ)法(\\1 替換為 $1).
一個(gè)典型的正則表達(dá)式看起來(lái)像下面的樣子:
$route['products/([a-z]+)/(\d+)'] = "$1/id_$2";
上例中, 類似于 products/shirts/123 的URI 將換成調(diào)用 shirts 控制器類的 id_123 方法.
你也可以混合使用通配符與正則表達(dá)式.
系統(tǒng)保留的路由
系統(tǒng)會(huì)保留兩個(gè)路由:
第一個(gè)為系統(tǒng)默認(rèn)的路由:
$route['default_controller'] = 'welcome';
這個(gè)路由表明了當(dāng)URI中不包含要訪問(wèn)的類和控制器信息的(即只訪問(wèn)根目錄的情況,如http://localhost/ci)將要加載哪個(gè)控制器。上例中,系統(tǒng)將加載 "welcome" 這個(gè)類(控制器)。你應(yīng)該保證設(shè)置一個(gè)默認(rèn)路由,不然你的首頁(yè)將會(huì)顯示 404 錯(cuò)誤。
第二個(gè)為404頁(yè)面的路由:
$route['404_override'] = '';
這個(gè)路由標(biāo)識(shí)了如果請(qǐng)求的控制器無(wú)法訪問(wèn)的時(shí)候?qū)⒓虞d哪個(gè)控制器。它相當(dāng)于覆蓋了默認(rèn)的404錯(cuò)誤頁(yè)面(即提供了自己定義404頁(yè)面的功能)。但它不會(huì)影響show_404()這個(gè)方法,這個(gè)方法依然會(huì)加載默認(rèn)的位于application/errors/error_404.php的error_404.php頁(yè)面。
重要: 保留的路由應(yīng)該在所有通配符或正則表達(dá)式路由之前定義。