MongoDB 扩展

此扩展是在 » libmongoc 和 » libbson 库之上开发的。它为核心驱动程序功能提供了最小的 API：命令、查询、写入、连接管理和 BSON 序列化。

依赖于此扩展的 PHP 用户库可能会提供更高层的 API，例如查询构建器、单个命令助手方法和 GridFS。应用程序开发人员应该考虑将此扩展与 » MongoDB PHP 库结合使用，该库实现了在 MongoDB 针对其他语言的驱动程序中找到的相同更高层 API。这种关注点的分离使扩展能够专注于扩展实现至关重要的基本功能，以实现性能。

安装/配置
教程
- 使用 PHP 库 for MongoDB (PHPLIB)
- 应用程序性能监控 (APM)
驱动程序架构和内部机制 — 解释驱动程序架构和特殊功能
- 架构 — 架构概述
- 连接 — 连接处理和持久性
- 持久化数据 — 将 PHP 变量序列化和反序列化到 MongoDB
安全
- 请求注入攻击
- 脚本注入攻击
MongoDB\Driver — MongoDB 扩展类
- MongoDB\Driver\Manager — MongoDB\Driver\Manager 类
- MongoDB\Driver\Command — MongoDB\Driver\Command 类
- MongoDB\Driver\Query — MongoDB\Driver\Query 类
- MongoDB\Driver\BulkWrite — MongoDB\Driver\BulkWrite 类
- MongoDB\Driver\Session — MongoDB\Driver\Session 类
- MongoDB\Driver\ClientEncryption — MongoDB\Driver\ClientEncryption 类
- MongoDB\Driver\ServerApi — MongoDB\Driver\ServerApi 类
- MongoDB\Driver\WriteConcern — MongoDB\Driver\WriteConcern 类
- MongoDB\Driver\ReadPreference — MongoDB\Driver\ReadPreference 类
- MongoDB\Driver\ReadConcern — MongoDB\Driver\ReadConcern 类
- MongoDB\Driver\Cursor — MongoDB\Driver\Cursor 类
- MongoDB\Driver\CursorId — MongoDB\Driver\CursorId 类
- MongoDB\Driver\CursorInterface — MongoDB\Driver\CursorInterface 接口
- MongoDB\Driver\Server — MongoDB\Driver\Server 类
- MongoDB\Driver\ServerDescription — MongoDB\Driver\ServerDescription 类
- MongoDB\Driver\TopologyDescription — MongoDB\Driver\TopologyDescription 类
- MongoDB\Driver\WriteConcernError — MongoDB\Driver\WriteConcernError 类
- MongoDB\Driver\WriteError — MongoDB\Driver\WriteError 类
- MongoDB\Driver\WriteResult — MongoDB\Driver\WriteResult 类
MongoDB\BSON — MongoDB BSON 类和函数
- 函数
- MongoDB\BSON\Document — MongoDB\BSON\Document 类
- MongoDB\BSON\PackedArray — MongoDB\BSON\PackedArray 类
- MongoDB\BSON\Iterator — MongoDB\BSON\Iterator 类
- MongoDB\BSON\Binary — MongoDB\BSON\Binary 类
- MongoDB\BSON\Decimal128 — MongoDB\BSON\Decimal128 类
- MongoDB\BSON\Javascript — MongoDB\BSON\Javascript 类
- MongoDB\BSON\MaxKey — MongoDB\BSON\MaxKey 类
- MongoDB\BSON\MinKey — MongoDB\BSON\MinKey 类
- MongoDB\BSON\ObjectId — MongoDB\BSON\ObjectId 类
- MongoDB\BSON\Regex — MongoDB\BSON\Regex 类
- MongoDB\BSON\Timestamp — MongoDB\BSON\Timestamp 类
- MongoDB\BSON\UTCDateTime — MongoDB\BSON\UTCDateTime 类
- MongoDB\BSON\Type — MongoDB\BSON\Type 接口
- MongoDB\BSON\Persistable — MongoDB\BSON\Persistable 接口
- MongoDB\BSON\Serializable — MongoDB\BSON\Serializable 接口
- MongoDB\BSON\Unserializable — MongoDB\BSON\Unserializable 接口
- MongoDB\BSON\BinaryInterface — MongoDB\BSON\BinaryInterface 接口
- MongoDB\BSON\Decimal128Interface — MongoDB\BSON\Decimal128Interface 接口
- MongoDB\BSON\JavascriptInterface — MongoDB\BSON\JavascriptInterface 接口
- MongoDB\BSON\MaxKeyInterface — MongoDB\BSON\MaxKeyInterface 接口
- MongoDB\BSON\MinKeyInterface — MongoDB\BSON\MinKeyInterface 接口
- MongoDB\BSON\ObjectIdInterface — MongoDB\BSON\ObjectIdInterface 接口
- MongoDB\BSON\RegexInterface — MongoDB\BSON\RegexInterface 接口
- MongoDB\BSON\TimestampInterface — MongoDB\BSON\TimestampInterface 接口
- MongoDB\BSON\UTCDateTimeInterface — MongoDB\BSON\UTCDateTimeInterface 接口
- MongoDB\BSON\DBPointer — MongoDB\BSON\DBPointer 类（已弃用）
- MongoDB\BSON\Int64 — MongoDB\BSON\Int64 类
- MongoDB\BSON\Symbol — MongoDB\BSON\Symbol 类（已弃用）
- MongoDB\BSON\Undefined — MongoDB\BSON\Undefined 类（已弃用）
MongoDB\Driver\Monitoring — 监控类和订阅函数
- 函数
- MongoDB\Driver\Monitoring\CommandFailedEvent — MongoDB\Driver\Monitoring\CommandFailedEvent 类
- MongoDB\Driver\Monitoring\CommandStartedEvent — MongoDB\Driver\Monitoring\CommandStartedEvent 类
- MongoDB\Driver\Monitoring\CommandSucceededEvent — MongoDB\Driver\Monitoring\CommandSucceededEvent 类
- MongoDB\Driver\Monitoring\ServerChangedEvent — MongoDB\Driver\Monitoring\ServerChangedEvent 类
- MongoDB\Driver\Monitoring\ServerClosedEvent — MongoDB\Driver\Monitoring\ServerClosedEvent 类
- MongoDB\Driver\Monitoring\ServerOpeningEvent — MongoDB\Driver\Monitoring\ServerOpeningEvent 类
- MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent — MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent 类
- MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent — MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent 类
- MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent — MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent 类
- MongoDB\Driver\Monitoring\TopologyChangedEvent — MongoDB\Driver\Monitoring\TopologyChangedEvent 类
- MongoDB\Driver\Monitoring\TopologyClosedEvent — MongoDB\Driver\Monitoring\TopologyClosedEvent 类
- MongoDB\Driver\Monitoring\TopologyOpeningEvent — MongoDB\Driver\Monitoring\TopologyOpeningEvent 类
- MongoDB\Driver\Monitoring\CommandSubscriber — MongoDB\Driver\Monitoring\CommandSubscriber 接口
- MongoDB\Driver\Monitoring\LogSubscriber — MongoDB\Driver\Monitoring\LogSubscriber 接口
- MongoDB\Driver\Monitoring\SDAMSubscriber — MongoDB\Driver\Monitoring\SDAMSubscriber 接口
- MongoDB\Driver\Monitoring\Subscriber — MongoDB\Driver\Monitoring\Subscriber 接口
MongoDB\Driver\Exception — 异常类
- MongoDB\Driver\Exception\AuthenticationException — MongoDB\Driver\Exception\AuthenticationException 类
- MongoDB\Driver\Exception\BulkWriteException — MongoDB\Driver\Exception\BulkWriteException 类
- MongoDB\Driver\Exception\CommandException — MongoDB\Driver\Exception\CommandException 类
- MongoDB\Driver\Exception\ConnectionException — MongoDB\Driver\Exception\ConnectionException 类
- MongoDB\Driver\Exception\ConnectionTimeoutException — MongoDB\Driver\Exception\ConnectionTimeoutException 类
- MongoDB\Driver\Exception\EncryptionException — MongoDB\Driver\Exception\EncryptionException 类
- MongoDB\Driver\Exception\Exception — MongoDB\Driver\Exception\Exception 接口
- MongoDB\Driver\Exception\ExecutionTimeoutException — MongoDB\Driver\Exception\ExecutionTimeoutException 类
- MongoDB\Driver\Exception\InvalidArgumentException — MongoDB\Driver\Exception\InvalidArgumentException 类
- MongoDB\Driver\Exception\LogicException — MongoDB\Driver\Exception\LogicException 类
- MongoDB\Driver\Exception\RuntimeException — MongoDB\Driver\Exception\RuntimeException 类
- MongoDB\Driver\Exception\ServerException — MongoDB\Driver\Exception\ServerException 类
- MongoDB\Driver\Exception\SSLConnectionException — MongoDB\Driver\Exception\SSLConnectionException 类（已弃用）
- MongoDB\Driver\Exception\UnexpectedValueException — MongoDB\Driver\Exception\UnexpectedValueException 类
- MongoDB\Driver\Exception\WriteException — MongoDB\Driver\Exception\WriteException 类
- 类树 — MongoDB 异常类树

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献注释 3 个注释

