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/<id>(/<title>)', array('id' => 'd+')) ->defaults(array( 'controller' => 'article', 'action' => 'view' ));
匹配 /article/123 或 /article/123/my-post,其中 <id></id> 必须为数字,<title></title> 是可选段。
快捷旅店管理系统(含洗浴)本程序声明为我帮助好友编写的,由于时间紧迫所以使用了一些其他程序人员设计的框架和打印控件,所以,本系统请不要使用到商业用途!打印控件:为VB目录下的install_lodop.rar作者:被脱脂的狼作者微博:http://weibo.com/2070210691作者小店:http://8thcenter.taobao.com使用语言:asp系统配置:windows xp
0 -
<id></id>和<title></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/dashboard→Controller_Admin_Dashboard - 确保类文件路径与命名空间一致,否则抛出
ClassNotFoundException - 模块路由建议统一前缀(如
admin/*),便于权限或中间件统一拦截
路由优先级与顺序很重要
Kohana 按定义顺序从上到下匹配,**越具体的路由越要靠前**,否则可能被泛用路由截胡:
// ✅ 正确:先定义精确路由 Route::set('api_user', 'api/user/<id>', array('id' => 'd+')) ->defaults(array('controller' => 'api', 'action' => 'user')); // ❌ 错误:放在这后面会被下面的通配路由吞掉 Route::set('default', '(<controller>(/<action>(/<id>)))') ->defaults(array('controller' => 'welcome', 'action' => 'index'));
- 内置的
default路由通常放在最后,作为兜底 - 调试时可用
var_dump(Route::all())查看当前所有已注册路由 - 开发阶段建议开启
Kohana::init(['errors' => TRUE]),路由不匹配时会明确报错
基本上就这些。Kohana 路由不复杂但容易忽略顺序和正则细节,写完记得清缓存(APPPATH.'cache')再测试。