¿Cómo solucionar el error "Parece que a tu instalación de PHP le falta la extensión MySQL" en WordPress?

Si alguna vez has intentado instalar o cargar WordPress y te has encontrado con el error "Parece que a tu instalación de PHP le falta la extensión MySQL, necesaria para WordPress", no estás solo. Este error de WordPress, bloquea tu sitio web por completo y puede resultar abrumador a primera vista.

La buena noticia es que casi siempre se trata de un problema con el controlador PHP MySQL o la configuración del servidor. Siguiendo los pasos correctos, puedes solucionarlo sin necesidad de conocimientos técnicos avanzados.

TL;DR: Extensión MySQL faltante: lo que necesitas saber

• PHP no encuentra el controlador de base de datos necesario para comunicarse con MySQL, por lo que WordPress no se carga. Este es un error de extensión de PHP no cargada a nivel del servidor.

• Este error suele deberse a una actualización de PHP, una migración del servidor o un archivo php.ini mal configurado, lo que provoca que el sitio de WordPress no se cargue para todos los visitantes.

• En la mayoría de los casos, habilitar la extensión MySQLi o PDO_MySQL en PHP resuelve el problema.

• Si los cambios a nivel de servidor no son de su agrado, su proveedor de alojamiento web puede aplicar la solución rápidamente.

Descripción general del error "Parece que a tu instalación de PHP le falta la extensión MySQL" en WordPress

Este error se produce cuando WordPress no puede conectarse a la base de datos porque falta una extensión MySQL necesaria o está deshabilitada en la configuración de PHP.

¿Qué significa el mensaje de error en WordPress?

El mensaje de error completo dice: "Parece que a tu instalación de PHP le falta la extensión MySQL, que es necesaria para WordPress"

En pocas palabras, PHP no puede encontrar la biblioteca que necesita para comunicarse con tu base de datos MySQL. Esta condición de extensión PHP faltante provoca un error en la base de datos de WordPress antes de que se pueda mostrar cualquier contenido.

Sin esa conexión, WordPress no puede cargar ningún contenido, configuración ni partes de tu sitio. El sitio web completo se vuelve inaccesible.

Esto no es un error de WordPress. Es un problema del servidor. WordPress simplemente detecta el componente que falta y lo reporta.

Ejemplo del mensaje de error "Extensión MySQL faltante"

Cuando se produce este error, normalmente verá uno de los siguientes mensajes en una pantalla blanca en blanco. Esta pantalla blanca de WordPress a menudo no tiene ninguna explicación adicional:

• “Parece que a tu instalación de PHP le falta la extensión MySQL, que es necesaria para WordPress.”

• “No pudimos conectarnos a MySQL.”

• “No se puede seleccionar la base de datos.”

Estos mensajes suelen aparecer antes de que se cargue el panel de administración de WordPress. También puede aparecer este error durante una instalación nueva de WordPress cuando el script de configuración no puede conectarse a la base de datos.

¿Por qué este error daña tu sitio web de WordPress?

WordPress se basa completamente en una base de datos. Cada vez que se carga una página, se ejecuta una consulta PHP a la base de datos MySQL. Una conexión MySQL de WordPress rota significa que WordPress no puede hacer ninguna de las siguientes cosas:

• Recuperar publicaciones, páginas, categorías o comentarios.
• Carga la configuración del tema activo y las configuraciones de los widgets.
• Autenticar los inicios de sesión de los usuarios.
• Ejecuta cualquier funcionalidad del plugin instalado.

El resultado es un sitio web completamente inoperativo. Los visitantes ven una pantalla de error en lugar de tu contenido.

Relación entre la conexión a bases de datos PHP, MySQL y WordPress

PHP es el lenguaje de programación que impulsa WordPress. MySQL es la base de datos relacional que almacena todos los datos de tu sitio: publicaciones, usuarios, configuraciones, datos de pluginsy más.

Estos dos sistemas se comunican mediante una extensión de PHP que actúa como puente. WordPress gestiona esto internamente a través de su capa de abstracción de base de datos, la clase wpdb.

