CodeIgniter 用户指南 版本 2.0.0

PHP100中文网
查看原文

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['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 方法.

你也可以混合使用通配符与正则表达式.

系统预留的路由(我理解为系统默认的路由--IT不倒翁)Reserved Routes

There are two reserved routes:

这里有个预留的路由:(???)

$route['default_controller'] = 'welcome';

这个路由表明了当 URI 中不包含任何数据时默认加载哪个控制器,也就是当别人加载你的根目录时的情况。上例中,系统将加载 "welcome" 这个类(控制器)。你应该总是保证设置一个默认路由,不然你的首页将会默认显示 404 错误。

重要: 在所有通配符或正则表达式路由之前使用保留的路由。

Important: The reserved routes must come before any wildcard or regular expression routes.

翻译贡献者: architectcom, caincheung, chouqiuqiu, Hex, nardo, shnwqshnwq
最后修改: 2011-01-31 19:08:39