CI框架中引入第三方数据库类CTools需手动require_once加载，禁用CI autoload；连接时须映射配置参数、指定Unix socket路径并显式设置utf8mb4字符集，且应在方法内按需实例化并主动disconnect。
CI框架中引入第三方数据库连接类的常见报错
直接在CodeIgniter控制器里 new CTools() 会报 Class 'CTools' not found，不是类写得不对，而是CI的自动加载机制根本没管它。CI默认只扫描 application/libraries/ 和 system/libraries/，你把C++封装的 CTools 类扔进任意其他目录，它都视而不见。
更隐蔽的问题是：CTools 内部用的是MySQL C API，而CI默认用PDO或mysqli驱动——两者共存时若未显式关闭CI自己的数据库连接，可能触发 mysql_real_connect(): MySQL server has gone away 这类连接冲突。
如何让CI正确识别并加载CTools类
必须绕过CI的autoload机制，改用PHP原生方式手动引入。不要试图把它塞进 libraries/ 目录再用 $this->load->library()，CTools不是CI风格的类，没有 __construct() 接收CI实例，硬套会崩。
- 把
CTools.h和编译好的libctools.so（Linux）或ctools.dll（Windows）放在application/third_party/ctools/下 - 在控制器顶部加
require_once APPPATH . 'third_party/ctools/CTools.php'; - 调用前确认扩展已启用：
extension_loaded('ctools')，否则new CTools()会静默失败 - 避免在CI的
_construct()中初始化CTools，应在具体方法内按需实例化，防止连接泄漏
CTools连接参数与CI数据库配置的协同处理
CTools的 connect() 方法签名是 connect(const string& server, const string& user, const string& pass, const string& db)，而CI的 database.php 里是 hostname、username 等键名。不能直接传数组过去，必须手动映射。
关键点在于端口和socket路径：CI默认走TCP，CTools若要复用Unix socket（如 /var/run/mysqld/mysqld.sock），就得在server参数里填绝对路径，而不是 localhost——后者在CTools底层会被解析为TCP连接，导致权限拒绝。
- 从CI配置读取参数：
$db_config = $this->config->item('default'); - 构造CTools连接串：
$ctools = new CTools(); $ctools->connect($db_config['hostname'], $db_config['username'], $db_config['password'], $db_config['database']); - 若需socket连接，server字段必须是
/var/run/mysqld/mysqld.sock，且确保Web服务器用户有读权限
为什么不能在CI模型里封装CTools调用
CI模型默认继承 CI_Model，其生命周期绑定于请求周期，但CTools是单例设计，getInstance() 返回全局唯一实例。在模型里反复调用 new CTools() 会导致多个连接句柄堆积，mysql_close() 不被触发，最终触发MySQL的 max_connections 限制。
真正安全的做法是：在需要执行高并发查询的控制器方法里，用局部变量持有CTools实例，操作完立刻调用 disconnect()。不要依赖析构函数——PHP垃圾回收时机不可控，尤其在CLI模式下。
最易忽略的是字符集。CTools默认用 latin1，而CI通常设为 utf8mb4。必须在 connect() 后立即执行 mysql_set_character_set("utf8mb4")，否则中文插入会变问号，且这个调用不能放在CTools构造函数里——它不属于MySQL C API标准流程，得由使用者显式补上。