Cada vez que un visitante accede a tu sitio, PHP envía consultas a MySQL mediante la clase wpdb, recupera los datos relevantes y devuelve los resultados como una página HTML. Si la extensión de PHP necesaria para esta comunicación no está presente o está deshabilitada, todo el proceso falla.

WordPress comprueba si existe esta extensión al iniciarse. Si no encuentra ninguna, muestra inmediatamente un error de "extensión MySQL faltante".

MySQL vs MySQLi vs PDO Explicación de MySQL

Existen tres extensiones de PHP que pueden gestionar las conexiones a bases de datos MySQL:

• MySQL: La extensión original de PHP para MySQL. Se dejó de usar en PHP 5.5 y se eliminó definitivamente en PHP 7.0. WordPress también dejó de darle soporte al mismo tiempo. Si tu servidor usa PHP 7.0 o superior (que debería), esta extensión simplemente no está disponible. Su uso nunca fue una opción a largo plazo.

• MySQLi: La extensión MySQL “mejorada” (la “i” significa mejorada). Puedes habilitar MySQLi en PHP a través de php.ini o tu panel de control de hosting. Admite tanto programación orientada a objetos como procedimental. Además, añade funciones como sentencias preparadas y sentencias múltiples. WordPress utiliza MySQLi por defecto cuando está disponible.

• PDO_MySQL: PHP Data Objects, una interfaz de base de datos más abstracta. Admite múltiples sistemas de bases de datos mediante una única API consistente. WordPress puede usar PDO_MySQL como alternativa cuando MySQLi no esté disponible.

Las versiones modernas de WordPress requieren que MySQLi o PDO_MySQL estén instalados y activos. Si ninguno de los dos está presente, aparece inmediatamente el error de extensión MySQL faltante.

¿Qué causa el error de extensión MySQL faltante en WordPress?

Este error puede deberse a diversas circunstancias. Identificar la causa raíz es el primer paso para encontrar la solución adecuada.

• Actualización de PHP sin transferencia de extensiones: Al actualizar PHP, por ejemplo, de la versión 7.4 a la 8.1 o 8.2, la nueva instalación podría no incluir automáticamente todas las extensiones previamente activas. El paquete php-mysqli suele requerir una reinstalación independiente. La extensión MySQLi puede quedar fuera de la nueva instalación, aunque estuviera activa en la anterior. Este es uno de los desencadenantes más comunes de este error en entornos de producción.

• Migración de servidor: Mover tu sitio WordPress a un nuevo servidor o cambiar de proveedor de hosting puede resultar en una configuración incorrecta del entorno PHP. No todas las configuraciones de pila de servidor habilitan MySQLi de forma predeterminada. Es posible que el nuevo servidor ejecute PHP sin él.

• Archivo php.ini dañado o incompleto. El archivo php.ini controla todos los aspectos de tu entorno PHP, incluyendo qué extensiones se cargan y dónde las busca PHP mediante la extension_dir . Si este archivo está dañado, incompleto o le falta la línea de extensión MySQLi correcta, PHP generará un error de inicio y WordPress no podrá encontrar el controlador que necesita.

• Múltiples versiones de PHP ejecutándose simultáneamente. Algunos servidores ejecutan varias versiones de PHP en paralelo. Si WordPress apunta a un binario de PHP incorrecto, uno que no incluye MySQLi, verá este error aunque otros sitios en el mismo servidor funcionen correctamente. Este conflicto de versiones de PHP puede pasar desapercibido fácilmente, ya que el panel de control del hosting puede mostrar la versión correcta mientras que el servidor web utiliza una diferente.

• Instalación nueva en un servidor personalizado: Las nuevas instalaciones de WordPress en servidores locales con configuraciones personalizadas, como XAMPP, MAMP, Laragon o contenedores Docker, a menudo no habilitan MySQLi de forma predeterminada. Los desarrolladores que configuran entornos locales suelen encontrarse con este problema, ya que la extensión php-mysqli debe habilitarse manualmente en la mayoría de las configuraciones predeterminadas de XAMPP y MAMP.

