ginkgo


路由规则

路由规则是一个多维数组,可以包含多条规则,路由规则定义是从根目录开始,而不是基于模块名的。根目录是基于项目部署位置的 PATH_INFO,如:

  • http://server/index.php/ 是一个根目录
  • http://server/project/index.php/ 也是一个根目录

规则的定义以 / 为参数分割符(无论的 PATH_INFO 分隔符设置是什么,请确保在定义路由规则表达式的时候统一使用 / 进行 URL 参数分割)。以下是一些例子:

'route' => array(
    'route_rule'    => array( //路由规则
        //静态例子 规则 => 地址
        'index/article/index' => 'index/article/show', 

        //动态例子 array(规则, 地址)
        array('article/:year/:month/:id', 'index/article/index'), 

        //正则例子 array(规则, 地址, 参数)
        array('/^cate[\/\S+]+\/(\d+)+\S*$/i', 'index/cate/index', 'id'), 

        ... // 更多规则
    ),
),

静态规则

静态规则为一个 键名 => 键值 方式表达的数组,如:

'route_rule' => array( // 路由规则
    'article/show' => 'index/article/show', // 规则 => 地址
    ... // 更多规则
),
  • 访问 http://server/index.php/article/show

    会自动路由到 http://server/index.php/index/article/show

  • 系统会忽略规则外的 URL 部分,还是以上述规则为例,访问 http://server/index.php/article/show/test

    会自动路由到 http://server/index.php/index/article/show


动态规则

动态规则为一个 array(规则, 地址) 方式表达的数组,如:

'route_rule' => array( // 路由规则
    array('article/:year/:month/:id', 'index/article/index') // array(规则, 地址)
    ... // 更多规则
),
  • 访问 http://server/index.php/article/2015/06/234325

    会自动路由到 http://server/index.php/index/article/show/year/2015/month/06/id/234325

  • 系统会忽略规则外的 URL 部分,还是以上述规则为例,访问 http://server/index.php/article/2015/06/234325/status/public

    会自动路由到 http://server/index.php/index/article/show/year/2015/month/06/id/234325/status/public

每个参数中以 : 开头的参数都表示动态变量,并且会自动绑定到动作的对应参数。


正则规则

正则规则为一个 array(规则, 地址, 参数) 方式表达的数组,其中 参数 可以为数组或者字符串,系统会根据正则规则匹配到的结果,自动绑定到动作的对应参数,如:

'route_rule' => array( // 路由规则
    array('/^cate[\/\S+]+\/(\d+)+\S*$/i', 'index/cate/index', 'id') // array(正则规则, 地址, 参数)
    ... // 更多规则
),
  • 访问 http://server/index.php/cate/234325

    会自动路由到 http://server/index.php/index/cate/index/id/234325

  • 系统会忽略规则外的 URL 部分,还是以上述规则为例,访问 http://server/index.php/cate/234325/status/public

    会自动路由到 http://server/index.php/index/cate/index/id/234325/status/public

'route_rule' => array( // 路由规则
    array('/^cate[\/\x{4e00}-\x{9fa5}a-zA-Z0-9\_\-]+\/id\/(\d+)+(\/page\/(\d+))?.*$/ui', 'index/cate/index', array('id', '', 'page')), //正则例子 array(规则, 地址, 参数)
    ... // 更多规则
),
  • 访问 http://server/index.php/cate/news/art/id/234325/page/2

    会自动路由到 http://server/index.php/index/cate/index/id/234325/page/2

  • 系统会忽略规则外的 URL 部分,还是以上述规则为例,访问 http://server/index.php/cate/news/art/id/234325/page/2/status/public

    会自动路由到 http://server/index.php/index/cate/index/id/234325/page/2/status/public


特别注意

根据 概况 -> 开发规范 的要求,方法的命名使用驼峰法(首字母小写),但是路由都使用小写,并且系统会强制转换 URL 请求,因此 ginkgo 采用了一种自动转换的策略,当路由中的动作命名为小写字母和下划线或横杠时,系统会将动作自动转换为驼峰法(首字母小写)。

如果当前访问的地址是

http://server/index.php/index/index/hello-world

http://server/index.php/index/index/hello_world

控制器类定义如下:

namespace app\ctrl\index;

class Index {
    public function helloWorld() {
        return 'hello_world';
    }
}