CodeIgniter框架怎么实现自定义路由类_CodeIgniter框架核心文件扩展实战【实战】-php教程-PHP中文网

不能直接替换router类，因其路由逻辑硬编码在codeigniter.php中且\_set\_routing()为私有方法；必须通过application/config/routes.php配置路由规则，利用通配符或正则精确匹配uri并正确映射参数。

codeigniter框架怎么实现自定义路由类_codeigniter框架核心文件扩展实战【实战】

为什么不能直接写一个 Router 类替代原生路由

CodeIgniter 的路由逻辑深度耦合在 Router 类的 _set_routing() 方法中，且该类在 CodeIgniter.php 启动流程里被硬编码初始化。你无法通过简单替换类文件或 autoload 自定义类来接管整个路由过程——系统会在构造函数里直接调用 $this->_set_routing()，而这个方法是私有且未做接口抽象的。

常见错误现象：Class 'MY_Router' not found 或路由完全失效（仍走默认 controller/method 模式），本质是因为 CI 并不支持“替换核心类”这种扩展方式，除非你修改 system/core/CodeIgniter.php ——这违反框架升级安全原则，也破坏可维护性。

真正可行的自定义路由入口：routes.php + 伪静态 + URI 段解析

所有合法、可维护的自定义路由，都必须基于 application/config/routes.php 文件展开。CI 的路由引擎本身只做两件事：匹配 $route 数组键（URI pattern），然后重写为值（controller/method/param...）。你不需要重写类，只需写出更精准的 pattern。

$route['category/(:num)'] = 'category/index/$1'; —— 这样写才能让 /category/2 正确映射到 Category 类的 index() 方法，并把 2 作为第一个参数传入
如果控制器名是 Category（首字母大写），但 URL 是小写 /category/2，确保 $route['translate_uri_dashes'] 设为 FALSE（默认值），否则 CI 会尝试找 category 小写类，导致 404
避免把参数拼进右边值里写成 'category/index?cid=$1' —— CI 不解析 query string 形式，$1 只在路径段中生效

通配符和正则的实际区别与陷阱

(:num) 和 (:any) 看似方便，但底层是用 preg_replace 做字符串替换，不是真正则引擎匹配。这意味着：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

(:num) 实际等价于 [0-9]+，但不支持边界控制 —— /user/123abc 会被误匹配，因为 123abc 开头是数字就过了
想严格匹配纯数字 ID？必须用正则：$route['^category/([0-9]+)$'] = 'category/index/$1';，开头 ^ 和结尾 $ 很关键
正则路由优先级高于通配符，但顺序很重要 —— CI 按数组定义顺序匹配，把宽泛规则（如 (:any)）写在前面，会吞掉后面更具体的规则
$1, $2 在正则中对应捕获组，在通配符中对应第 N 个占位符，混用会出错

如何在控制器里安全获取路由参数

不要依赖 $this->uri->segment(N) 硬编码取值，尤其当路由规则变更时极易断裂。正确做法是让 CI 把参数自动注入方法签名：

比如定义 $route['product/(:num)/(:any)'] = 'catalog/view/$1/$2';，对应控制器方法应写成：

<pre class="brush:php;toolbar:false;">public function view($id, $slug)
{
    // $id 是数字，$slug 是剩余任意字符
    echo "ID: " . (int)$id . ", Slug: " . htmlspecialchars($slug);
}

注意点：

参数数量和顺序必须与 $route 右侧的 <code>$1/$2/... 完全一致，多一个少一个都会导致 call_user_func_array() 报 Warning
CI 不做类型转换，$id 是字符串，需手动 (int) 或 filter_var(..., FILTER_SANITIZE_NUMBER_INT)
如果某段可能为空（如可选参数），不要指望 $route 自动跳过 —— 必须显式写两条规则，或改用正则 + 可选组 (/([^/]+))?

最常被忽略的一点：路由重写后，原始 URI（$this->uri->uri_string()）仍是用户输入的路径，不是重写后的。调试时别把它和 $this->router->class 混淆 —— 前者是请求来源，后者才是最终生效的控制器名。