taniele/mongofill

Polyfill of PECL Mongo extension

Mongofill

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

Installation

Recommended way

The recommended way of installing is through the mongofill-hhvm package as HNI extension of HHVM, _(*2)

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., _(*3)

Easy way

The easy way of installing Mongofill is through composer. You can see package information on Packagist., _(*4)

{
    "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., _(*5)

Supported libraries

You can check the current supported libraries at wiki page Supported-Libraries, _(*6)

Community

You can catch us on IRC on Freenode channel #mongofill, _(*7)

Contributing

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

Contributions are greatly appreciated, including corrections of our english ;), _(*9)

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, _(*10)

Running the PHPUnit tests

Tests are in the test folder. To run them, you need PHPUnit., _(*11)

``` bash phpunit --configuration phpunit.xml.dist, <sub>(*12)</sub>

### Running the native mongo-php-driver tests

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

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

Benchmarking

A small suite of benchmarking is included with the package, you can run the suite with this command:, <sub>(*13)</sub>

bash php ./vendor/bin/athletic -b tests/bootstrap.php -p tests/Mongofill/Benchmarks/, <sub>(*14)</sub>

Some results can be find at: https://gist.github.com/mcuadros/9551290, <sub>(*15)</sub>