PHP Conference Nagoya 2025

Instalación

Instalación del Controlador de MongoDB para PHP con PECL

Se puede encontrar información para la instalación de esta extensión PECL en el capítulo del manual titulado Instalación de extensiones PECL. Se puede encontrar información adicional, tal como nuevos lanzamientos, descargas, ficheros fuente, información de mantenimiento, y un CHANGELOG, aquí: » https://pecl.php.net/package/mongodb

Los usuarios de Linux, Unix, y OS X pueden ejecutar el siguiente comando para instalar el controlador:

$ sudo pecl install mongodb

Si su sistema tiene varias versiones de PHP instaladas (p. ej. en macOS, Homebrew, » XAMPP), tenga en cuenta que cada versión de PHP tiene su propio comando pecl y archivophp.ini.

La instalación del controlador a través de PECL utilizará las versiones incluidas de » libbson y » libmongoc e intentará configurarlos automáticamente.

Nota: Si el proceso de compilación no encuentra una biblioteca SSL, compruebe que los paquetes de desarrollo (por ej. libssl-dev) y » pkg-config están instalados. Si eso no resuelve el problema, considere utilizar el proceso de instalación manual.

Añada la siguiente línea al fichero php.ini:

extension=mongodb.so

Instalación del Controlador de MongoDB para PHP en macOS con Homebrew

» Homebrew 1.5.0 dejó de lado el » tap Homebrew/php y eliminó las fórmulas para las extensiones individuales de PHP. A partir de ahora, se aconseja a los usuarios de macOS que instalen la » fórmula php y sigan las instrucciones de instalación estándar de PECL utilizando el comando pecl proporcionado por la instalación de PHP de Homebrew.

Instalación del Controlador de MongoDB para PHP en Windows

Hay disponibles binarios precompilados para cada versión en » PECL para una variedad de combinaciones de versiones, seguridad con hilos, y bibliotecas VC. Extraiga el archivo y coloque php_mongo.dll en el directorio de extensiones de PHP ("ext" predeterminadamente).

Añada la siguiente línea al fichero php.ini:

extension=php_mongo.dll

Nota: Dependencias DLL adicionales para usuarios de Windows

Para que esta extensión funcione, hay unos ficheros DLL que deben estar disponibles en el PATH del sistema de Windows. Para obtener más información sobre esto, vea la FAQ titulada "Como añadir mi directorio de PHP al PATH de Windows". Aunque copiar los ficheros DLL desde el directorio PHP al directorio del sistema de Windows también funciona (porque el directorio del sistema está de manera predeterminada en el PATH del sistema), no se recomienda. Esta extensión requiere que los siguientes ficheros esten en el PATH: libsasl.dll

Instalación manual del Controlador de MongoDB para PHP

Para los desarrolladores de controladores y gente interesada en las últimas correcciones de errores, se puede compilar el controlador desde el último código fuente en » Github. Ejecute los siguientes comandos para clonar y construir el proyecto:

$ 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

El último paso informará sobre dónde ha sido instalado mongodb.so, similar a:

Installing shared extensions:     /usr/lib/php/extensions/debug-non-zts-20151012/

Asegúreser de que la opción extension_dir de php.ini apunta al directorio donde se instaló mongodb.so. Se puede verificar la opción ejecutando:

$ php -i | grep extension_dir
  extension_dir => /usr/lib/php/extensions/debug-non-zts-20151012 =>
                   /usr/lib/php/extensions/debug-non-zts-20151012

Si los directorios difieren, cambie extension_dir de php.ini o mueva manualmente mongodb.so al directorio correcto.

Añada la siguiente línea al fichero php.ini:

extension=mongodb.so

Instalación manual de Controlador de MongoDB para HHVM

En el momento de escribir esto, HHVM no posee un gestor de paquetes para extensiones. Descargue el último controlador desde » GitHub. De forma alternativa, se puede clonar el repositorio para construir el último código fuente:

$ git clone https://github.com/mongodb/mongo-hhvm-driver.git
$ cd mongo-hhvm-driver
$ git submodule sync && git submodule update --init --recursive

Configurar los ficheros make ejecutando:

$ hphpize
$ cmake .

Genere los ficheros configure para las bibliotecas incluidas. Para que esto funcione, es necesario tener instalados los paquetes automake, autoconf, y libtool (p.ej. mediante apt-get).

$ make configlib

Construya e instale el controlador ejecutando:

$ make -j 5
$ sudo make install

Nota:

Si el comando hphpize no está disponible, será necesario compilar HHVM desde el código fuente o instalar el paquete hhvm-dev (p.ej. mediante apt-get).

El último paso informará sobre dónde ha sido instalado mongodb.so, similar a:

Installing:     /usr/local/hhvm/3.9.1/lib/hhvm/extensions/20150212/mongodb.so

Añada la siguiente línea al fichero php.ini (normalmente se encuentra en "/etc/hhvm"):

hhvm.dynamic_extension_path=/usr/local/hhvm/3.9.1/lib/hhvm/extensions/20150212
hhvm.dynamic_extensions[mongodb]=mongodb.so

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top