Pure PHP implementation of MongoDB driver, with aim to be a drop-in replacement of the official extension, usable under HHVM runtime.

The recommended way of installing is through the mongofill-hhvm package as HNI extension of HHVM

git clone https://github.com/mongofill/mongofill-hhvm
cd mongofill-hhvm
./build.sh

You can read the full instructions at building-and-installation instructions from the HNI package.

The easy way of installing Mongofill is through composer. You can see package information on Packagist.

{
    "require": {
        "mongofill/mongofill": "dev-master"
    }
}

Note: as pure PHP, the phpversion('mongo') will return null and some libraries as Doctrine will not work properly without modifications, so please use the HNI version.

You can check the current supported libraries at wiki page Supported-Libraries

You can catch us on IRC on Freenode channel #mongofill

Please push tests, ensuring compatibility with the official Mongo extension, that are not passing yet, into the "compat/not-passing" branch.

Contributions are greatly appreciated, including corrections of our english ;)

To ensure a consistent code base, you should make sure the code follows the PSR2 coding standards. We suggest use php-cs-fixer with your code before make the pull request with this flags: php-cs-fixer fix . --level=all

Tests are in the test folder. To run them, you need PHPUnit.

phpunit --configuration phpunit.xml.dist

You can find helper script at test/native/helper.sh. Your system must have installed: mongodb, git, phpize and autotools

cd tests/native/
./helper.sh setup
./helper.sh boot
./helper.sh run

A small suite of benchmarking is included with the package, you can run the suite with this command:

php ./vendor/bin/athletic -b tests/bootstrap.php  -p tests/Mongofill/Benchmarks/

Some results can be find at: https://gist.github.com/mcuadros/9551290

When using a replica set, the Mongofill driver needs to fetch information about the replica set configuration and status. To improve performance, the driver will attempt to use APC (apc_fetch, apc_store) to cache replica set data.

The APC functions should be automatically installed with HHVM, but if you plan on using the Mongofill driver with PHP, you'll need to make sure APC is installed if you want the performance boost.

For PHP 5.5 and higher, this would be the APCu extension. If APC is not installed, replica sets will still function, they just won't be as fast.