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