Esta extensión fue declarada obsoleta en PHP 5.5.0 y eliminada en PHP 7.0.0. En su lugar debería utilzarse las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API. Las alternativas a esta función son:
Para compilar, simplemente usar la opción de configuración
--with-mysql[=DIR]
donde opcionalmente [DIR] apunta al
directorio de instalación de MySQL.
Aunque esta extensión de MySQL es compatible con MySQL 4.1.0 y superior, no da soporte a las funcionalidades extra que estas versiones proveen. Para ello usar la extensión MySQLi.
Si se quisiera instalar la extensión de MySQL junto con la extensión MySQLi se debe usar la misma libreria de cliente para evitar cualquier conflicto.
Nota: [DIR] es la ruta a los ficheros de la biblioteca cliente de
MySQL (cabeceras y bibliotecas), los cuales se pueden descargar desde
» MySQL.
| Versión de PHP | Por defecto | Opciones de configuración: mysqlnd | Opciones de configuración: libmysqlclient |
Historial de cambios |
|---|---|---|---|---|
| 4.x.x | libmysqlclient | No Disponible | --without-mysql to disable | MySQL habilitada por omisión, las bibliotecas cliente de MySQL están incluidas |
| 5.0.x, 5.1.x, 5.2.x | libmysqlclient | No Disponible | --with-mysql=[DIR] | MySQL ya no está habilitada de forma predeterminada, y las bibliotecas cliente de MySQL ya no están integradas |
| 5.3.x | libmysqlclient | --with-mysql=mysqlnd | --with-mysql=[DIR] | mysqlnd ahora está disponible |
| 5.4.x | mysqlnd | --with-mysql | --with-mysql=[DIR] | mysqlnd ahora es el predeterminado |
MySQL ya no está activado por defecto, así la DLL php_mysql.dll debe ser habilitada dentro de php.ini. Además, PHP necesita acceso a la libreria de cliente de MySQL. Un archivo llamado libmysql.dll que está incluido en la distribución de PHP de Windows, y así PHP se comunica con MySQL, este fichero necesita estar disponible en el PATH de los sistemas Windows. Para información sobre como hacerlo ver el FAQ titulado "Cómo agrego mi directorio de PHP a PATH en Windows". Aunque copiando libmysql.dll al directorio del sistema de Windows también funcionará (ya que el directorio del sistema está por defecto en el PATH del sistema), pero no está recomendado.
Como ocurre con cualquier otra extensión de PHP (tal como
php_mysql.dll), la directiva de PHP
extension_dir, debe establecer
el directorio donde estan localizada las extensiones de PHP. Ver también el
Manual de instrucciónes de instalación
en Windows. Un ejemplo de valor de extension_dir para PHP 5 es
c:\php\ext
Nota:
Si al iniciar el servidor web se produce un error similar al siguiente:
"Unable to load dynamic library './php_mysql.dll'", esto se debe a que php_mysql.dll y/o libmysql.dll no puede ser encontrado por el sistema.
El Controlador Nativo de MySQL está habilitado por omisión. Incluya php_mysql.dll, pero libmysql.dll ya no es necesario o usado.
Se pueden encontrar errores y problemas de inicio de PHP al cargar esta extensión en conjunción con la extensión recode. Para más información ver la extension recode.
Nota:
Si fueran necesarios otro juego de caracteres distinto de latin (predeterminado), se ha de instalar externamente (no incluido) libmysqlclient con el soporte para el juego de caracteres compilado.