ThinkPHP配置MongoDB数据库：NoSQL连接驱动安装与基础CURD操作-ThinkPHP-PHP中文网

thinkphp各版本mongodb集成方案不同：tp3需旧mongo扩展及修补mongomodel，tp5用jenssegers/mongodb封装并正确注册服务，tp6须绕过框架直调原生扩展；务必注意_id类型、日期格式、uri编码及游标处理。

thinkphp配置mongodb数据库：nosql连接驱动安装与基础curd操作

ThinkPHP 不能直接用原生 new MongoDB\Client()，必须走适配器层；TP5/6 和 TP3 的 MongoDB 集成路径完全不同，混用会报 Class 'MongoModel' not found 或 Call to undefined method —— 这是绝大多数人卡住的第一步。

确认 TP 版本与对应驱动方案

TP3.x（如 3.2.2）自带 MongoModel 类，但存在严重 bug（比如 _id 类型处理错误、不兼容新版 mongodb 扩展），必须手动修补或弃用；TP5/6 完全不兼容该类，官方已移除。别再找 mongoModel.class.php 改了，它和当前 mongodb 扩展根本不通信。

TP3.x：只能用旧版 mongo 扩展（已废弃，pecl install mongo），配合修补后的 MongoModel；但该扩展 PHP 7.2+ 已彻底不支持，2026 年不应再用
TP5：必须用 jenssegers/mongodb + mongodb 扩展，通过 Laravel-style 的 Eloquent 封装操作集合
TP6：原生不支持 MongoDB，需自行封装 think-mongo 或直接调用 mongodb 扩展的 Manager/Collection，绕过框架 DB 层

TP5 中正确安装 jenssegers/mongodb 驱动

很多人执行 composer require jenssegers/mongodb 后，配置完 database.php 却提示 Driver [mongo] not supported，根本原因是没注册服务提供者或类型映射没生效。

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

确保已安装 mongodb 扩展（不是 mongo），运行 php -m | grep mongodb 有输出才有效
TP5 默认不自动加载第三方数据库类型，需在 app/provider.php 中追加：Jenssegers\Mongodb\MongodbServiceProvider::class
config/database.php 中的 'type' => 'mongodb'（注意是 mongodb，不是 mongo），且 'default' 必须设为该键名
连接 URI 中密码含 @ 或 / 时，必须用 rawurlencode() 处理，否则 parse_url() 解析失败静默降级为本地连接

TP5 模型中写 find() / insertOne() 时的 BSON 类型陷阱

TP5 用 jenssegers/mongodb 封装后，看似能直接传 PHP 数组，但时间、ObjectId、嵌套文档仍需显式构造，否则查不到、存错、索引失效。

_id 字段插入时若传字符串（如 '_id' => '507f1f77bcf86cd799439011'），底层不会自动转为 ObjectId，后续 where('_id', $id) 查不到 —— 必须用 new \MongoDB\BSON\ObjectId($id)
日期字段不能传 time() 或 Carbon::now()，得转成毫秒级 UTCDateTime：new \MongoDB\BSON\UTCDateTime(strtotime('2025-01-01') * 1000)
find() 返回的是 Cursor 对象，不是数组；直接 foreach 可遍历，但若想取全部结果必须调 toArray()，否则游标未消费完会持续占内存
聚合查询（aggregate）不走模型方法，得用 Db::name('collection')->raw()->aggregate([...])，且管道操作符（如 $match）必须用字符串键名，不能用 PHP 常量

TP6 中绕过框架直接用原生 mongodb 扩展

TP6 官方无 MongoDB 支持，强行塞 jenssegers/mongodb 会因容器绑定冲突报错。最稳的方式是放弃 Db 门面，直接用扩展原生 API，但要注意连接复用和作用域泄漏。

不要每次请求都 new Manager，应在 app/common.php 或服务类中单例缓存：static $manager = null; if (!$manager) $manager = new \MongoDB\Driver\Manager('mongodb://...');
获取 collection 时，必须指定 database 名和 collection 名：$collection = (new \MongoDB\Client())->selectCollection('mydb', 'users');
事务仅在 replica set 或 sharded cluster 上可用，单机 mongod 不支持 startSession()，调用即抛 MongoDBDriverException\UnsupportedException
批量写入用 insertMany() 而非循环 insertOne()，否则网络往返开销剧增；但注意默认最大文档数限制是 1000，超量需分片