The DoYouHaoBaby PHP Framework中文开发文档手册
Copyright(c) DoYouHaoBaby.NET All Rights Reserved.
URL路由

DyhbFrame支持URL路由功能,要启用路由功能,需要设置URL_ROUTER_ON 参数为true。开启路由功能后,系统会自动进行路由检测,如果在路由定义里面找到和当前URL匹配的路由名称,就会进行路由解析和重定向。路由功能需要定义路由定义文件,位于项目的配置目录下面,文件名为Route.php,定义格式:

return array(

// 第一种方式 常规路由

'RouteName'=>array('模块名称', '操作名称', '参数定义', '额外参数'),

// 第二种方式 泛路由

'RouteName@'=>array

array('路由匹配正则', '模块名称', '操作名称', '参数定义', '额外参数'),

),

…更多的路由名称定义

)

系统在执行Router解析的时候,会判断当前URL是否存在定义的路由名称,如果有就会按照定义的路由规则来进行URL解析。例如,我们启用了路由功能,并且定义了下面的一个路由规则: 

'blog'=>array('blog', 'archive', 'year,month,day', 'userid=1&status=1')

那么我们在执行

http://<serverName>/appName/blog/2009/10/1/ 的时候就会实际执行blog模块的archive操作,后面的参数/2009/10/1/ 就会依次按照 year/month/day 来解析,并且会隐含传入userId=1和status=1 两个参数。

另外一种路由参数的传入是

http://<serverName>/appName/?r=blog&year=2009&month=10&day=1,会执行上面相同的路由解析,该方式主要是提供不支持PATHINFO方式下面的兼容实现。其中r由VAR_ROUTER参数定义,默认是r。

如果需要路由到分组模块的话,可以定义成

'blog'=>array('Home.blog', 'archive', 'year,month,day', 'userId=1&status=1')

就可以指定路由到Home分组的Blog模块。

 

泛路由支持

泛路由指的是对同一个路由名称提供了多个规则的支持,使得URL的设置更加灵活,例如,我们对Blog路由名称需要有多个规则的路由:

 'Blog@'=array(

  array('/^/(d+)(/p/d)?$/','blog','read','id'),

  array('/^/(d+)/(d+)/','blog','archive','year,month'),

  ),

第一个路由规则表示解析 blog/123 这样的URL到Blog模块的read操作

第二个路由规则表示解析 blog/2009/10 这样的URL到Blog模块的archive操作

泛路由的定义难度就在路由正则的定义上面,其它参数和常规路由的使用一致。

 

举个简单路由的例子,如果我们有一个City模块,而我们希望能够通过类似下面这样的URL地址来访问具体某个城市的操作:

http://<serverName>/index.php/city/shanghai/

shanghai这个操作方法是不存在的,我们给相关的城市操作定义了一个city方法,如下:

 

 

 


Class CityControl extends Control{   


public function city(){   


// 读取城市名称   


$cityName = $_GET['name'];   


Echo ('当前城市: '.$cityName);   


}   


} 

 


接下来我们来定义路由文件,实现类似于

http://<serverName>/index.php/city/shanghai/

这样的解析,路由文件名称是

 

 

 


return array(   


'City'=>array('city', 'city', 'name');   


); 

 


这样,URL里面所有的City模块都会被路由到city模块的city操作,而后面的第二个参数会被解析成 $_GET['name']

接下来,我们就可以在浏览器里面输入

http://<serverName>/index.php/city/beijing/

http://<serverName>/index.php/city/shanghai/

http://<serverName>/index.php/city/shenzhen/

会看到依次输出的结果是:

当前城市:beijing

当前城市:shanghai

当前城市:shenzhen