thinkphp5.1.41需手动集成mongodb：先安装php mongodb扩展并验证加载，再通过composer引入think-mongo 2.0.x驱动，配置database.php中type为\think\mongo\connection及连接参数，即可使用db类或模型操作mongodb。

ThinkPHP5.1.41 本身不内置 MongoDB 支持，需手动集成官方推荐的扩展和驱动。关键不是“安装后自动支持”，而是补全两层依赖：PHP 底层扩展 + ThinkPHP 适配驱动。

装好 PHP 的 mongodb 扩展（必须）

这是最底层通信能力，没有它，任何 PHP 框架都连不上 MongoDB。

• 确认 PHP 版本 ≥ 7.2（推荐 7.4 或 8.0+），MongoDB 服务 ≥ 3.6
• 用 PECL 安装（Linux/macOS）：pecl install mongodb；Windows 则去 PECL 页面 下载对应线程安全（TS）或非线程安全（NTS）的 php_mongodb.dll
• 在 php.ini 中添加：extension=mongodb.so（Linux/macOS）或 extension=php_mongodb.dll（Windows）
• 重启 Web 服务（如 Apache/Nginx + PHP-FPM），运行 php -m | grep mongodb 或 phpinfo() 验证是否加载成功

引入 ThinkPHP 的 MongoDB 驱动包

TP5.1.41 对应的是 think-mongo 的 2.0.x 版本，不是 1.*。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 执行命令：composer require topthink/think-mongo=2.0.*
• 注意：若项目已锁定 TP5.1.41，不要升级到 TP6，否则该驱动不兼容

配置 database.php 连接参数

修改 config/database.php，新增或替换 MongoDB 连接配置：

• 把 'type' 改为：'type' => '\think\mongo\Connection'
• 补充必要字段：'hostname' => '127.0.0.1'、'hostport' => '27017'、'database' => 'your_db_name'，用户名密码按需填写
• 如需将 MongoDB 默认的 _id 自动映射为 id 字段，加配置：'pk_convert_id' => true

开始使用 Db 类或模型

配置生效后，即可像操作 MySQL 一样调用：

• 查单条：Db::name('users')->where('name', '张三')->find()
• 模糊匹配（用 BSON Regex）：$regex = new \MongoDB\BSON\Regex('关键词', 'i'); Db::name('posts')->where('title', $regex)->select()
• 模型方式：定义 User 模型继承 \think\Model，再设置 protected $connection = '\think\mongo\Connection';

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！