必须同步修改三处:apache启用mod_rewrite并设allowoverride all、.htaccess规则严格匹配ci版本(ci3用index.php?/$1,ci4用index.php/$1且置于public目录)、config.php中$config['index_page'] = ''及uri_protocol/base_url等关联配置正确;缺一即导致首页正常而其他路由404。

CodeIgniter 隐藏 index.php 不是改一个配置就能搞定的事,新手常以为只改 $config['index_page'] = '' 就完事,结果首页能打开、点链接全 404——其实背后有三处必须同步对齐,缺一不可。
Apache 必须启用 mod_rewrite 并放行 .htaccess
很多新手在本地用 XAMPP/WAMP,却没意识到 Apache 默认禁用重写模块和目录覆盖权限:
- 检查
httpd.conf中是否启用了LoadModule rewrite_module modules/mod_rewrite.so(取消注释) - 确认网站目录的
<directory></directory>块里有AllowOverride All,不能是None或FileInfo - Ubuntu/Debian 用户可直接运行
a2enmod rewrite+systemctl restart apache2
.htaccess 规则要严格匹配 CI 版本
CI3 和 CI4 的 URL 解析机制不同,规则混用必出问题:
-
CI3 默认走 QUERY_STRING 模式,规则末尾必须带问号:
RewriteRule ^(.*)$ index.php?/$1 [L] -
CI4 默认走 PATH_INFO 模式,规则末尾不能加问号:
RewriteRule ^(.*)$ index.php/$1 [L] - 务必用
<ifmodule mod_rewrite.c></ifmodule>包裹整段规则,否则模块未启用时规则静默失效,毫无提示 - CI4 的 .htaccess 在
public/目录下,不是项目根目录——放错位置等于没配
config.php 里光清空 index_page 远远不够
只设 $config['index_page'] = '' 是起点,但 URI 解析和资源路径还依赖另外两个关键项:
-
$config['uri_protocol']建议保持'AUTO';若强制设为'PATH_INFO',需确认服务器支持且 PHP-FPM 没截断该变量(Nginx 环境常见失败) -
$config['base_url']必须显式填写完整地址,例如'https://example.com/myapp/',避免依赖 $_SERVER 动态生成出错 - CI4 已不读取此配置中的 base_url,应改在
public/index.php或.env中设置APP_URL,沿用 CI3 习惯会丢样式和 JS
CI4 路由必须手动定义,没有“自动映射”
新手从 CI3 切换到 CI4 最容易卡在这步:以为访问 /home 就会自动调用 Home::index(),其实 CI4 默认关闭自动路由:
- 打开
app/Config/Routes.php,必须显式添加:$routes->get('/home', 'Home::index'); - 注意大小写:控制器类名首字母大写(
Home),方法名小写(index) - Web 根目录必须指向
public/,不是项目根目录;指向错会导致 404 或暴露 application/ 安全风险











