php kohana框架设置路由

Kohana路由通过Route::set()在bootstrap.php中定义,支持静态路径、动态参数、正则约束及模块化路径;需注意路由顺序从上到下匹配,具体规则应优先定义,避免被通配路由拦截,调试时可查看所有路由并清空缓存确保生效。

在 Kohana 框架中设置路由,核心是通过 application/classes/Route.php 或更常见的是在 application/bootstrap.php 文件中调用 Route::set() 来定义规则。Kohana 的路由系统基于正则匹配和参数捕获,灵活且语义清晰。

基础路由写法(匹配静态路径)

最简单的路由将 URL 映射到指定控制器和动作:

Route::set('login', 'login')
    ->defaults(array(
        'controller' => 'auth',
        'action'     => 'login'
    ));

访问 /login 就会执行 Auth_Controller::login() 方法。

  • 第一个参数 'login' 是路由名(用于生成 URL 时引用,如 URL::site(Route::get('login')->uri())
  • 第二个参数 'login' 是匹配的 URI 模式(不带开头斜杠)
  • defaults() 指定默认的控制器、动作,也可加 'directory'(如后台模块)

带参数的动态路由

用冒号加名称定义可变段,支持正则约束:

Route::set('article', 'article/(/)', array('id' => '\d+'))
    ->defaults(array(
        'controller' => 'article',
      <img src="//public-space.oss-cn-hongkong.aliyucs.com/keji/190.jpg" />  'action'     => 'view'
    ));</pre>
</font>
<p>匹配 <code>/article/123</code> 或 <code>/article/123/my-post</code>,其中 <code><id></id></code> 必须为数字,<code><title> 是可选段。

  • 会作为参数传入 action,例如 public function action_view($id, $title = NULL)
  • 括号包裹的部分表示可选;正则约束写在第三个参数数组里,键对应占位符名
  • 未约束的参数默认等价于 '[^/]+(非斜杠任意字符)

模块化与命名空间路由(Kohana 3.3+)

若使用模块(如 admin),可在路由中指定 directory,或配合命名空间自动解析:

Route::set('admin_dashboard', 'admin/dashboard')
    ->defaults(array(
        'directory'  => 'admin',
        'controller' => 'dashboard',
        'action'     => 'index'
    ));

这会让框架去 application/classes/Controller/Admin/Dashboard.php(或模块路径)中找类。

  • Kohana 自动将下划线或短横线转为驼峰/目录结构,如 admin/dashboardController_Admin_Dashboard
  • 确保类文件路径与命名空间一致,否则抛出 ClassNotFoundException
  • 模块路由建议统一前缀(如 admin/*),便于权限或中间件统一拦截

路由优先级与顺序很重要

Kohana 按定义顺序从上到下匹配,**越具体的路由越要靠前**,否则可能被泛用路由截胡:

// ✅ 正确:先定义精确路由
Route::set('api_user', 'api/user/', array('id' => '\d+'))
    ->defaults(array('controller' => 'api', 'action' => 'user'));

// ❌ 错误:放在这后面会被下面的通配路由吞掉
Route::set('default', '((/(/)))')
    ->defaults(array('controller' => 'welcome', 'action' => 'index'));
  • 内置的 default 路由通常放在最后,作为兜底
  • 调试时可用 var_dump(Route::all()) 查看当前所有已注册路由
  • 开发阶段建议开启 Kohana::init(['errors' => TRUE]),路由不匹配时会明确报错

基本上就这些。Kohana 路由不复杂但容易忽略顺序和正则细节,写完记得清缓存(APPPATH.'cache')再测试。