• Cambios en la configuración del proveedor de alojamiento: Los proveedores de alojamiento ajustan ocasionalmente la configuración de sus servidores durante las ventanas de mantenimiento o las actualizaciones de infraestructura. Estos cambios pueden deshabilitar inadvertidamente extensiones que antes estaban activas.

Métodos para solucionar el error de extensión MySQL faltante en WordPress

Puedes solucionar este problema habilitando la extensión MySQL, actualizando PHP o corrigiendo la configuración de tu servidor.

Método 1: Instalar o habilitar la extensión MySQLi en PHP

Esta es la solución más directa. En un servidor Linux, puedes instalar la extensión MySQLi usando tu gestor de paquetes. El paquete suele llamarse php-mysqli en sistemas basados ​​en Debian.

Para Ubuntu o Debian (instale php-mysqli):

sudo apt install php-mysqli sudo service apache2 restart

Para CentOS o RHEL:

sudo yum install php-mysqli sudo systemctl restart httpd

Tras la instalación, reinicie el servidor web. A continuación, vuelva a cargar su sitio de WordPress para comprobar si se ha solucionado el error.

Si utilizas un alojamiento compartido, busca la sección "Extensiones PHP" o "Seleccionar extensiones PHP" en tu panel de control (cPanel, Plesk o similar). Localiza mysqli en la lista, actívala y guarda los cambios. Normalmente, el cambio se aplica de inmediato.

Método 2: Comprobar y actualizar o degradar la versión de PHP

Una versión incompatible de PHP es una causa frecuente de este problema. WordPress recomienda oficialmente PHP 8.1 o superior.

Ejecutar una versión no compatible, especialmente una a la que le falten extensiones principales, provoca este error. Tanto PHP 8.1 como PHP 8.2 incluyen MySQLi de forma predeterminada en servidores configurados correctamente.

Para comprobar y cambiar su versión de PHP:

• Inicia sesión en tu panel de control de hosting.

• Busque “Versión de PHP”, “Administrador MultiPHP” o una opción similar (en cPanel, esta se encuentra en “Software”).

• Cambia a PHP 8.1 o 8.2, ya que ambos incluyen MySQLi por defecto.

Si una actualización reciente ha dañado tu sitio web, puedes volver temporalmente a la versión anterior mientras investigas el problema. Algunos proveedores de alojamiento web permiten seleccionar la versión de PHP por dominio.

Siempre prueba los cambios de versión de PHP en un entorno de prueba antes de aplicarlos a producción. Una incompatibilidad de versiones puede dañar los plugins y los temas, además de provocar errores en la base de datos.

Método 3: Actualizar el núcleo, los temas y los plugins de WordPress

Los archivos principales, los temas o los complementos obsoletos a veces provocan errores de compatibilidad, incluidos fallos en la capa de base de datos de PHP.

WordPress actualiza periódicamente su clase de abstracción de base de datos interna (wpdb) para admitir versiones más recientes de PHP y los requisitos de compatibilidad con MySQL.

Para actualizar WordPress:

• Navegue a Escritorio → Actualizaciones en su panel de administración.
• Haz clic en Actualizar ahora para el núcleo de WordPress.
• A continuación, actualiza todos los plugins y temas activos.

Si no puedes acceder al panel de administración porque el error lo bloquea, actualiza mediante FTP subiendo los archivos más recientes de WordPress descargados directamente de WordPress.org. Esta es una forma segura de actualizar los archivos principales sin modificar la carpeta wp-content.

Realice siempre una copia de seguridad completa de su sitio web y base de datos antes de ejecutar cualquier actualización. Esto protege sus datos en caso de que algo salga mal durante el proceso.

Método 4: Verificar la configuración de PHP usando phpinfo()

La phpinfo() genera un informe detallado del entorno PHP de su servidor. Ejecutar una comprobación de WordPress con phpinfo() es una de las maneras más rápidas de confirmar si MySQLi o PDO_MYSQL están cargados.

