如何在CodeIgniter 4项目中正确使用Composer？（框架集成指南）

Composer 是 CodeIgniter 4 的核心运行基础，项目必须通过 composer create-project 初始化，依赖自动加载严格遵循 composer.json 配置，第三方包直接 require 即可使用，升级需区分框架与依赖，部署应使用 --no-dev 和 --optimize-autoloader。

在 CodeIgniter 4 中，Composer 不只是安装依赖的工具，它本身就是框架运行的基础——CI4 本身即通过 Composer 管理核心组件、自动加载和扩展包。正确使用 Composer，关键在于理解它与 CI4 生命周期的深度集成，而非当作外部插件来“对接”。

初始化项目时必须用 Composer 创建

CI4 官方不再提供完整 ZIP 包下载，所有正规项目都应通过 Composer 初始化：

• 新建项目：运行 composer create-project codeigniter4/appstarter myproject，这会拉取官方应用骨架，并自动安装 CI4 核心（codeigniter4/framework）及依赖（如 psr/log、symfony/polyfill 等）
• 不要手动复制 vendor 或 framework 目录：CI4 的 autoloader 严格依赖 composer.json 中的 autoload 配置（如 "psr-4": { "App\": "app/", "CodeIgniter\": "vendor/codeigniter4/framework/" }），手动生成会破坏命名空间映射
• 生成后务必运行 php spark serve 验证，确保自动加载和路由正常

添加第三方包要走标准 require 流程

CI4 对 Composer 包完全兼容，但需注意路径与配置协同：

• 例如安装 league/csv：执行 composer require league/csv，Composer 自动写入 composer.json 并更新 vendor/autoload.php
• 在控制器或服务中直接使用：$csv = LeagueCsvReader::createFromPath('/path/to/file.csv');，无需额外引入——PSR-4 自动识别
• 若包含自定义命令（如 spark 子命令），需在 app/Config/Boot/development.php 或 production.php 中确认 require_once SYSTEMPATH . 'Commands/... 已启用（多数现代包已通过 codeigniter4/legacy-compat 或原生支持）

更新与维护要区分框架与应用逻辑

CI4 版本升级不能简单 composer update 全局更新，否则可能破坏兼容性：

标签： php js json composer app 工具 csv 路由