MongoDB driver

This extension is developed atop the » libmongoc and » libbson libraries. It provides a minimal API for core driver functionality: commands, queries, writes, connection management, and BSON serialization.

Userland PHP libraries that depend on this extension may provide higher level APIs, such as query builders, individual command helper methods, and GridFS. Application developers should consider using this extension in conjunction with the » MongoDB PHP library, which implements the same higher level APIs found in MongoDB drivers for other languages. This separation of concerns allows the driver to focus on essential features for which an extension implementation is paramount for performance.

安装／配置
Tutorials
- Using the PHP Library for MongoDB (PHPLIB)
- Application Performance Monitoring (APM)
Driver Architecture and Internals — Explains the driver architecture, and special features
- Architecture — Architecture Overview
- Connections — Connection handling and persistence
- Persisting Data — Serialization and deserialization of PHP variables into MongoDB
Security
- Request Injection Attacks
- Script Injection Attacks
MongoDB\Driver — MongoDB 驱动类
- MongoDB\Driver\Manager — The MongoDB\Driver\Manager class
- MongoDB\Driver\Command — The MongoDB\Driver\Command class
- MongoDB\Driver\Query — The MongoDB\Driver\Query class
- MongoDB\Driver\BulkWrite — The MongoDB\Driver\BulkWrite class
- MongoDB\Driver\WriteConcern — The MongoDB\Driver\WriteConcern class
- MongoDB\Driver\ReadPreference — The MongoDB\Driver\ReadPreference class
- MongoDB\Driver\ReadConcern — The MongoDB\Driver\ReadConcern class
- MongoDB\Driver\Cursor — The MongoDB\Driver\Cursor class
- MongoDB\Driver\CursorId — The MongoDB\Driver\CursorId class
- MongoDB\Driver\Server — The MongoDB\Driver\Server class
- MongoDB\Driver\WriteConcernError — The MongoDB\Driver\WriteConcernError class
- MongoDB\Driver\WriteError — The MongoDB\Driver\WriteError class
- MongoDB\Driver\WriteResult — The MongoDB\Driver\WriteResult class
MongoDB\BSON — BSON type classes and serialization functions
- 函数
- MongoDB\BSON\Binary — The MongoDB\BSON\Binary class
- MongoDB\BSON\Decimal128 — The MongoDB\BSON\Decimal128 class
- MongoDB\BSON\Javascript — The MongoDB\BSON\Javascript class
- MongoDB\BSON\MaxKey — The MongoDB\BSON\MaxKey class
- MongoDB\BSON\MinKey — The MongoDB\BSON\MinKey class
- MongoDB\BSON\ObjectId — The MongoDB\BSON\ObjectId class
- MongoDB\BSON\Regex — The MongoDB\BSON\Regex class
- MongoDB\BSON\Timestamp — The MongoDB\BSON\Timestamp class
- MongoDB\BSON\UTCDateTime — The MongoDB\BSON\UTCDateTime class
- MongoDB\BSON\Type — The MongoDB\BSON\Type interface
- MongoDB\BSON\Persistable — The MongoDB\BSON\Persistable interface
- MongoDB\BSON\Serializable — The MongoDB\BSON\Serializable interface
- MongoDB\BSON\Unserializable — The MongoDB\BSON\Unserializable interface
- MongoDB\BSON\BinaryInterface — The MongoDB\BSON\BinaryInterface interface
- MongoDB\BSON\Decimal128Interface — The MongoDB\BSON\Decimal128Interface interface
- MongoDB\BSON\JavascriptInterface — The MongoDB\BSON\JavascriptInterface interface
- MongoDB\BSON\MaxKeyInterface — The MongoDB\BSON\MaxKeyInterface interface
- MongoDB\BSON\MinKeyInterface — The MongoDB\BSON\MinKeyInterface interface
- MongoDB\BSON\ObjectIdInterface — The MongoDB\BSON\ObjectIdInterface interface
- MongoDB\BSON\RegexInterface — The MongoDB\BSON\RegexInterface interface
- MongoDB\BSON\TimestampInterface — The MongoDB\BSON\TimestampInterface interface
- MongoDB\BSON\UTCDateTimeInterface — The MongoDB\BSON\UTCDateTimeInterface interface
- MongoDB\BSON\DBPointer — The MongoDB\BSON\DBPointer class (deprecated)
- MongoDB\BSON\Int64 — The MongoDB\BSON\Int64 class
- MongoDB\BSON\Symbol — The MongoDB\BSON\Symbol class (deprecated)
- MongoDB\BSON\Undefined — The MongoDB\BSON\Undefined class (deprecated)
MongoDB\Driver\Monitoring — Monitoring classes and subscriber functions
- 函数
- MongoDB\Driver\Monitoring\CommandFailedEvent — The MongoDB\Driver\Monitoring\CommandFailedEvent class
- MongoDB\Driver\Monitoring\CommandStartedEvent — The MongoDB\Driver\Monitoring\CommandStartedEvent class
- MongoDB\Driver\Monitoring\CommandSucceededEvent — The MongoDB\Driver\Monitoring\CommandSucceededEvent class
- MongoDB\Driver\Monitoring\ServerChangedEvent — The MongoDB\Driver\Monitoring\ServerChangedEvent class
- MongoDB\Driver\Monitoring\ServerClosedEvent — The MongoDB\Driver\Monitoring\ServerClosedEvent class
- MongoDB\Driver\Monitoring\ServerOpeningEvent — The MongoDB\Driver\Monitoring\ServerOpeningEvent class
- MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent — The MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent class
- MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent — The MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent class
- MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent — The MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent class
- MongoDB\Driver\Monitoring\TopologyChangedEvent — The MongoDB\Driver\Monitoring\TopologyChangedEvent class
- MongoDB\Driver\Monitoring\TopologyClosedEvent — The MongoDB\Driver\Monitoring\TopologyClosedEvent class
- MongoDB\Driver\Monitoring\TopologyOpeningEvent — The MongoDB\Driver\Monitoring\TopologyOpeningEvent class
- MongoDB\Driver\Monitoring\CommandSubscriber — The MongoDB\Driver\Monitoring\CommandSubscriber interface
- MongoDB\Driver\Monitoring\SDAMSubscriber — The MongoDB\Driver\Monitoring\SDAMSubscriber interface
- MongoDB\Driver\Monitoring\Subscriber — The MongoDB\Driver\Monitoring\Subscriber interface
MongoDB\Driver\Exception — Exception 类
- MongoDB\Driver\Exception\AuthenticationException — The MongoDB\Driver\Exception\AuthenticationException class
- MongoDB\Driver\Exception\BulkWriteException — The MongoDB\Driver\Exception\BulkWriteException class
- MongoDB\Driver\Exception\ConnectionException — The MongoDB\Driver\Exception\ConnectionException class
- MongoDB\Driver\Exception\ConnectionTimeoutException — The MongoDB\Driver\Exception\ConnectionTimeoutException class
- MongoDB\Driver\Exception\Exception — The MongoDB\Driver\Exception\Exception interface
- MongoDB\Driver\Exception\ExecutionTimeoutException — The MongoDB\Driver\Exception\ExecutionTimeoutException class
- MongoDB\Driver\Exception\InvalidArgumentException — The MongoDB\Driver\Exception\InvalidArgumentException class
- MongoDB\Driver\Exception\LogicException — The MongoDB\Driver\Exception\LogicException class
- MongoDB\Driver\Exception\RuntimeException — The MongoDB\Driver\Exception\RuntimeException class
- MongoDB\Driver\Exception\SSLConnectionException — The MongoDB\Driver\Exception\SSLConnectionException class (deprecated)
- MongoDB\Driver\Exception\UnexpectedValueException — The MongoDB\Driver\Exception\UnexpectedValueException class
- MongoDB\Driver\Exception\WriteException — The MongoDB\Driver\Exception\WriteException class