向上

向下

n dot vandermeij at mycademy dot com ¶

7 年前

*** 仅适用于版本 >= 1.2.0 ***

如果您遇到以下错误

"PHP Warning: PHP Startup: Unable to load dynamic library '/usr/lib64/php/modules/mongodb.so'
- /usr/lib64/php/modules/mongodb.so: undefined symbol: php_json_serializable_ce in Unknown on line 0"

有关详细说明，请访问

https://derickrethans.nl/undefined-symbol.html

TLDR：您需要在 json.so 之后加载 mongodb.so 扩展
扩展

特别感谢 Derick Rethans 指出这一点！

向上

向下

mike at eastghost dot com ¶

7 年前

有一个适配器 - 因此旧的 MongoClient / MongoDB 代码将在新的 PHP7/Mongo 混乱中运行

https://github.com/alcaeus/mongo-php-adapter

向上

向下

mike at eastghost dot com ¶

6 年前

PHP '用户空间' / 高级驱动程序就在这里 -- [url]https://github.com/mongodb/mongo-php-driver[/url]

在新的驱动程序中，这些将失败

(A) $count = $collection->find( $criteria )->count();

(B1) $cursor = $collection->find( $criteria );
(B2) $count = $cursor->count();

在新的驱动程序中，结果计数已成为一个独立的操作，应用于集合，而不是游标

