PHP C M4 JavaScript Shell Makefile Other
Latest commit 9b7740a Mar 20, 2017 @jmikola jmikola Merge branch 'v1.2'
Permalink
Failed to load latest commit information.
.github Remove PR issue template Aug 31, 2016
.travis.scripts PHPC-496: Revert "Temporary workaround for warning in mongoc" Jan 7, 2016
bin PHPC-928: Consolidate glob paths for phpt files Mar 15, 2017
scripts PHPC-714: Script to convert BSON corpus tests Jan 13, 2017
src PHPC-935: Validate filter and options in Query constructor Mar 13, 2017
tests Merge branch 'v1.2' Mar 15, 2017
.gitignore Remove references to Composer and PHPUnit Feb 10, 2017
.gitmodules We are tracking 1.2.0-dev, not master! Jul 15, 2015
.llvm-cov.sh Add travis and coveralls support Jun 20, 2014
.travis.yml Remove Travis configuration for notification emails Dec 13, 2016
CONTRIBUTING.md PHPC-936: Define PHP_MONGODB_VERSION and STABILITY constants Mar 17, 2017
CREDITS Fixed CREDITS file and include it in package.xml too Nov 29, 2016
LICENSE Add Apache 2 license Dec 19, 2014
Makefile.frag Remove references to Composer and PHPUnit Feb 10, 2017
README.md PHPC-584: Remove MkDocs documentation Oct 26, 2016
THIRD_PARTY_NOTICES PHPC-799: Add THIRD_PARTY_NOTICES file Nov 22, 2016
Vagrantfile Increased vagrant memory usage for virtual box to 2G Apr 20, 2016
config.m4 PHPC-875: Allow compiling without SSL Mar 10, 2017
config.w32 PHPC-892: Fix reference to jsonsl.c in config.w32 Feb 13, 2017
phongo_compat.c PHPC-890: Add license header copypasta Jan 6, 2017
phongo_compat.h PHPC-894: Implement get_gc handlers for BSON classes Jan 24, 2017
php_bson.h PHPC-911: Prefix Zend_FN names for MongoDB\BSON functions Feb 10, 2017
php_phongo.c Merge branch 'v1.2' Mar 20, 2017
php_phongo.h Merge branch 'v1.2' Mar 20, 2017
php_phongo_classes.h PHPC-911: Use prefixed symbols for shared construct/wakeup FEs Feb 10, 2017
php_phongo_structs.h PHPC-932: Remove reference to Manager on Cursor, Server, and WriteResult Mar 10, 2017

README.md

pecl/mongodb (MongoDB driver for PHP)

Build Status Coverage Status

This is the low-level PHP driver for MongoDB. The API is the same as the HHVM driver for MongoDB. The documentation for both of them is the same, and can be found at http://docs.php.net/manual/en/set.mongodb.php

The driver is written to be a bare bone layer to talk to MongoDB, and therefore misses many convenience features. Instead, these convenience methods have been split out into a layer written in PHP, the MongoDB Library. Using this library should be your preferred way of interacting with MongoDB.

Please note that the new HHVM and PHP drivers implement a different API from the legacy driver at http://pecl.php.net/package/mongo; therefore existing libraries that use the legacy driver (e.g. Doctrine MongoDB's ODM) will not work with the new drivers.

In the long run, we hope that userland packages will be built atop this driver to implement various APIs (e.g. a BC layer for the existing driver, new fluent interfaces), management utilities (for creating admin utilities and cluster management applications), and other interesting libraries.

Documentation

Installation

To build and install the driver:

$ pecl install mongodb
$ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:\s*||"`

We recommend using this extension in conjunction with our userland library, which is distributed as mongodb/mongodb for Composer.

Contributing

See CONTRIBUTING.md

Related Projects