• Crea un nuevo archivo llamado info.php en el directorio raíz de tu WordPress.
• Añade esta única línea: <?php phpinfo(); ?>
• Visita yourdomain.com/info.php en tu navegador.
• Utilice CTRL+F para buscar “mysqli” o “pdo_mysql” en la salida.

Si ve una sección titulada “mysqli” con el estado habilitado, la extensión está cargada. Si no aparece, la extensión no está instalada y debe agregarse.

Nota de seguridad: Elimine el info.php inmediatamente después de la comprobación. Si lo deja accesible, expondrá información detallada de la configuración del servidor a cualquier persona que visite la URL.

Método 5: Solucionar problemas de configuración de php.ini

El archivo php.ini determina qué extensiones de PHP se cargan al inicio. Un carácter de comentario (punto y coma) al principio de la línea de extensión impedirá que se cargue. La línea que busca es extension=mysqli.

• Acceda a su servidor mediante FTP o SSH.
• Localiza tu archivo php.ini. Las rutas comunes incluyen /etc/php/8.1/apache2/php.ini o /etc/php.ini.
• Busque la línea: ;extension=mysqli
• Elimina el punto y coma para descomentarlo: extension=mysqli
• Guarda el archivo y reinicia tu servidor web.

Si tu proveedor de hosting restringe el acceso directo a php.ini, crea un .user.ini en el directorio raíz de WordPress. Añade extension=mysqli y guarda el archivo. PHP detectará .user.ini automáticamente este archivo

Método 6: Resolver conflictos de múltiples versiones de PHP

En servidores que ejecutan varias versiones de PHP, es posible que WordPress se asigne a la versión incorrecta. Si esa versión no incluye MySQLi, aparece el error.

Para resolver esto:

• Confirma qué versión de PHP está utilizando tu sitio (a través de phpinfo() como se describe en el Método 4).

• En cPanel, abre el Administrador de MultiPHP y asigna la versión correcta de PHP a tu dominio.

• Abra Select PHP Extensions y asegúrese de que mysqli esté habilitado para esa versión específica.

En un servidor autogestionado, utilice `php -v` en la terminal para confirmar la versión activa y `php -m | grep mysqli` para confirmar si MySQLi está cargado para ese binario. Si `php -m | grep mysqli` no devuelve nada, la extensión no está disponible para esa versión.

Método 7: Reinstalar PHP y las extensiones necesarias

Si falla la activación de MySQLi, es posible que la instalación de PHP esté dañada. Una reinstalación limpia de PHP y del módulo mysqli soluciona el problema.

En Ubuntu o Debian:

sudo apt purge php8.1 php8.1-mysql sudo apt install php8.1 php8.1-mysqli sudo service apache2 restart

En CentOS o RHEL:

sudo yum remove php php-mysql sudo yum install php php-mysqli sudo systemctl restart httpd

Tras reinstalar, ejecuta `php -m | grep mysqli` en tu terminal para confirmar que la extensión está activa. Deberías ver "mysqli" en la salida.

Método 8: Comprobar la configuración de la pila del servidor (Apache o Nginx y MySQL)

Tu servidor web debe enrutar correctamente las solicitudes PHP al intérprete PHP adecuado. Una configuración incorrecta puede impedir que las extensiones se carguen, incluso si están instaladas.

• Para Apache: Verifique que mod_php o php-fpm estén configurados correctamente. Apache mod_php carga PHP como un módulo directamente, mientras que PHP-FPM se ejecuta como un proceso independiente. Compruebe la configuración de su VirtualHost para confirmar que se haya asignado el controlador PHP correcto.

• Para Nginx: Nginx no ejecuta PHP de forma nativa y siempre requiere PHP-FPM. Confirme que la fastcgi_pass en su bloque de servidor apunta al archivo de socket PHP-FPM correcto. Asegúrese de que el grupo de PHP-FPM esté ejecutando la versión compatible con MySQLi.

Tras realizar cualquier cambio, reinicie tanto el servidor web como PHP-FPM:

sudo systemctl restart nginx sudo systemctl restart php8.1-fpm

Leer más: Apache vs Nginx: ¿Cuál es mejor para alojar WordPress?

