composer create-project 仅支持 CI4(如 codeigniter4/appstarter),CI3 不支持——因其未按 Composer 标准组织 autoload.php 和目录结构,强行使用会导致 Class 'CodeIgniter\CodeIgniter' not found 错误。

composer create-project 能直接装 CI4,但别用它装 CI3
CodeIgniter 4 官方支持 composer create-project,CI3 不支持——它压根没把 autoload.php 和核心目录结构按 Composer 标准组织。强行用这个命令拉 CI3,结果是 vendor 里空有框架包,index.php 找不到 CodeIgniter 类,报错 Class 'CodeIgniter\CodeIgniter' not found。
实操建议:
- 装 CI4:运行
composer create-project codeigniter4/appstarter myapp,完成后进myapp目录跑php spark serve - 装 CI3:别走 Composer 创建项目流程,直接下载 ZIP 或用
git clone https://github.com/bcit-ci/CodeIgniter.git,再手动把application/和system/放到 Web 根目录 - 如果项目已依赖其他包、又想把 CI3 当“库”引入(不推荐),得手动在
composer.json里加"bcit-ci/codeigniter": "3.1.13",再写自己的加载逻辑——但 CI3 的BASEPATH和APPPATH是硬编码路径,和 Composer 自动加载天然冲突
require codeigniter4/framework 时要注意版本与命名空间
CI4 的正式包名是 codeigniter4/framework,不是 codeigniter/framework 或 ci4/framework。装错就只能看到 Package not found。
常见错误现象:
- 执行
composer require codeigniter/framework→ 报错Could not find package codeigniter/framework - 装了
codeigniter4/framework但没配自动加载规则,new CodeIgniter\HTTP\Request()仍报类不存在
实操建议:
- 明确运行:
composer require codeigniter4/framework:^4.5(建议锁小版本,CI4 大版本间有 BC break) - 确认
vendor/autoload.php已被入口文件引入;CI4 的类全走 PSR-4,命名空间严格对应CodeIgniter\开头 - 不要删
app/目录下默认的Config/、Controllers/等——它们不是示例,而是框架运行必需的配置骨架
CI3 项目想用 Composer 加包?可以,但别动 system/
很多老 CI3 项目只是借 Composer 装第三方 SDK(比如 aws/aws-sdk-php 或 monolog/monolog),这完全可行。问题出在有人试图用 Composer 替换掉 system/ 目录,结果路由崩、钩子失效、$this->load->library() 全挂。
原因很简单:CI3 的加载器(Loader)是基于物理路径拼接的,不走 PSR-4,也不读 vendor/composer/autoload_psr4.php。
实操建议:
- 在 CI3 根目录运行
composer init初始化,然后composer require monolog/monolog,包会装进vendor/ - 在
application/config/autoload.php里保持原样,不要删$autoload['libraries'] = array(); - 需要在控制器里用 Monolog,就手动 require:
require_once APPPATH . '../vendor/autoload.php'; $logger = new \Monolog\Logger('name'); - 绝对不要删
system/,也别改index.php里的require_once BASEPATH.'core/CodeIgniter.php';路径
Windows 下 composer install 慢或超时?关掉 xdebug
composer install 卡在 Installing dependencies 或直接报 Connection timed out,八成是 xdebug 在作祟——它会让 Composer 的 HTTP 请求和 autoloader 扫描慢几倍,尤其在 Windows + WAMP/XAMPP 环境下。
验证方式:终端运行 php -m | findstr xdebug,有输出就说明开着。
实操建议:
- 临时关闭:编辑
php.ini,找到zend_extension=php_xdebug.dll这行,前面加;注释掉,然后重启 Web 服务 - 不想动全局配置?用命令行指定配置:
php -d zend_extension= -d extension=php_openssl.dll composer install - CI4 项目如果用了
spark命令,也建议关 xdebug——否则php spark migrate可能卡住或报Allowed memory size exhausted
vendor/autoload.php 能自动载入 system/ 下的类,其实它根本不会碰那个目录。









