1. Web Design
  2. WordPress
  3. WordPress Hosting

Resolución de problemas de WordPress: falta la extensión MySQL en una instalación de PHP

En este artículo rápido, discutiremos cómo resolver el error "missing the MySQL extension" ("falta la extensión MySQL") al instalar WordPress.
Scroll to top

Spanish (Español) translation by Ana Paulina Figueroa (you can also view the original English article)

En este artículo rápido, discutiremos cómo resolver el error "missing the MySQL extension" ("falta la extensión MySQL") al instalar WordPress.

Si estás instalando WordPress, o si has movido tu sitio web a un servidor diferente, es posible que te encuentres con el siguiente error:

Your PHP installation appears to be missing the MySQL extension which is required by WordPress (Al parecer, a tu instalación de PHP le falta la extensión MySQL requerida por WordPress).

Esto puede resultar frustrante para ti, como administrador de WordPress, si no conoces la causa de este error. Hoy intentaremos analizar las posibles soluciones que podrían corregir este error.

Antes de que continuemos y discutamos las posibles soluciones, busquemos rápidamente el código que muestra este error.

1
if ( ! extension_loaded( 'mysql' ) && ! extension_loaded( 'mysqli' ) && ! extension_loaded( 'mysqlnd' )
2
        // This runs before default constants are defined, so we can't assume WP_CONTENT_DIR is set yet.

3
        && ( defined( 'WP_CONTENT_DIR' ) && ! file_exists( WP_CONTENT_DIR . '/db.php' )
4
            || ! file_exists( ABSPATH . 'wp-content/db.php' ) )
5
    ) {
6
        require_once ABSPATH . WPINC . '/functions.php';
7
        wp_load_translations_early();
8
        $args = array(
9
            'exit' => false,
10
            'code' => 'mysql_not_found',
11
        );
12
        wp_die(
13
            __( 'Your PHP installation appears to be missing the MySQL extension which is required by WordPress.' ),
14
            __( 'Requirements Not Met' ),
15
            $args
16
        );
17
        exit( 1 );
18
}

Como puedes ver, WordPress está intentando cargar un par de extensiones que están relacionadas con MySQL. Específicamente, está verificando la disponibilidad de las extensiones PHP mysql, mysqlimysqlnd. Si WordPress se encuentra con que ninguna de estas extensiones están instaladas y configuradas con tu PHP, este no podrá trabajar con tu base de datos MySQL. Y, por lo tanto, se queja para que puedas tomar las acciones necesarias para solucionarlo.

En esta publicación discutiremos las posibles soluciones que podrías utilizar para resolver este problema.

Verifica la instalación de la extensión MySQL

La causa principal de este error es la falta de disponibilidad de las extensiones PHP necesarias para las operaciones en la base de datos. Por lo tanto, lo primero es verificar si alguna de las extensiones MySQL está instalada y habilitada en tu servidor. Existen un par de formas en las que puedes hacer esto.

Primero crea un archivo info.php con el siguiente contenido.

1
<?php
2
phpinfo();
3
?>

Carga este archivo a la raíz de los documentos de tu sitio web de WordPress. A continuación, abre el URL https://tu-sitioweb-wordpress/info.php en tu navegador y este debería desplegar la información de la configuración de PHP, como se muestra en la siguiente captura de pantalla.

PhpinfoPhpinfoPhpinfo

Ahora intenta encontrar la sección de la extensión mysql o mysqli. Si alguna de estas se encuentra instalada y configurada en tu instalación de PHP, deberías poder encontrarlas como se muestra en la siguiente captura de pantalla.

Mysqli SectionMysqli SectionMysqli Section

Si no la encuentras, significa que no está instalada en tu servidor. En este caso solamente necesitas instalar la extensión mysql o mysqli y estás listo para trabajar.

Si quieres instalarla tú mismo, echa un vistazo a mi artículo que explica cómo instalar extensiones PHP específicas en tu servidor. Necesitarás tener acceso como superusuario al shell de tu servidor para poder instalarla tú mismo. Si no tienes acceso, o si no quieres meterte con la administración del servidor, puedes pedírselo a tu proveedor de alojamiento y ellos debería poder hacerlo por ti con bastante rapidez.

En la mayoría de los casos esta es la causa principal de este error. Después de instalar la extensión necesaria, tu sitio de WordPress debería comenzar a funcionar.

Por otro lado, si descubres que las extensiones necesarias están instaladas y configuradas adecuadamente, y aún así obtienes este error, puedes revisar la siguiente sección para ver si eso funciona para ti.

Verifica la versión de WordPress

Puede ser que estés ejecutando una versión antigua de WordPress, pero que PHP y las extensiones relacionadas estén actualizadas a la versión más reciente en tu servidor. Por ejemplo, si moviste tu sitio a un nuevo proveedor de alojamiento, esto podría causar una incompatibilidad entre tus versiones de WordPress y PHP.

Si descubres que estás ejecutando una versión antigua de WordPress, te recomendaría que actualices tu sitio a la versión más reciente. Cuando actualizas tu WordPress, este reemplaza los archivos antiguos con archivos nuevos y eso podría corregir este error. Puedes aprender cómo actualizar tu versión de WordPress en este artículo.

Claro que, incluso si no tienes ningún error, se recomienda que actualices tu WordPress periódicamente a la versión estable más reciente. Esto te ayudará a protegerte contra cualquier vulnerabilidad de seguridad que pueda existir en la versión anterior de WordPress.

Conclusión

Hoy discutimos un par de posibles soluciones para el error "missing the MySQL extension" ("falta la extensión MySQL") en WordPress. ¡Hazme saber en los comentarios a continuación si tienes alguna otra pregunta! Y echa un vistazo a algunas de nuestras otras publicaciones para obtener más trucos y consejos de WordPress.