CodeIgniter自动加载类库技巧

CodeIgniter 4 的自动加载机制与 CI3 截然不同——它不再依赖路径约定和 $autoload 配置直接挂载类到控制器实例，而是严格依托 PSR-4 自动加载解决“类能否被找到”，再通过 Services 工厂注册与显式调用（如 service('mylib') 或 model('UserModel')）实现“类如何被实例化并可用”，任何混淆 CI3 的旧习惯（如修改 $autoload['libraries']、将模型塞进 autoload、忽略命名空间或工厂注册）都会导致 Class not found 或 Undefined property 等典型错误；正确做法是：第三方库优先用 Composer，自定义类须规范命名空间+PSR-4 映射+Services 注册，模型必须用 model() 函数加载且继承 CodeIgniter\Model，而 BaseController 中的挂载逻辑还需警惕子类属性覆盖问题——理清这套服务容器驱动的新逻辑，才是打通 CI4 扩展开发的关键。

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 App\Libraries;，并在 app/Config/Autoload.php 的 $psr4 里补 ['App\Libraries\\' => APPPATH . 'Libraries/']（注意双反斜杠和末尾斜杠）
• CI4 中调用必须用 $twilio = \Config\Services::twilio()，而不是 $this->twilio —— 后者只对框架原生服务有效

模型不能塞进 autoload 配置，否则报错

很多人在 app/Config/Autoload.php 的 $libraries 或 $psr4 里加 UserModel，结果启动就抛 Class 'App\Libraries\UserModel' not found。因为 CI4 根本不从 autoload 配置里找模型，它只通过 model() 辅助函数触发 Services::model() 工厂。

• 模型类必须继承 CodeIgniter\Model，否则 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 上不动弹。

本篇关于《CodeIgniter自动加载类库技巧》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！