add a note

User Contributed Notes 3 notes

down

n dot vandermeij at mycademy dot com ¶

5 years ago


*** ONLY FOR VERSIONS >= 1.2.0 ***

If you encounter the following error:

"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"

For a detailed explanation, please visit: 

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

TLDR: You need to load the mongodb.so extension after the json.so
extension

Special thanks to Derick Rethans for pointing this out!

down

mike at eastghost dot com ¶

5 years ago


There is an adapter - so old MongoClient / MongoDB code will run on the new PHP7/Mongo mess

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

down

mike at eastghost dot com ¶

4 years ago


PHP 'USERLAND' / HIGHER-LEVEL DRIVER IS HERE --  [url]https://github.com/mongodb/mongo-php-driver[/url]

In new driver, these fail:

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

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

In new driver, result counting has become its own separate action, to be applied to the collection, not the cursor:

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

From jmikola 6 Jan 2016 ([url]https://github.com/mongodb/mongo-php-driver/issues/195 here[/url]):

"In the new driver, a Cursor object now represents the actual results of an executed command or query, whereas cursors in the legacy driver had a dual-nature (pre- or post-executed). The legacy MongoCursor::count() method actually invoked a count command with the same criteria; however, this meant it was entirely possible for the count command's calculation to differ from the actual query results, since they were not necessarily operating on the same result data.

"The userland library implements a count() method on the collection, which also takes filter criteria, and we'd rather encourage that so users understand that the operations are separate. If we do end up making Cursor countable in the userland library, we would use iterator_count() to provide an exact count on the results; however, this will also require us to cache the results so that users can rewind the cursor and iterate again (this was most recently discussed in PHPLIB-81). While the legacy driver would re-execute the query on a rewind, that's also not an option given the nature of a Cursor in the new driver.

"I realize this may come across as an inconvenience, but I believe the explicit API is a ultimately a step forward from the legacy driver, where many users might have been oblivious to what was actually happening under the hood. Feel free to follow up if you have additional questions.

add a note

官方地址：https://www.php.net/manual/en/set.mongodb.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 adodb手册 ADORecordSet对象 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet mysql面试题 PHP json解析（json_decode）页面工具 [原创]诡异的php-fpm超时问题 php中几种注释规范纯php实现DES以及TripleDES加密算法 php 修改图片大小支持php7的性能采集扩展 PHP mkdir()写出来的权限与mode值不符合

略微加速

PHP官方手册 - 互联网笔记

MongoDB driver

User Contributed Notes 3 notes