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'(如后台模块)
带参数的动态路由
用冒号加名称定义可变段,支持正则约束:
立即学习“PHP免费学习笔记(深入)”;
Route::set('article', 'article/(/)', array('id' => '\d+'))
->defaults(array(
'controller' => 'article',
'action' => 'view'
));
匹配 /article/123 或 /article/123/my-post,其中 必须为数字, 是可选段。
系统介绍:YIXUNCMS中专专版是易迅软件工作室在中秋节来临之即推出的专题模板建站系统,使用增强版后台管控系统,板板设计符合节日特点。易迅软件工作室恭祝全国人民中秋快乐。特别提示:由于网站页面的不同设计,部分后台功能未在前端进行体现。系统特点:1、采用目前流行的PHP语言编写,底层采用超轻量级框架作为系统支撑;2、页面布局使用DIV+CSS技术,遵循WEB标准,及大提高页面的浏览速度;3、使用应
-
和会作为参数传入 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/dashboard→Controller_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')再测试。










