codeigniter 4 在 windows+xampp 上无法运行的首要原因是 php 版本低于 7.4,需通过 phpinfo() 确认并升级 xampp 或手动更新 php;其次需启用 apache 的 mod_rewrite 模块、配置 allowoverride all、正确设置 .htaccess 中的 rewritebase,并注意跨平台时 vendor/autoload.php 路径大小写问题。

CodeIgniter 4 在 Windows + XAMPP 上跑不起来?先看 PHP 版本匹配
CodeIgniter 4 官方明确要求 PHP 7.4+,但 XAMPP 默认附带的 PHP 版本常滞后(如旧版 XAMPP 用 PHP 7.2 或 7.3)。你在 phpinfo() 里看到 PHP 版本低于 7.4,就别急着调路由或 .htaccess——框架压根没被正确加载。
- 检查方式:访问
http://localhost/dashboard/phpinfo.php,搜索PHP Version - 升级路径:要么换新版 XAMPP(推荐 ApacheFriends 官网下载 8.2+ 版本),要么手动替换 XAMPP 的
php/目录(风险高,新手慎选) - 注意:CI4 不兼容 PHP 8.0 的某些严格模式报错(如未声明返回类型),若用 PHP 8.0,请确认已启用
error_reporting并关闭display_errors避免白屏
.htaccess 无效导致 403 / 404?Apache 模块和 DocumentRoot 权限要一起查
在 XAMPP 中放好 CI4 项目后,访问首页报 403 Forbidden 或直接跳转到 XAMPP 主页,大概率不是代码问题,而是 Apache 没把你的项目当 Web 根目录处理。
- 确认
httpd.conf已启用重写模块:LoadModule rewrite_module modules/mod_rewrite.so前不能有# - 确认
<directory></directory>区块中包含AllowOverride All(不是None) - CI4 项目别直接丢进
htdocs,建议建子目录如htdocs/myapp,然后在myapp/.htaccess里保留默认内容(含RewriteBase /myapp/) - Windows 下路径大小写不敏感,但
AllowOverride若写成all(小写)可能被忽略——必须是All
URL 去掉 index.php 后 404?别只改 config.php
很多人改了 $config['index_page'] = '' 就以为完事,结果所有链接全 404。根本原因是 CI4 的路由机制依赖 Apache 的 mod_rewrite 正确解析请求路径,而 XAMPP 默认没开这个能力,或规则没生效。
- 确保
public/.htaccess文件存在且内容完整(CI4 的入口文件在public/index.php,不是根目录) - 若你把整个 CI4 项目放在
htdocs/myapp,则public/.htaccess中的RewriteBase必须设为/myapp/public/ - 临时验证法:直接访问
http://localhost/myapp/public/index.php/home能打开,说明框架本身 OK;再试http://localhost/myapp/home报 404,就是 .htaccess 或 Apache 配置问题
Linux 和 Windows 开发环境行为不一致?vendor/autoload.php 路径大小写是隐形雷区
CI4 重度依赖 Composer 自动加载,而 Windows 文件系统不区分大小写,Linux 则严格区分。你在 Windows 上测试通过的 require APPPATH.'vendor/autoload.php';,到 Linux 上可能因路径中字母大小写不符直接报 Fatal error: require(): Failed opening required。
- 统一用小写路径常量:
APPPATH是大写的,但拼接时不要混用Vendor、autoload等大小写变体 - 检查
composer.json中的autoload配置是否含大小写错误(如"psr-4": {"App\": "app/"}中app/必须全小写) - CI4 的
public/index.php第一行是require __DIR__.'/../vendor/autoload.php';—— 这个相对路径最安全,别改成绝对路径或混用斜杠方向
composer install --no-dev,而不是直接复制 vendor 文件夹。Windows 写的符号链接、缓存文件名大小写,在 Linux 上全会失效。










