Manually Installing the MongoDB PHP Driver
For driver developers and people interested in the latest bugfixes, you can
compile the driver from the latest source code on
» Github. Run the following
commands to clone and build the project:
$ git clone https://github.com/mongodb/mongo-php-driver.git
$ cd mongo-php-driver
$ git submodule update --init
$ phpize
$ ./configure
$ make all
$ sudo make install
If your system has multiple version of PHP installed (e.g. macOS default
and » XAMPP), note
that each version of PHP has its own
phpize command and php.ini file.
By default, the driver will use bundled versions of
» libbson and
» libmongoc and attempt to
configure them on its own. If libbson and libmongoc are already installed as
system libraries, you can instruct the driver to utilize them by specifying
--with-libbson=yes --with--libmongoc=yes as arguments to
configure.
For a complete list of configure options, run
configure --help.
When using bundled versions of libbson and libmongoc, the driver will also
attempt to select an SSL library according to the
--with-mongodb-ssl option for
configure. The default value is
--with-mongodb-ssl=auto, which will search for Secure
Transport (macOS only), OpenSSL, and LibreSSL, in that order. Additionally,
you may specify openssl, libressl, or
darwin to force selection of a particular library,
respectively.
Note:
If the build process fails to find an SSL library, check that the
development packages (e.g. libssl-dev) and
» pkg-config are both
installed.
When using Homebrew on macOS, it is common for a system to have multiple
versions of OpenSSL installed. To ensure that the desired version of OpenSSL
is selected, the PKG_CONFIG_PATH environment variable may
be used to control the search path for pkg-config. If
pkg-config is not used, configure also
supports a --with-openssl-dir=DIR argument, which can be
used to specify a manual search path (for OpenSSL only).
The final build step, make install, will report where
mongodb.so has been installed, similar to:
Installing shared extensions: /usr/lib/php/extensions/debug-non-zts-20151012/
Ensure that the extension_dir option
in php.ini points to the directory where mongodb.so
was installed. You can query for the option by running:
$ php -i | grep extension_dir
extension_dir => /usr/lib/php/extensions/debug-non-zts-20151012 =>
/usr/lib/php/extensions/debug-non-zts-20151012
If the directories differ, either change
extension_dir in php.ini or
manually move mongodb.so to the correct directory.
Finally, add the following line to your php.ini file: