Installing the MongoDB PHP Driver with PECL
Information for installing this PECL extension may be
found in the manual chapter titled Installation
of PECL extensions. Additional information such as new releases,
downloads, source files, maintainer information, and a CHANGELOG, can be
located here:
» https://pecl.php.net/package/mongodb
Linux, Unix, and macOS users may run the following command to install the
driver:
$ sudo pecl install mongodb
On systems with multiple version of PHP installed (e.g. macOS default,
Homebrew, » XAMPP), each version of PHP
will have its own pecl
command and php.ini file(s). Additionally, each PHP environments (e.g.
CLI, web) may use separate php.ini files.
As of driver version 1.17.0, PECL will prompt for various
configure
options. To install the driver with default
options in a non-interactive script, empty string input may be piped to
pecl install
using the yes
command:
$ yes '' | sudo pecl install mongodb
A complete list of supported configure
options can be
found in the package.xml
file included in the PECL
package. To install the driver with specific configure
options in a non-interactive script, the
--configureoptions
option for
pecl install
may be used:
$ sudo pecl install --configureoptions='with-mongodb-system-libs="yes" enable-mongodb-developer-flags="no"' mongodb
By default, installing the driver via PECL will use bundled versions of
» libbson,
» libmongoc, and
» libmongocrypt and attempt to
automatically configure them.
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. If that does not resolve the problem, consider using the
manual installation
process.
Finally, add the following line to the php.ini file for each environment
that will need to use the driver: