CodeIgniter连接MongoDB教程详解

本文深入解析了CodeIgniter 3.x连接MongoDB的完整实践路径，直击开发者最常踩的五大坑：PHP官方mongodb扩展的正确安装与环境校验（尤其区分CLI与Web配置）、第三方库codeigniter-mongodb-library的规范集成（命名、路径、类名大小写等细节不容出错）、URI驱动式配置的可靠性优势及TLS远程连接要点、开启db_debug和错误抑制开关以暴露静默失败根源，以及aggregate聚合操作中极易忽略的二维数组结构、$前缀语法和字段引用规范；全文聚焦可落地的硬核技巧，帮你绕过90%的连接异常、空结果和方法未定义问题，真正实现稳定、可调试、易维护的CI-MongoDB集成。

确认 PHP 的 mongodb 扩展已正确加载

不装对扩展，后面所有配置都白搭。CI 连不上 MongoDB，80% 是卡在这步。

先运行 php -m | grep mongodb，看输出里有没有 mongodb（注意不是 mongo，那是旧版废弃扩展）。没有就说明没装成功。

• PHP 7.0+ 必须用官方 mongodb 扩展（PECL 包名也是 mongodb），mongo 扩展在 PHP 7.1+ 已彻底移除
• Windows 下确认 php_mongodb.dll 放在 ext/ 目录，且 php.ini 里写的是 extension=php_mongodb.dll（不是 extension=mongodb）
• Linux/macOS 编译安装后，检查 extension=mongodb.so 是否在 php.ini 中启用，且路径无拼写错误
• 改完 php.ini 一定要重启 Web 服务（Apache/Nginx + PHP-FPM），仅重启 Apache 不等于重启 PHP

如果 php -m 有但 CI 仍报 Class 'MongoDB\Driver\Manager' not found，大概率是 CLI 和 Web 使用了不同 php.ini —— 用 phpinfo() 页面确认 Web 环境实际加载的配置文件路径。

用官方推荐的 mongo_db 库而非直接 new Client

CI 3.x 没有原生 MongoDB 支持，必须靠第三方库桥接。别自己封装 MongoDB\Client，容易绕进连接复用、错误处理、配置隔离这些坑里。

用社区维护较久、CI 3.4 兼容性验证过的 codeigniter-mongodb-library（GitHub 上 star 数千的那个）最稳。

• 下载后把 application/config/mongo_db.php 放到项目对应路径，**不要改文件名**，CI 加载机制依赖这个命名
• application/libraries/Mongo_db.php 必须首字母大写，且类名是 Mongo_db（下划线），否则自动加载失败
• 配置项里 ['hostname'] 填完整 URI 更可靠，比如 mongodb://user:pass@127.0.0.1:27017，比拆成 host/port/user/password 更少出错
• 如果连远程 MongoDB（如 Atlas），务必开启 TLS：在 URI 后加 ?tls=true&tlsAllowInvalidCertificates=true（测试环境），生产环境用真实 CA

加载时用 $this->load->library('mongo_db', ['activate' => 'default']);，参数数组里的 activate 必须和 config 文件中配置组键名一致，默认是 default。

避免 $this->mongo_db->get() 返回空数组却无报错

这是最常被忽略的静默失败：查询语法没错，也没抛异常，但 get() 就是返回空数组，查日志也看不到问题。

根本原因通常是连接未真正建立，或数据库/集合名拼写错误，而库默认关闭了连接异常提示。

• 打开 application/config/mongo_db.php 中的 ['db_debug'] = TRUE，它会让底层驱动抛出原始连接错误（比如认证失败、DNS 解析失败）
• 若仍无声无息，在配置里加 ['mongo_supress_connect_error'] = FALSE（部分老版本库支持），强制暴露连接层报错
• get('users') 中的 users 是 collection 名，不是数据库名；数据库名由配置里的 ['database'] 决定，别混淆
• 执行前加一句 var_dump($this->mongo_db->db);，如果输出 null，说明初始化失败，99% 是配置路径、类名或扩展没到位

聚合操作（aggregate）必须传二维数组，不能直接传 pipeline 字符串

想用 $sum、$group 等高级功能？mongo_db->aggregate() 接口对参数格式很敏感，错一个括号就返回空或报致命错误。

正确写法是把整个 pipeline 当作 PHP 关联数组传入，每一步是一个子数组：

$pipeline = [
    ['$match' => ['status' => 'active']],
    ['$group' => ['_id' => '$category', 'total' => ['$sum' => '$amount']]]
];
$result = $this->mongo_db->aggregate('orders', $pipeline);

• 每个 stage（如 $match、$group）必须是独立数组元素，不能合并成一个大数组
• key 名必须带 $ 前缀（'$sum'，不是 'sum'），MongoDB 驱动不识别无前缀写法
• 字段引用（如 '$amount'）也要带 $，否则当成字面量字符串处理
• 如果报 Call to undefined method Mongo_db::aggregate()，说明你用的库版本太老，需升级到支持 aggregate 的分支（GitHub 上搜 “ci-mongodb-aggregate”）

复杂聚合建议先在 MongoDB Shell 或 Compass 里调通 pipeline，再原样转成 PHP 数组结构 —— 别在 PHP 里边试边猜。

本篇关于《CodeIgniter连接MongoDB教程详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！