CodeIgniter框架怎么自定义路由规则？正则路由写法实战指南

在CodeIgniter框架中，路由是决定用户请求URL由哪个控制器和方法处理的核心机制。默认情况下框架会根据URL段自动映射，但在实际项目中我们往往需要将美观的链接、REST风格接口或旧系统兼容地址映射到内部逻辑。自定义路由通过修改application/config/routes.php文件中的$route数组来完成，框架在启动时会加载该配置并按顺序逐条匹配，第一条命中的规则即生效。

理解路由的匹配顺序非常关键。很多初学者把宽泛规则写在前面，导致具体规则永远无法触发。CodeIgniter并不会选择“最合适”的规则，而是采用“最先匹配”策略。因此通配型路由应当尽量后置，精确路径应当前置。此外，路由键名支持字符串字面量和正则占位符，值通常为“控制器/方法”或带反向引用的表达式。

基础自定义路由与正则占位符定义

最基础的自定义路由是直接写死URL片段到控制器的映射。例如将“about”指向“site/about”方法，这样用户访问ippipp.com/about时实际执行的是Site控制器的about函数。这种方式适合固定页面，但不具备参数提取能力。当我们需要从URL中拿到动态片段时，就要借助框架内置或自定义的正则占位符。

CodeIgniter默认提供(:any)和(:num)两种占位符，分别匹配任意字符和数字。若需更严格约束，可在routes.php中用$route['placeholder']定义自己的正则。例如定义(:slug)为[a-z0-9-]+，之后在路由规则里使用(:slug)即可只接受小写字母、数字与连字符。下面代码演示了基础写法与自定义占位符：

<?php
// application/config/routes.php

// 定义自定义正则占位符
$route['placeholder'] = [
    'slug' => '[a-z0-9-]+',
    'year' => 'd{4}'
];

// 精确路由放前面
$route['about'] = 'site/about';
$route['news/(:slug)'] = 'news/show/$1';
$route['archive/(:year)'] = 'news/archive/$1';

// 宽泛路由放最后
$route['(:any)'] = 'errors/show_404';

上述配置中，news/hello-world会命中第二条规则并调用news控制器的show方法，传入参数hello-world。若将(:any)规则移到最前，则所有请求都会被错误页拦截。自定义占位符的本质是框架在解析路由时把键名替换成对应正则表达式，再整体交由正则引擎匹配，因此占位符名不能包含特殊正则字符。

正则路由的高级写法与反向引用

除了使用占位符，CodeIgniter也允许在路由键中直接写完整正则表达式，但需用括号捕获并在值中使用$d语法反向引用。不过官方更推荐占位符方式以保证可读性。当路由值中包含多个参数时，按捕获顺序使用$1、$2引用。例如将“product/123/blue”映射到“catalog/item/id/123/color/blue”，可写为：

<?php
$route['product/(:num)/(:any)'] = 'catalog/item/id/$1/color/$2';

// 直接使用正则的写法（不推荐但可行）
$route['user/([0-9]+)/post/([0-9]+)'] = 'user/post/$1/$2';

在实际接口开发中，正则路由常用于版本化API。比如将api/v1/users/42映射到apiv1/users/profile/42，既隐藏了内部目录结构，也方便后续版本迭代。要注意的是，反向引用编号必须和捕获组严格对应，多写或少写都会导致参数错位。若某段可选，可用正则问号修饰符，但CI2及早期版本对可选段支持较弱，建议拆成两条规则。

另一个易错点是在正则中忘记转义斜杠或引号。由于PHP字符串里反斜杠本身需要转义，写d时要写成\d，或在单引号字符串中写d。上面示例使用了单引号，因此d可直接书写。如果混用双引号，则必须写成\d，否则会被PHP解释为转义字符而报错。

路由冲突排查与性能优化建议

当发现某些链接返回404或错误控制器时，第一步应打印当前$route数组并核对顺序。CodeIgniter没有提供内置路由调试页，但可以在routes.php末尾临时写日志：log_message('debug', print_r($route, TRUE));。通过比对请求URL与规则列表，通常能发现是被前面的(:any)或(:num)提前捕获。

性能方面，路由文件会在每次请求加载并编译为正则。规则条数在几十条内影响极小，但若做成数百条动态生成路由，就会拉长引导时间。建议将高频精确路由前置，把正则规则控制在必要范围；对于真正任意路径的后台，直接用控制器内逻辑分发而非堆砌路由。此外，开启缓存后路由配置不会重复解析，可进一步降低开销。

最后要注意环境区分。在application/config/development/routes.php与production/routes.php中可放置不同规则，比如开发环境开放调试路由，生产环境将其指向404。这样既能本地排错，又避免敏感入口暴露。掌握这些自定义与正则技巧后，CodeIgniter的URL设计就能既优雅又安全。

CodeIgniter路由规则正则路由修改时间：2026-08-15 14:09:34