CodeIgniter安装问题解决技巧

CodeIgniter 4 在 Windows + XAMPP 环境中频繁报错、白屏或 404？问题往往不出在代码本身，而是隐藏在 PHP 版本不达标（必须 ≥7.4，且需警惕 PHP 8.0 的严格模式陷阱）、Apache 重写模块未启用、.htaccess 配置失当（尤其是 RewriteBase 路径与项目子目录不匹配）、以及跨平台时 vendor/autoload.php 路径大小写敏感等关键兼容性细节中——掌握这些实操要点，才能真正让 CI4 稳定启动、URL 去掉 index.php 正常访问，并为后续 Linux 部署扫清隐患。

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 前不能有 #
• 确认 区块中包含 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 上全会失效。

理论要掌握，实操不能落！以上关于《CodeIgniter安装问题解决技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！