ci4中不能仅靠修改$autoload['libraries']或psr-4映射使类自动挂载到$this,必须通过services工厂注册并显式调用;模型需用model()函数加载,第三方库优先用composer且避免命名空间冲突。

CI4 里不能靠改 $autoload['libraries'] 就让任意类自动挂到 $this 上,CI3 能但有路径硬约束——这是最常翻车的第一步。
CI4 中自动加载库 ≠ 自动挂载到控制器实例
CI4 的 $libraries 数组只控制哪些服务类由 Services 工厂初始化,且仅限框架内置或显式注册的服务(如 session、cache)。你往 $psr4 里加了命名空间、类文件也放对位置,只是解决了“PHP 找得到这个类”,不代表 $this->mylib 就能直接用。
- 想在控制器里写
$this->mylib->doSomething(),必须走Services注册 + 挂载逻辑,不是光有 PSR-4 就行 - 手动放进
app/Libraries/Mylib.php但没配Services.php工厂方法,调用$this->mylib会报Undefined property -
BaseController构造函数里写$this->mylib = service('mylib')是可行的,但子类若声明同名属性会覆盖父类赋值(PHP 属性不继承)
CI3 和 CI4 加第三方库的路径差异必须分清
CI3 允许把 MyTwilio.php 放进 application/libraries/,然后直接写 $autoload['libraries'] = ['mytwilio'];CI4 完全不认这个路径,它只看 $psr4 映射和 Services 注册。
- CI3:文件名必须全小写 +
.php,类名必须与文件名一致(class Mytwilio),否则$this->load->library('mytwilio')失败 - CI4:手动放
app/Libraries/Twilio.php必须加namespace AppLibraries;,并在app/Config/Autoload.php的$psr4里补['AppLibraries\' => APPPATH . 'Libraries/'](注意双反斜杠和末尾斜杠) - CI4 中调用必须用
$twilio = ConfigServices::twilio(),而不是$this->twilio—— 后者只对框架原生服务有效
模型不能塞进 autoload 配置,否则报错
很多人在 app/Config/Autoload.php 的 $libraries 或 $psr4 里加 UserModel,结果启动就抛 Class 'AppLibrariesUserModel' not found。因为 CI4 根本不从 autoload 配置里找模型,它只通过 model() 辅助函数触发 Services::model() 工厂。
- 模型类必须继承
CodeIgniterModel,否则model('UserModel')返回的对象没有find()、insert()等方法 -
app/Config/Autoload.php的$psr4只负责让 PHP 自动include类文件,不负责实例化;模型必须显式调用model()才会 new 实例并注入 DB 连接 - 在
BaseController构造函数里写$this->userModel = model('UserModel')可以,但别在子类里重复声明同名属性,否则覆盖父类已赋值对象
Composer 包优先,但别和 CI 自动加载冲突
用 composer require twilio/sdk 是最省事的方式,CI4 会自动兼容 Composer 的 autoloader —— 前提是你没在 app/Config/Autoload.php 里重复配 $psr4 映射同一命名空间。
- CI4 入口文件(
public/index.php)默认已引入vendor/autoload.php,无需额外操作 - 如果同时用了 Composer 包和手动 PSR-4 映射,确保命名空间不重叠,否则 spl_autoload_register 会按注册顺序执行,后注册的可能覆盖前者的查找逻辑
- 第三方包若含非 PSR-4 结构(如全局函数或无命名空间类),仍需手动
require_once或加进$classmap
真正麻烦的从来不是“怎么加”,而是搞不清 CI3 和 CI4 在“自动加载”这件事上根本是两套逻辑:一个靠路径约定,一个靠服务容器。混用配置、抄错路径、漏注册工厂方法,三者占其一,就卡在 Class not found 或 Undefined property 上不动弹。











