第三方类库应放 application/libraries/（CI3）或 app/Libraries/（CI4），命名需匹配文件名且首字母大写；命名空间类库须用 Composer 加载，入口文件需手动引入 vendor/autoload.php；CI3 中 $this->load->library() 第二参数非配置项，CI4 已改用服务容器。
第三方类库放哪？别往 system/ 里硬塞
CodeIgniter 不像 Laravel 那样自带自动加载机制，第三方类库不能随便丢进 application/ 就完事。最稳妥的位置是 application/libraries/，但前提是这个类库能被 CI 的 Loader 正确识别——即类名必须和文件名一致，且类名首字母大写（如 MyPdf.php 里定义 class MyPdf）。
常见错误现象：Unable to load the requested class: MyPdf，大概率是文件名、类名不匹配，或没放在 application/libraries/ 下。
- 如果类库是命名空间风格（比如
Dompdf\Dompdf），别放libraries/，改用 Composer 加载（见下一条） - 不要把整个 vendor 目录挪进
application/，CI 的 autoloader 不认 PSR-4 - 旧版 CI2 允许在
application/config/autoload.php里手动$autoload['libraries'] = array('mypdf');；CI3/4 则需显式$this->load->library('mypdf')
Composer 类库怎么用？别跳过 vendor/autoload.php
现代第三方库（如 monolog/monolog、phpmailer/phpmailer）基本都依赖 Composer。CI 本身不加载 vendor/autoload.php，你得自己补上。
使用场景：需要日志、邮件、HTTP 客户端、PDF 渲染等复杂功能时，优先走 Composer 而非手写封装。
- 在入口文件
index.php顶部（define('FCPATH', ...)之后）加一行：require_once FCPATH . 'vendor/autoload.php'; - 确保
vendor/和index.php同级（标准 Composer 结构），否则路径会错 - 类库实例化直接 new，不用
$this->load->library()；例如：$mail = new \PHPMailer\PHPMailer\PHPMailer(); - CI3 中若用 HMVC（如 wiredesignz），可能已有自动加载逻辑，此时重复 require 会报
Cannot redeclare class
$this->load->library() 的参数陷阱：第二个参数不是配置数组
很多人以为 $this->load->library('curl', ['timeout' => 30]) 能把配置传进去，其实不行。CI 的 library() 方法第二个参数只接受一个布尔值（是否启用对象别名），不是配置项。
性能影响：错误传参不会报错，但配置完全失效，导致后续调用行为异常（比如 cURL 超时仍是默认值）。
- 正确做法：配置单独传，比如先
$config = ['timeout' => 30]; $this->load->library('curl');，再在类内部读取$this->config->item('curl_timeout')或直接在构造函数里处理 - 自定义类库中，建议在
__construct()接收可选参数，或从 CI 的 config 加载（$this->load->config('curl')） - CI4 已废弃此用法，改用服务容器和依赖注入，但 CI3 项目仍大量存在这类误用
CI3 和 CI4 的关键差异：别拿 CI4 文档套 CI3
CI4 的类库加载机制和目录结构和 CI3 完全不同。如果你查的是 CI4 官方文档，照着做 CI3 项目，90% 会失败。
兼容性影响：CI3 的 application/libraries/ 在 CI4 中已移至 app/Libraries/，且必须继承 CodeIgniter\Libraries\Library，并用 services.php 注册。
- CI3：类文件放
application/libraries/MyLib.php，类名MyLib，加载用$this->load->library('mylib') - CI4：类文件放
app/Libraries/MyLib.php，类名MyLib，但需声明命名空间App\Libraries，并在app/Config/Services.php里注册别名 - 混用风险：在 CI3 项目里尝试用
new \App\Libraries\MyLib()，会触发 fatal error —— 因为 CI3 根本没有App命名空间