Método 9: Contacta con tu proveedor de alojamiento web para obtener ayuda

Si alguno de los métodos anteriores le resulta demasiado técnico, su proveedor de alojamiento web es la vía más rápida para resolver el problema. La mayoría de los servicios de alojamiento gestionado de WordPress solucionan los problemas con las extensiones PHP en cuestión de minutos como parte de su soporte estándar.

Cuando se ponga en contacto con el servicio de asistencia, incluya lo siguiente:

• El mensaje de error exacto que está viendo.

• La versión de PHP que utiliza actualmente su sitio (según phpinfo o cPanel).

• El error apareció por primera vez después de una actualización, migración o mantenimiento del servidor.

Los proveedores que ofrecen alojamiento gestionado de WordPress se encargan de las configuraciones de PHP a nivel de servidor, incluido el soporte para extensiones de PHP, en su nombre.

En el alojamiento compartido, el equipo de soporte puede habilitar MySQLi desde el servidor sin que usted tenga que hacer nada.

Solución de problemas avanzada para el error de extensión MySQL faltante en WordPress

Si los métodos estándar mencionados anteriormente no resolvieron el error, estas técnicas avanzadas pueden ayudar a identificar el problema.

Revisa tu archivo wp-config.php. Incluso con MySQLi instalado, unas credenciales de base de datos incorrectas en tu archivo wp-config.php impedirán la conexión. Abre wp-config.php y verifica la siguiente configuración de la base de datos:

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' ); define( 'DB_USER', 'nombre_de_usuario_de_tu_base_de_datos' ); define( 'DB_PASSWORD', 'contraseña_de_tu_base_de_datos' ); define( 'DB_HOST', 'localhost' );

Un valor incorrecto en cualquiera de estos campos, especialmente en DB_HOST, puede producir errores que a primera vista parecen ser errores de extensión faltante.

Algunos proveedores de alojamiento web utilizan un nombre de host específico en lugar de localhost, y usar un valor incorrecto bloquea la conexión incluso cuando MySQLi está correctamente instalado.

Habilita el modo de depuración de WordPress. Agrega estas líneas a tu wp-config.php para activar la generación de informes de errores detallados. WP_DEBUG_LOG guarda todos los errores en un archivo en lugar de mostrarlos públicamente:

define( 'WP_DEBUG', verdadero ); define( 'WP_DEBUG_LOG', verdadero ); define( 'WP_DEBUG_DISPLAY', falso );

El archivo WP_DEBUG_LOG se guarda en wp-content/debug.log. Busque mensajes relacionados con extensiones de PHP o errores de inicio de PHP en este archivo. Las líneas que mencionan mysqli_connect, Llamada a una función indefinidao nombres de módulos faltantes indican directamente el problema con la extensión.

Revise los registros de errores del servidor. Apache almacena los registros de errores en /var/log/apache2/error.log. Nginx utiliza /var/log/nginx/error.log. Estos registros de errores del servidor suelen capturar la razón exacta por la que una extensión de PHP no se cargó correctamente, como la falta de una biblioteca compartida, una de extension_dir o un problema de permisos de archivo que impide que se lea la extensión.

Compruebe si hay software de seguridad conflictivo. Los firewalls de aplicaciones web (WAF), las herramientas antivirus a nivel de servidor y los plugins de seguridad agresivos de WordPress pueden interferir ocasionalmente con la carga de extensiones PHP o bloquear las solicitudes de establecimiento de conexión con la base de datos. Desactívelos temporalmente y vuelva a probar. Si el error desaparece, la herramienta de seguridad era la causa. Vuelva a activarla y añada el puerto de conexión a la base de datos (normalmente el 3306) a la lista blanca para restablecer la protección sin el conflicto.

Prueba en un entorno de prueba. Nunca pruebes cambios a nivel de servidor directamente en un sitio web en producción. Utiliza un entorno de prueba para aplicar y verificar las correcciones antes de implementarlas en producción. La mayoría de los proveedores de alojamiento administrado incluyen el entorno de prueba en sus planes.

