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:
extension=mongodb.so