repo_mongoPhp7

Mongo PHP Adapter

The Mongo PHP Adapter is a userland library designed to act as an adapter between applications relying on ext-mongo and the new driver (ext-mongodb).

It provides the API of ext-mongo built on top of mongo-php-library, thus being compatible with PHP7.

Goal

This library aims to provide a compatibility layer for applications that rely on on libraries using ext-mongo (e.g. Doctrine ODM) but want to migrate to PHP 7 or HHVM on which ext-mongo will not run.

You should not be using this library if you do not rely on a library using ext-mongo. If you are starting a new project, please check out mongodb/mongodb.

Stability

This library is still in development and not stable enough to be used in production. In addition to the known issues outlined below, other issues or fatal errors may occur. Please use at your own risk.

Installation

This library requires you to have the mongodb extension installed and conflicts with the legacy mongo extension.

The preferred method of installing this library is with Composer by running the following from your project root:

$ composer require "alcaeus/mongo-php-adapter=dev-master"

Known issues

Mongo

• The Mongo class is deprecated and was not implemented in this library. If you are still using it please update your code to use the new classes.

MongoClient

• The MongoClient::connect and MongoClient::close methods are not implemented because the underlying driver connects lazily and does not offer methods for connecting disconnecting.
• The MongoClient::getConnections method is not implemented because the underlying driver does not offer a method to retrieve this data.
• The MongoClient::killCursor method is not yet implemented.

MongoDB

• The MongoDB::authenticate method is not supported. To connect to a database with authentication, please supply the credentials using the connection string.
• The includeSystemCollections parameter used in the MongoDB::getCollectionInfo, MongoDB::getCollectionNames, and MongoDB::listCollections methods is ignored. These methods do not return information about system collections.
• The MongoDB::repair method is not yet implemented.

MongoCollection

• The MongoCollection::createIndex method does not yet return the same result as the original method. Instead, it always returns the name of the index created.

MongoCursor

• The MongoCursor::explain method is not yet implemented.
• The MongoCursor::hasNext method is not yet implemented.
• The MongoCursor::setFlag method is not yet implemented.

MongoCommandCursor

• The MongoCommandCursor::createFromDocument method is not yet implemented.

Types

• Return values containing objects of the MongoDB\BSON\Javascript class cannot be converted to full MongoCode objects because there are no accessors for the code and scope properties.