php怎么操作mongodb_mongodb扩展基本用法【教程】-php教程-PHP中文网

php操作mongodb必须使用官方mongodb扩展（非废弃的mongo扩展），通过mongodb\client连接，基于bson文档进行增删改查，连接惰性触发，需注意objectid、datetime等类型正确使用及字段类型严格性。

php怎么操作mongodb_mongodb扩展基本用法【教程】

PHP 操作 MongoDB 不再用 mongo 扩展（已废弃），必须用 mongodb 扩展（官方维护，基于 libmongoc）。它不提供传统“连接-查询-关闭”式 API，而是以面向对象 + BSON 文档为核心，直接对接现代 MongoDB 协议（4.0+）。

运行 php -m | grep mongodb，有输出说明扩展已加载；若报错或无输出，需手动安装：

Linux（pecl）：pecl install mongodb，然后在 php.ini 中加 extension=mongodb.so
macOS（Homebrew + php）：pecl install mongodb，检查 php --ini 显示的配置路径是否包含该扩展
Windows：从 pecl.php.net 下载对应 PHP 版本和线程安全（TS/NTS）的 php_mongodb.dll，放入 ext/ 并在 php.ini 中添加 extension=php_mongodb.dll
验证是否生效：php -r "var_dump(extension_loaded('mongodb'));" 应返回 bool(true)

MongoDB\Driver\Manager 是底层连接管理器，但日常操作推荐用官方高阶库 mongodb/mongodb（Composer 安装），它封装了 Manager、Collection 和 BSON 类型处理：

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

下载

连接示例：

$client = new MongoDB\Client('mongodb://127.0.0.1:27017');
$collection = $client->selectDatabase('test')->selectCollection('users');

注意：连接字符串中不能省略 mongodb:// 前缀；本地默认端口是 27017，非 27018 或其他
连接本身不触发网络请求（lazy connect），首次操作（如 find()）才真正建连；超时、认证失败等错误会在首次操作时抛出 MongoDB\Driver\Exception\ConnectionTimeoutException 等

所有操作都基于 BSON 文档（PHP 数组或 MongoDB\BSON\ObjectId 等类型），不接受 JSON 字符串直接传入：

插入单条：$collection->insertOne(['name' => 'Alice', 'age' => 30])，返回 InsertOneResult，可用 getInsertedId() 获取 _id

查询全部：$collection->find([]) 返回 Cursor，需遍历：

foreach ($collection->find(['age' => ['$gt' => 25]]) as $doc) {
    echo $doc['name'] . "\n";
}

更新单条：$collection->updateOne(['name' => 'Alice'], ['$set' => ['age' => 31]])；注意第二个参数必须是操作符（如 $set、$inc），不能直接传数组
查询条件中用 MongoDB\BSON\ObjectId 匹配 _id：['_id' => new MongoDB\BSON\ObjectId('60a1b2c3d4e5f67890123456')]，字符串 ID 不能直接当数组键用

这些错误高频出现，且原因隐蔽：

Uncaught MongoDB\Driver\Exception\RuntimeException: No servers found：连接字符串格式错（比如漏了 mongodb://）、MongoDB 进程没启、防火墙拦截、或 DNS 解析失败（尤其用 localhost 时建议换 127.0.0.1）
Cannot use object of type MongoDB\BSON\ObjectId as array：把 ObjectId 当数组访问了，正确取值是 $id->__toString()
插入后查不到：未指定 _id 时驱动自动生成 ObjectId，但如果你用字符串 ID 插入（如 ['_id' => 'abc']），后续用 new ObjectId('abc') 查不到——因为不是同类型
日期存成字符串而非 DateTimeInterface：用 new DateTime() 而不是 date('Y-m-d')，否则 MongoDB 当普通字符串存，无法做时间范围查询