必须用composer创建codeigniter 4.7.3项目，先确认php≥8.1、composer≥2.2，再配置阿里云镜像，执行create-project命令生成项目，最后修改.env启用开发环境并运行php spark serve。
要在本地快速启动一个基于 CodeIgniter 4.7.3 的 PHP 开发环境，必须避开官网已下线的 ZIP 包下载渠道，改用 Composer 创建项目——这是 CI4 官方唯一支持、能自动生成自动加载器和依赖关系的安装方式，手动复制文件或解压 zip 会导致 Class not found 或路由失效。
确认运行环境是否达标
打开终端，依次执行以下命令：
php -v → 查看输出是否为 PHP 8.1 或更高版本；低于该版本将无法加载核心类库。
composer -V → 确认 Composer 版本 ≥ 2.2；若提示 command not found，请先安装 Composer 并加入系统 PATH。
这一步跳过会导致后续 create-project 命令直接报错退出，且错误信息不明确。
配置国内 Composer 镜像（必做）
方法一：全局配置（推荐用于单用户开发机）
运行：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：命令中 repo.packagist 不能写成 repos.packagist，末尾斜杠 / 也不能省略，否则镜像静默失效。
验证是否生效：执行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
方法二：项目级配置（适用于宝塔、CI/CD 或多用户服务器）
新建空目录 → 进入该目录 → 执行 composer init -n → 再执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/。
创建 CodeIgniter 4.7.3 项目
第一步：执行创建命令
composer create-project codeigniter4/appstarter myapp --prefer-dist --no-interaction
其中 myapp 可替换为你想要的项目名；--prefer-dist 强制使用压缩包而非 Git 克隆，提速明显；--no-interaction 跳过所有交互式提问。
第二步：等待完成
命令会自动拉取 appstarter 模板、安装 codeigniter4/framework 及全部子依赖（如 kint-php/kint、mikey179/vfsstream）、生成 vendor/autoload.php，并尝试运行迁移（若模板含 migration 文件）。
第三步：检查结果
进入 myapp/ 目录，确认存在 .env.example、app/、public/、vendor/ 四个关键目录；vendor/codeigniter4/framework 下应有 system/ 和 spark 文件。
启用开发环境并启动服务
将 .env.example 复制为 .env（注意是隐藏文件，Linux/macOS 下用 cp .env.example .env）。
编辑 .env 文件，修改三处关键配置：
CI_ENVIRONMENT = development → 启用错误显示和调试日志，不改则页面空白无提示。
app.baseURL = "http://localhost/myapp/" → 根据你实际访问路径填写，末尾必须带斜杠；若用虚拟主机或 MAMP/XAMPP，此处需对应 DocumentRoot 路径。
database.default.hostname = "localhost" → 即使暂不连库也必须填值，留空会导致启动时抛出异常。
保存后，在项目根目录执行：php spark serve。
浏览器访问 http://localhost:8080，看到绿色 “Welcome to CodeIgniter4” 页面即表示成功。