$count = $collection->count( $criteria );
$cursor = $collection->find( $criteria );

来自 jmikola 2016 年 1 月 6 日 ([url]https://github.com/mongodb/mongo-php-driver/issues/195 在这里[/url])

"在新的驱动程序中，Cursor 对象现在表示执行的命令或查询的实际结果，而在旧的驱动程序中，游标具有双重性质（执行前或执行后）。旧的 MongoCursor::count() 方法实际上使用相同的条件调用了一个计数命令；但是，这意味着计数命令的计算可能与实际查询结果不同，因为它们不一定在相同的结果数据上操作。

"用户空间库在集合上实现了一个 count() 方法，它也接受过滤器条件，我们更希望鼓励这样做，以便用户了解这些操作是分开的。如果我们最终在用户空间库中使 Cursor 可计数，我们将使用 iterator_count() 在结果上提供精确的计数；但是，这还需要我们缓存结果，以便用户可以重新卷起游标并再次迭代（最近在 PHPLIB-81 中讨论了这一点）。虽然旧的驱动程序在重新卷起时会重新执行查询，但这也不是新的驱动程序中 Cursor 的性质所允许的。

"我知道这可能看起来很不方便，但我相信显式 API 终究是比旧的驱动程序向前迈进了一步，在旧的驱动程序中，许多用户可能不知道幕后到底发生了什么。如果您有任何其他问题，请随时跟进。

＋添加注释