Instalación/Configuración
PHP Manual

Instalación

La extensión mysqli se introdujo en PHP versión 5.0.0. El Driver Nativo MySQL se introdujo en PHP version 5.3.0.

Instalación en Linux

Las distribuciones más comunes de Unix incluyen versiones binarias de PHP que pueden ser instalados. Aunque estas versiones binarias son típicamente construidos con soporte para extensiones de MySQL habilitada, las bibliotecas de extensión puede ser necesario instalarlo utilizando un paquete adicional. Compruebe el gestor de paquetes que viene con su distribución elegida para disponibilidad.

Si su distribución de Unix no viene con un paquete binario de PHP con la extensión mysqli disponible, tendrá que compilar PHP desde código fuente. La compilación de PHP desde el código fuente le permite especificar las extensiones de MySQL que desea utilizar, así como la elección de la biblioteca cliente para cada extensión.

La opción recomendada es el Controlador Nativio de MySQL, ya que sus resultados mejoran el rendimiento y dan acceso a características no disponibles al usar la Biblioteca Cliente de MySQL. Consúlte ¿Qué es el Controlador Nativo de MySQL para PHP? para una visión general breve de las ventajas del Controlador Nativo de MySQL.

/path/to/mysql_config representa la ubicación del programa mysql_config que viene con el Servidor MySQL.

Matriz de soporte en tiempo de compilación de mysqli
PHP Versión Por defecto Opciones de configuración: mysqlnd Opciones de configuración: libmysql Historial de cambios
5.0.x, 5.1.x, 5.2.x libmysql Not Available --with-mysqli=/path/to/mysql_config  
5.3.x libmysql --with-mysqli=mysqlnd --with-mysqli=/path/to/mysql_config mysqlnd ahora es soportada
5.4.x mysqlnd --with-mysqli --with-mysqli=/path/to/mysql_config mysqlnd ahora es el predeterminado

Observe que es posible mezclar libremente extensiones de MySQL y bibliotecas cliente. Por ejemplo, es posible habilitar la extensión de MySQL para usar la Biblioteca Cliente de MySQL (libmysql), mientras se configura la extensión mysqli para usar el Controlador Nativo de MySQL. No obstante, son posibles todas las permutaciones de extensiones y bibliotecas cliente.

El siguiente ejemplo compila la extensión MySQL para usar la Biblioteca Cliente de MySQL, y las extensiones mysqli y PDO MYSQL para usar el Controlador Nativo de MySQL:

./configure --with-mysql=/usr/bin/mysql_config  \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd
[other options]

Instalación en sistemas Windows

En Windows, PHP es más comúnmente instalado usando el instalador binario.

PHP 5.0, 5.1, 5.2

Una vez que se ha instalado PHP, se debe ajustar la configuración para habilitar mysqli y especificar la biblioteca cliente que se va a utilizar.

La extensión mysqli no está habilitada por defecto, por lo que el archivo DLL php_mysqli.dll debe habilitarse al interior de php.ini. Para hacer esto usted necesita encontrar el archivo php.ini (normalmente se encuentra en c:\php), y asegúrese de eliminar el comentario (punto y coma) desde el inicio de la línea de extension=php_mysqli.dll, en la sección marcada como [PHP_MYSQLI].

Además, si desea utilizar la biblioteca de cliente MySQL con mysqli, debe asegurarse de que PHP puede acceder al archivo de la biblioteca de cliente. La biblioteca de cliente MySQL se incluye como un archivo de nombre libmysql.dll en la distribución de PHP en Windows. Este archivo debe estar disponible en la variable de entorno de sistema de Windows PATH, de modo que puede ser cargado con éxito. Véase la FAQ titulada "Cómo agrego mi directorio PHP a la variable PATH en Windows" para obtener información sobre cómo hacer esto. Copiar libmysql.dll al directorio de sistema de Windows (normalmente C:\Windows\System) funciona, pues el directorio de sistema esta por defecto en el PATH del sistema. Sin embargo, esta práctica está totalmente desaconsejada.

Al igual que con cualquier otra extensión de PHP (como php_mysqli.dll), la directiva de PHP extension_dir se debe de establecer en el directorio donde están ubicadas las extensiones de PHP. Consulte tambien el Manual de instalación de Windows. Un ejemplo de valor de extension_dir para PHP 5 es c:\php\ext.

Nota:

Si al iniciar el servidor web un error similar al siguiente ocurre: "Unable to load dynamic library './php_mysqli.dll'", esto es porque php_mysqli.dll y/o libmysql.dll no pudo ser encontrado por el sistema.

PHP 5.3.0+

En Windows, con versiones de PHP 5.3 o superiores, la extensión mysqli viene habilitada y utiliza por omisión el Driver Nativo MySQL. Esto significa que no debe preocuparse por configurar el acceso a libmysql.dll.


Instalación/Configuración
PHP Manual