Buenas prácticas para prevenir errores de extensión de MySQL en WordPress

La prevención siempre es más económica y menos estresante que la recuperación. Estas prácticas reducen la probabilidad de que este error aparezca en tu sitio de WordPress.

• Mantén PHP actualizado y compatible con los requisitos de WordPress. Utiliza siempre una versión de PHP que cumpla con las recomendaciones actuales de WordPress (PHP 8.1 o superior a partir de 2024-2025). Al actualizar PHP, verifica que todas las extensiones necesarias, MySQLi y PDO_MySQL estén incluidas explícitamente en la nueva instalación. Consulta la página oficial de requisitos de PHP de WordPress antes de cada actualización.

• Prueba las actualizaciones de PHP en un entorno de prueba. Antes de actualizar PHP en tu sitio web en producción, ejecuta la nueva versión en un entorno de prueba. Realiza una prueba de compatibilidad de WordPress con PHP utilizando herramientas como el plugin PHP Compatibility Checker. Confirma que MySQLi se carga correctamente y que todos los plugins y temas siguen siendo compatibles antes de implementar los cambios en producción.

• Utilice un servicio de alojamiento administrado de WordPress. Los proveedores de alojamiento administrado se encargan automáticamente de la configuración de PHP a nivel de servidor. Mantienen PHP y sus extensiones actualizados y configurados correctamente, lo que reduce considerablemente la probabilidad de sufrir este tipo de errores.

• Realiza copias de seguridad periódicas de tu sitio web. Mantén siempre copias de seguridad actualizadas tanto de tus archivos de WordPress como de tu base de datos. Si un cambio en el servidor provoca este error, una copia de seguridad te permite restaurar un estado funcional mientras solucionas la causa raíz.

• Supervisa tu sitio con el monitoreo de disponibilidad. El monitoreo de disponibilidad de WordPress en tiempo real te alerta en el momento en que tu sitio se desconecta. Una alerta de inactividad significa que detectas un error de extensión de MySQL en minutos en lugar de horas. Minimizar el tiempo de inactividad protege a tus visitantes, tu posicionamiento en buscadores y tus ingresos.

• Documenta la configuración de tu servidor. Si administras tu propio servidor, mantén registros detallados de todas las extensiones y configuraciones de PHP que utilizas. Esta documentación facilita enormemente la replicación del entorno tras migraciones o actualizaciones importantes.

• Sigue una rutina de mantenimiento regular para WordPress. Una rutina de mantenimiento estructurada, que incluya actualizaciones del núcleo, plugins y temas, comprobaciones de la versión de PHP y optimización de la base de datos de WordPress, previene desajustes en la configuración y detecta problemas de compatibilidad antes de que provoquen errores en el sitio web. Programa una revisión mensual de tu configuración de PHP junto con tus tareas de mantenimiento habituales.

Reflexiones finales

El error "Parece que a tu instalación de PHP le falta la extensión MySQL" es molesto, pero tiene solución. En la mayoría de los casos, el problema se debe a que la extensión MySQLi está deshabilitada o falta en la configuración de PHP; se trata de un problema con las extensiones de la base de datos de PHP, no con WordPress.

Empieza por la vía más sencilla: comprueba si MySQLi está habilitado en tu panel de control de hosting y, si no lo está, habilítalo. Si esto no resuelve el problema, sigue los pasos en orden: revisa tu versión de PHP, edita php.ini con extension=mysqliy, si es necesario, reinstala PHP.

Cuando los cambios a nivel de servidor escapan a tus conocimientos, tu proveedor de alojamiento web suele poder solucionarlos en cuestión de minutos.

Más importante aún, crea las condiciones adecuadas para evitar que este error se repita. Mantén PHP actualizado, utiliza un alojamiento WordPress gestionado y comprométete con un mantenimiento regular. Un sitio WordPress bien mantenido evita la mayoría de estos errores antes de que lleguen a tus visitantes y se recupera rápidamente cuando ocurren.

Preguntas frecuentes sobre cómo solucionar el error "Parece que a tu instalación de PHP le falta la extensión MySQL"