Submit a Pull Request Report a Bug

Controlador de MongoDB

Esta extensión está desarrollada sobre las bibliotecas » libmongoc y » libbson. Proporcina una API mínima para la funcionalidad principal del controlador: comandos, consultas, escrituras, gestión de conexiones y serialización BSON.

Las bibliotecas de usuario de PHP que dependan de esta extensión podrían proporcionar APIs de más alto nivel, como constructores de consultas, métodos ayudantes de comandos individuales, y GridFS. Los desrrolladores de aplicaciones deberían considerar usar esta extensión junto con la » biblioteca de PHP MongoDB, la cual implementa las mismas API de más alto nivel que se encuentra en los controladores de MongoDB para otros lenguajes. Esta separación de materias permite al controlador centrarse en características esenciales para las cuales una implementación de la extensión es primordial el rendimiento.

Instalación/Configuración
Tutoriales
- Empleo de la biblioteca de PHP para MongoDB (PHPLIB)
- Application Performance Monitoring (APM)
Arquitectura del controlador y sus entresijos — Explicación de la arquitectura del controlador y de características especiales
- Arquitectura — Vista general de la arquitectura
- Connections — Connection handling and persistence
- Persistencia de datos — Serialización y deserialización de variables de PHP en MongoDB
Security
- Request Injection Attacks
- Script Injection Attacks
MongoDB\Controlador — Clases del controlador de 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\Session — The MongoDB\Driver\Session class
- MongoDB\Driver\ClientEncryption — The MongoDB\Driver\ClientEncryption class
- MongoDB\Driver\ServerApi — The MongoDB\Driver\ServerApi 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\CursorInterface — The MongoDB\Driver\CursorInterface interface
- MongoDB\Driver\Server — The MongoDB\Driver\Server class
- MongoDB\Driver\ServerDescription — The MongoDB\Driver\ServerDescription class
- MongoDB\Driver\TopologyDescription — The MongoDB\Driver\TopologyDescription 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 — Clases de tipo BSON y funciones de serialización
- Funciones
- MongoDB\BSON\Binary — La clase MongoDB\BSON\Binary
- MongoDB\BSON\Decimal128 — The MongoDB\BSON\Decimal128 class
- MongoDB\BSON\Javascript — La clase MongoDB\BSON\Javascript
- MongoDB\BSON\MaxKey — La clase MongoDB\BSON\MaxKey
- MongoDB\BSON\MinKey — La clase MongoDB\BSON\MinKey
- MongoDB\BSON\ObjectID — La clase MongoDB\BSON\ObjectID
- MongoDB\BSON\Regex — La clase MongoDB\BSON\Regex
- MongoDB\BSON\Timestamp — La clase MongoDB\BSON\Timestamp
- MongoDB\BSON\UTCDateTime — La clase MongoDB\BSON\UTCDatetime
- MongoDB\BSON\Type — La interfaz MongoDB\BSON\Type
- MongoDB\BSON\Persistable — La interfaz MongoDB\BSON\Persistable
- MongoDB\BSON\Serializable — La interfaz MongoDB\BSON\Serializable
- MongoDB\BSON\Unserializable — La interfaz MongoDB\BSON\Unserializable
- 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
- Funciones
- 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\Controlador\Excepciones — Clases de excepcines
- MongoDB\Driver\Exception\AuthenticationException — The MongoDB\Driver\Exception\AuthenticationException class
- MongoDB\Driver\Exception\BulkWriteException — The MongoDB\Driver\Exception\BulkWriteException class
- MongoDB\Driver\Exception\CommandException — The MongoDB\Driver\Exception\CommandException class
- MongoDB\Driver\Exception\ConnectionException — The MongoDB\Driver\Exception\ConnectionException class
- MongoDB\Driver\Exception\ConnectionTimeoutException — The MongoDB\Driver\Exception\ConnectionTimeoutException class
- MongoDB\Driver\Exception\EncryptionException — The MongoDB\Driver\Exception\EncryptionException 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\ServerException — The MongoDB\Driver\Exception\ServerException 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
- Class Tree — MongoDB Exception Class Tree

＋add a note

User Contributed Notes 4 notes

down

n dot vandermeij at mycademy dot com ¶

6 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 ¶

6 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 ¶

5 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.

down

-1

Robert ¶

7 months ago

Hey guys,
a short example to access a local mongo db server:

<?php

echo "Mongo DB Example<br>";

// run composer requre mongodb/mongdodb in your project folder before
require("vendor/autoload.php");

// start mongod process on your instance first
$client = new MongoDB\Client('mongodb://localhost:27017');

// select a database (will be created automatically if it not exists)
$db = $client->test2;
echo "Database test2 created/selected<br>";

// select a collection (will be created automatically if it not exists)
$coll = $db->selectCollection("mycoll");
echo "Collection mycoll created/selected<br>";

// insert a datatow in the collection
$coll->insertOne(['foo' => 'bar']);

// search for the datarow
echo "Result:<br>";
var_dump($coll->findOne(['foo' => 'bar']));

?>

＋add a note