CodeIgniter安装问题怎么解决

CodeIgniter 4 的安装看似简单，实则暗藏诸多“踩坑点”：90% 的安装失败源于误用 git clone 或手动下载替代官方推荐的 `composer create-project codeigniter4/appstarter` 命令，导致缺失 public/、writable/ 目录、.env 配置及关键 Composer 脚本，进而引发 spark 不可用、MigrationRunner 找不到、首页 403/空白页等连锁问题；而权限配置（尤其 SELinux 环境）、环境变量设置（CI_ENVIRONMENT 必须为 development）、Web 服务器根目录指向 public/ 以及本地开发服务器必须通过 public/router.php 启动等细节，更是决定项目能否真正跑起来的关键。掌握这些核心规范，才能避开 CI4 入门第一道高墙。

CodeIgniter 安装失败，90% 是因为没走对入口——不是直接 composer install 就完事，而是得用官方推荐的创建命令，否则缺核心引导文件、public 目录结构错乱、甚至 index.php 根本不在正确位置。

为什么 composer create-project 不能换成 git clone 或手动下载？

CI4 的项目骨架（appstarter）和框架内核（framework）是分离的，create-project 会自动拉取并组装好完整可运行结构；而手动下载或 clone 往往只拿到源码仓库，缺少 public/、writable/ 等关键目录，也缺失 .env 和预设路由。更隐蔽的问题是：某些 Composer 脚本（如 post-create-project-cmd）不会触发，导致 spark 命令不可用。

• ✅ 正确做法：composer create-project codeigniter4/appstarter myproject
• ❌ 错误做法：git clone https://github.com/codeigniter4/framework.git 后自己拼目录
• ⚠️ 注意：myproject 是新目录名，别在已有 CI 项目里重复执行，会覆盖 vendor/

php spark migrate 报错 “Class 'MigrationRunner' not found” 怎么办？

这是典型的环境未就绪信号：不是迁移脚本本身出错，而是 CI4 的核心服务容器还没加载成功，通常因 public/index.php 没被 Web 服务器正确指向，或 .env 中 CI_ENVIRONMENT 被误设为 production 导致自动禁用开发组件。

• 检查 .env 文件第一行是否为：CI_ENVIRONMENT = development
• 确认 Web 服务器 DocumentRoot 指向的是 myproject/public/，不是项目根目录
• 运行前先试 php spark —— 如果连命令列表都打不开，说明 autoloader 或 bootstrap 失败，别急着跑 migrate

安装后访问首页显示 403 或空白页，但无错误日志

大概率是 writable/ 目录权限或 SELinux 限制所致。CI4 运行时需写入 writable/cache/、writable/logs/、writable/session/，Apache/Nginx 用户必须有写权限；而 Linux 发行版（尤其 CentOS/RHEL）默认启用 SELinux，会拦截 PHP 写入行为，此时 chmod 777 都无效。

• 先验证权限：ls -ld writable/ → 应显示 drwxr-xr-x 或更宽松；再试 sudo -u www-data touch writable/test.txt（Ubuntu）或 sudo -u apache touch writable/test.txt（CentOS）
• 若报 Permission denied，且 sestatus 返回 enabled，则临时关闭测试：sudo setenforce 0
• 生产环境不要关 SELinux，改用：sudo semanage fcontext -a -t httpd_sys_rw_content_t "myproject/writable(/.*)?"，再 restorecon -Rv myproject/writable/

最常被忽略的一点：CI4 不再允许通过项目根目录直接访问，index.php 必须经由 public/ 入口。哪怕你本地用 php -S localhost:8080，也得指定路由脚本：php -S localhost:8080 public/router.php，否则所有请求都会绕过框架初始化逻辑。

好了，本文到此结束，带大家了解了《CodeIgniter安装问题怎么解决》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！