https://github.com/mongodb/mongo-hhvm-driver
MongoDB HHVM driver **Note, this driver is no longer maintained**
https://github.com/mongodb/mongo-hhvm-driver
Last synced: 4 months ago
JSON representation
MongoDB HHVM driver **Note, this driver is no longer maintained**
- Host: GitHub
- URL: https://github.com/mongodb/mongo-hhvm-driver
- Owner: mongodb
- License: apache-2.0
- Archived: true
- Created: 2014-12-02T16:44:52.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-12-22T17:05:42.000Z (over 3 years ago)
- Last Synced: 2024-09-23T01:05:59.449Z (8 months ago)
- Language: PHP
- Homepage:
- Size: 6.77 MB
- Stars: 34
- Watchers: 35
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Changelog: ChangeLog.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
Awesome Lists containing this project
README
MongoDB HHVM Driver
===================
End of Life Notice
------------------
The MongoDB HHVM Driver is now officially end-of-life (EOL). No further development, bugfixes, enhancements, documentation changes or maintenance will be provided by this project and pull requests will no longer be accepted.
About
-----
This is the low-level HHVM driver for MongoDB. The API is the same as the PHP
driver for MongoDB. The documentation for both of them is the same, and can be
found at http://www.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.
.. _`Doctrine MongoDB's ODM`: http://doctrine-mongodb-odm.readthedocs.org/en/latest/
.. _`MongoDB Library`: http://mongodb.github.io/mongo-php-library/
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
-------------
- http://php.net/mongodb
- http://mongodb.github.io/mongo-php-driver/
Installation
------------
Please ensure, that before you install the extension, the following tools are
installed: autoconf, automake, and libtool.
Compiling this extension requires the ``hphpize`` command, which is available by
installing the ``hhvm-dev`` package from the
`HHVM repositories `_
or `building HHVM from source `_.
Besides the extension, we recommend using it in combination with our `userland
library `_ which
is distributed as `mongodb/mongodb
`_ for Composer.
From a package (.tgz)
~~~~~~~~~~~~~~~~~~~~~
Releases of this driver can be found on
https://github.com/mongodb/mongo-hhvm-driver/releases
Please download the latest .tgz file into a directory, and run the following
commands::
mkdir hhvm-mongodb
cd hhvm-mongodb
tar -xvzf ../hhvm-mongodb-1.1.2.tgz
cd hhvm-mongodb-1.1.2
hphpize
cmake .
make configlib
make -j [number_of_processor_cores] # eg. make -j 4
make install
Building from source
~~~~~~~~~~~~~~~~~~~~
Run the following
commands::
git clone https://github.com/mongodb/mongo-hhvm-driver --branch master
cd mongo-hhvm-driver/
git submodule update --init --recursive
hphpize
cmake .
make configlib
make -j [number_of_processor_cores] # eg. make -j 4
make install
Installing
----------
In your ``/etc/hhvm/php.ini``, add the following lines (adjusting paths if
necessary)::
hhvm.dynamic_extensions[mongodb]=mongodb.so
Contributing
------------
See `CONTRIBUTING.rst `_.
Related Projects
----------------
- `PHP Implementation of this driver `_
- `Official high-level library `_