CodeIgniter框架路由规则怎么写_CodeIgniter框架URL重写设置方法【详解】

CodeIgniter框架路由规则怎么写_CodeIgniter框架URL重写设置方法【详解】

想让CodeIgniter的URL去掉那个碍眼的index.php？这事儿说简单也简单，说麻烦也麻烦。核心就一句话：Web服务器重写、框架路由配置、浏览器缓存清理，这三者必须同时到位，缺一不可。 下面咱们就来拆解几个最常见的坑。

为什么改了 $config['index_page'] = '' 还是跳转到 index.php？

先别急着怀疑自己的路由写错了。问题很可能出在更底层——Web服务器的重写模块根本没生效。CodeIgniter的“友好URL”机制，本质是依赖服务器（如Apache或Nginx）把所有的请求都转发给index.php这个入口文件，然后框架才开始解析你写的路由规则。如果浏览器地址栏里依然带着index.php，那基本可以断定，请求压根就没交到CI手里。

要解决这个问题，必须确保下面三个条件同时满足：

• mod_rewrite模块已启用：在phpinfo()输出的Loaded Modules里找找，有没有rewrite_module。
• Apache配置允许覆盖：对应你项目目录的配置里，AllowOverride必须设为All（None或FileInfo都不行）。
• .htaccess文件放对了地方：CI3版本要放在项目根目录（和index.php同级），而CI4版本必须放在public/目录下。

很多人容易产生一个错觉：“我把.htaccess文件扔进去不就完事了？”其实不然。如果Apache不读取、不执行这个文件，请求就不会被转发，后面你写的所有路由配置都等于白忙活。另外，浏览器缓存旧的302跳转记录也会“伪装”出问题，所以测试时务必使用隐身窗口。

$route 规则里哪些写法会失效？

CI的路由匹配机制是“顺序优先”和“字符串前缀匹配”，并不是很多人以为的“正则全量匹配”。这就导致了一些看似合理的写法，实际上永远不会被触发：

• $route['catalog/product/(:any)'] = 'catalog/view/$1'; —— 如果规则缺少结尾的/或$，它可能会被后面更宽泛的规则意外“吞掉”。
• $route['backend/user/profile/(:num)/'] = 'backend/user/profile/$1'; —— 这里有个细节：假如实际访问的URL是/backend/user/profile/204/disabled，而你的规则只匹配到/204/，那么后半部分的/disabled就会被丢弃，很可能导致404。
• 在路由键（key）里直接使用空格、中文、点号等未转义字符（例如$route['关于我们'] = 'home/about';）。这可能导致Apache直接返回400错误，请求根本到不了CI框架。
• 试图用$route去匹配带查询参数的URL（比如search?keyword=cat）。这是个误区，CI的路由系统不处理$_GET参数，那是控制器内部该做的事。

安全起见，推荐的写法是：使用纯ASCII字符，配合(:any)或(:num)这类占位符，并且务必确保规则指向的控制器和方法真实存在且可访问。

CI3 和 CI4 的 .htaccess 能混用吗？

绝对不能。 CI4的入口文件位置变了，在public/index.php，而CI3还在根目录的index.php。如果混用，会导致$_SERVER['SCRIPT_NAME']等服务器变量解析错误，整个路由系统都会失效，表现就是所有页面都报500错误或者一片空白。

来看看两个版本的标准配置：

CI3 标准规则（放在项目根目录）：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

CI4 标准规则（放在 public/ 目录）：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

关键区别其实不在文件内容本身，而在于文件放置的位置和服务器上下文。对于CI4，如果把.htaccess放错了目录，或者你移动了public/index.php的位置但没有同步修改重写规则，那么404就是必然结果。

想让 /about 映射到 pages/view/about，但 URL 后缀怎么加？

URL后缀（比如.html）是全局配置，不是由单条路由规则控制的。当你设置了$config['url_suffix'] = '.html'之后，所有通过site_url()生成的链接都会自动带上.html。但反过来，路由在匹配时，也必须识别带后缀的URL才能命中。

所以，正确的操作需要两步：

• 在application/config/config.php中设置：$config['url_suffix'] = '.html';
• 在application/config/routes.php中，路由规则必须显式写出后缀：$route['about.html'] = 'pages/view/about';

如果只做第一步而忘了第二步，用户访问/about.html就会得到404；而访问/about则会走默认路由，可能跳到首页或报错。这个细节常常被忽略，很多人以为后缀只是个“显示效果”，其实它从头到尾都参与路由的解析过程。