必须配置阿里云中文镜像并验证生效，否则Composer会静默回退至packagist.org导致超时；正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，输出需含type和url字段，缺一不可。
在国内网络环境下用 Composer 下载 CodeIgniter4 最新版（截至2026年7月为 v4.6.1）常因直连 packagist.org 超时失败，必须配置中文镜像并验证生效，否则命令看似运行却仍在海外源卡住。
确认 PHP 与 Composer 环境
打开终端，依次执行：
php -v → 确保输出 ≥ PHP 8.1（CI4.5+ 强制要求）
composer -V → 确保输出 ≥ Composer 2.2
若任一不满足，需先升级 PHP 或重装 Composer（推荐官网下载 phar 包后全局安装）。
检查必需扩展是否启用：
php -m | grep -E "intl|mbstring|json" → 三者必须全部在列表中，缺一将导致 CI4 启动报错 Class 'IntlDateFormatter' not found 等。
配置阿里云 Composer 中文镜像
这一步最容易出错：只改 URL 不写 type 或漏掉末尾 /，Composer 会静默回退到 packagist.org，你完全看不到提示。
执行完整命令（注意三个要素缺一不可）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
【必须验证】立即运行 composer config -g repo.packagist，输出应为：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
若输出 null、{} 或含 https://packagist.org/，说明配置失败，重跑上条命令。
项目级配置更可靠（尤其宝塔、GitHub Actions 等场景）：
进一个空文件夹 → composer init -n → composer config repo.packagist composer https://mirrors.aliyun.com/composer/
创建 CI4 最新版项目
第一步：进入目标目录，例如 D:projects 或 ~/Sites
第二步：执行安装命令（自动拉取 v4.6.1 appstarter 及全部子依赖）：
composer create-project codeigniter4/appstarter myproject --prefer-dist --no-interaction
第三步：等待完成，看到 Generating autoload files 和 Executing script codeigniter4\spark... 即成功。
⚠️ 若中途卡在 vfsstream 或 framework 下载，说明镜像未生效或缓存污染——先运行 composer clear-cache，再删掉项目目录下的 composer.lock，重试上条命令。
初始化 .env 并启用开发模式
进入 myproject 目录，执行：
copy .env.example .env（Windows）
或 cp .env.example .env（macOS/Linux）
用编辑器打开 .env，修改三处关键项：
CI_ENVIRONMENT = development
app.baseURL = "http://localhost/myproject/"（路径须与你实际访问 URL 完全一致）
database.default.hostname = "localhost"
这一步跳过会导致首页空白、500 错误却无任何提示——因为默认不显示错误、不写日志、不加载 .env 配置。
启动内置服务器验证安装
方法一（推荐）：
cd myproject → php spark serve
浏览器访问 http://localhost:8080，看到 CI4 欢迎页即成功。
方法二（指定端口）：
php spark serve --port=8000
注意：该命令必须在项目根目录运行，不能在 public/ 下；它会自动校验 .env 中的 app.baseURL，若不匹配会直接报错退出。
