composer安装CodeIgniter4教程_新版CI框架的依赖引入【方法】

composer 安装 CodeIgniter 4 必须用 create-project 初始化项目，因 CI4 是应用骨架而非可 require 的库；直接 require framework 会因缺失 app、public、writable 等目录导致启动失败。

Composer 安装 CodeIgniter 4 不是“下载 ZIP 解压”那种流程，而是必须通过 composer create-project 初始化项目——直接 composer require codeigniter4/framework 会失败，因为 CI4 不是一个可单独 require 的库，而是一个完整应用骨架。

为什么不能用 composer require codeigniter4/framework

CI4 的设计强制要求应用结构与框架解耦：入口文件 public/index.php、配置目录 app/Config/、自动加载规则都依赖项目根目录下的固定布局。仅引入 codeigniter4/framework 包，缺少 app、public、writable 等关键目录，index.php 会报 class 'CodeIgniterCodeIgniter' not found 或找不到 APPPATH 常量。

• codeigniter4/framework 是纯框架内核，不带应用模板，也不含 autoload.php 和启动逻辑
• 官方推荐且唯一支持的初始化方式是 create-project，它会拉取 codeigniter4/appstarter（含完整目录结构）
• 如果你已有项目想集成 CI4，不是“引入”，而是“迁移”——需重构成 CI4 目录规范，不能硬塞进旧结构

正确安装命令与最小必要参数

运行以下命令生成可立即运行的 CI4 项目：

composer create-project codeigniter4/appstarter myproject

其中：

• myproject 是项目目录名，会自动创建并初始化 git（如果系统有 git）
• 不加版本约束时，默认拉取最新稳定版（如 v4.5.0）；如需指定版本，加 @v4.4.0 后缀
• 若网络慢或超时，可加 --prefer-dist --no-interaction 加速并跳过交互
• 国内用户建议提前配置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

安装后必须检查的三件事

项目生成后别急着 php spark serve，先确认以下三项是否就位：

• writable/ 目录权限：Web 服务器用户（如 www-data、_www）必须有读写权限，否则日志、缓存、session 全部失败
• app/Config/App.php 中的 $baseURL 必须设为实际访问地址（如 'http://localhost:8080/'），否则 csrf、重定向、资产链接全错
• 执行 php spark list 应正常输出所有可用命令；若报 Class 'CodeIgniterCLICommands' not found，说明 vendor/autoload.php 没被正确加载，大概率是 index.php 路径引用出错或 composer install 被中断

CI4 的“安装”本质是骨架初始化，不是传统意义上的依赖引入。漏掉 writable 权限或 $baseURL 配置，哪怕代码一行没改，也会在请求阶段静默失败——这些点没有报错提示，但功能就是不工作，最容易卡住新手。