Conectar WordPress a MySQL | Guía Definitiva (cPanel, Plesk)

Conectar WordPress a una base de datos MySQL es uno de los pasos más críticos (y a la vez, más sencillos) para poner tu sitio web en marcha. Si estás leyendo esto, es probable que hayas recibido un error como "Error al establecer una conexión con la base de datos" o que estés en plena instalación de tu primer WordPress. No te preocupes, es un proceso mecánico que, una vez entendido, te llevará menos de cinco minutos.

En esta guía extensa, vamos a desglosar todo el proceso de conexión, tanto si usas cPanel como Plesk. Además, te explicaré qué es cada dato que te pide WordPress, cómo editarlos en el archivo wp-config.php y cómo solucionar los problemas más comunes. Vamos a ello.

¿Qué significa realmente "conectar WordPress a MySQL"?

Antes de ensuciarnos las manos, es vital entender qué estamos haciendo. WordPress es un software que gestiona todo tu contenido (textos, imágenes, configuraciones) y lo guarda en un sistema de archivos. Pero para que ese contenido sea dinámico y se muestre a tus visitantes, necesita un lugar donde almacenar y recuperar la información rápidamente. Ese lugar es la base de datos MySQL.

Piensa en ello como una biblioteca (tu sitio web) y un archivador (la base de datos). El archivador contiene todas las fichas de los libros (tus entradas, páginas, comentarios). WordPress (el bibliotecario) necesita saber dónde está ese archivador, qué llave usa (contraseña) y qué ficha concreta es la suya (nombre de la base de datos). Si el bibliotecario no encuentra el archivador o usa la llave equivocada, no puede mostrarte ningún libro.

Por tanto, el proceso de conexión consiste en darle a WordPress cuatro datos fundamentales:

El nombre de la base de datos (el archivador).
El usuario de la base de datos (quién tiene permiso para abrir el archivador).
La contraseña del usuario (la llave de acceso).
El host de la base de datos (la dirección física del archivador, normalmente localhost).

Todos estos datos se introducen en un archivo de configuración llamado wp-config.php, que es el cerebro de la instalación.

Paso 1: Reunir tus credenciales de acceso (antes de tocar nada)

No puedes conectar WordPress a una base de datos MySQL sin tener los datos correctos. Si ya tienes una base de datos creada, debes localizar sus credenciales. Si no la tienes, deberás crearla primero en tu panel de control. Te explico cómo hacerlo en los dos paneles más usados del mundo.

Crear y obtener datos en cPanel (WordPress)

cPanel es el panel más común en el hosting compartido. Para crear tu base de datos, sigue estos pasos:

Inicia sesión en tu cPanel (normalmente en tudominio.com/cpanel o tudominio.com:2083).
Busca la sección "Bases de Datos" y haz clic en "Asistente para Bases de Datos MySQL" o en "Bases de Datos MySQL".
Si usas el asistente, elige "Crear una base de datos". Introduce un nombre (suele añadir tu usuario de cPanel como prefijo, por ejemplo usuario_miweb). Guárdalo.
A continuación, crea un usuario para esa base de datos. Introduce un nombre de usuario (ej. usuario_adminbd) y una contraseña segura. Guarda esta contraseña en un lugar seguro, la necesitarás ahora.
El último paso del asistente es "Añadir Usuario a la Base de Datos". Selecciona tu usuario y tu base de datos, y en privilegios, elige "TODOS LOS PRIVILEGIOS". Haz clic en "Realizar cambios".

[TIP] Anota siempre estos tres datos: Nombre de la BD (ej. usuario_miweb), Usuario de la BD (ej. usuario_adminbd) y la Contraseña. No los confundas con tu usuario y contraseña de cPanel.

Crear y obtener datos en Plesk

En Plesk el proceso es igual de sencillo, aunque la interfaz es distinta:

Accede a tu Plesk (normalmente en tudominio.com:8443).
En el menú lateral izquierdo, busca la pestaña "Sitios web y dominios".
Haz clic en el dominio donde quieras instalar WordPress.
Busca la sección "Bases de datos" y haz clic en "Añadir base de datos".
Introduce un nombre para la base de datos (ej. mipagina_db). Plesk te dará la opción de crear un usuario y contraseña para esa BD directamente en el mismo formulario. Marca la casilla de "Crear usuario de base de datos" y rellena los campos.
Haz clic en "Aceptar".

En Plesk, el host de la base de datos suele ser siempre localhost. Es raro que sea un servidor remoto, pero si lo es, te lo indicará en el propio panel.

Paso 2: El archivo `wp-config.php` - El corazón de la conexión

Este archivo es el que le dice a WordPress dónde y cómo conectarse. Si estás instalando WordPress desde cero, existe un archivo llamado wp-config-sample.php. Deberás renombrarlo a wp-config.php o copiar su contenido. Si ya tienes WordPress instalado y estás intentando arreglar la conexión, ya tienes este archivo.

Para editarlo, tienes dos opciones:

Desde el administrador de archivos de cPanel/Plesk: Navega hasta la carpeta public_html (o httpdocs en Plesk). Busca el archivo wp-config.php o wp-config-sample.php. Haz clic derecho y elige "Editar" o "Edit".
Desde un cliente FTP: Conecta con FileZilla o similar, descarga el archivo, edítalo con un editor de texto plano (como Notepad++ o Sublime Text) y súbelo de nuevo.

Una vez abierto, busca el bloque que dice:

// ** Configuraciones de MySQL - Puedes obtener esta información de tu proveedor de hosting ** //
/** Nombre de la base de datos de WordPress */
define( 'DB_NAME', 'nombre_base_datos' );

/** Usuario de la base de datos de MySQL */
define( 'DB_USER', 'usuario_base_datos' );

/** Contraseña de la base de datos de MySQL */
define( 'DB_PASSWORD', 'contraseña_base_datos' );

/** Host de la base de datos MySQL */
define( 'DB_HOST', 'localhost' );

Aquí es donde debes introducir los datos que has creado en el Paso 1.

DB_NAME: Sustituye nombre_base_datos por el nombre exacto que creaste (ej. usuario_miweb).
DB_USER: Sustituye usuario_base_datos por el usuario que creaste (ej. usuario_adminbd).
DB_PASSWORD: Sustituye contraseña_base_datos por la contraseña que elegiste para ese usuario.
DB_HOST: En el 99% de los casos es localhost. Déjalo así. Solo cámbialo si tu proveedor de hosting te da un host específico (a veces algo como mysql.tudominio.com).

[WARNING] NUNCA uses el usuario "root" de tu servidor para conectar WordPress. Siempre debes crear un usuario específico para la base de datos de tu sitio. Usar root es un riesgo de seguridad enorme, ya que si hackean tu WordPress, tendrían acceso a todas tus bases de datos.

Guardar y probar

Después de editar los cuatro campos, guarda el archivo. Si estabas usando el administrador de archivos, sobrescribe el archivo en el servidor. Si usabas FTP, súbelo de nuevo.

Ahora, abre tu navegador y escribe tu dominio (ej. www.tudominio.com). Si todo está correcto, verás la página de instalación de WordPress (si es nuevo) o tu sitio web funcionando.

Paso 3: Solucionar el error "Error al establecer una conexión con la base de datos"

Este es el error más común cuando hablamos de conectar WordPress a una base de datos MySQL. Suele aparecer por una de estas razones:

Credenciales incorrectas: Revisa que no haya espacios extra en los nombres o contraseñas. Copia y pega directamente desde el panel de control.
Host incorrecto: Si tu hosting usa un host diferente a localhost, te lo habrán comunicado por email. Comprueba la documentación de tu proveedor.
Permisos de usuario: Asegúrate de que el usuario de la base de datos tiene TODOS LOS PRIVILEGIOS sobre la base de datos. En cPanel, puedes ver esto en "Bases de datos MySQL" -> "Privilegios de usuario". En Plesk, en la configuración de la base de datos.

El método infalible para diagnosticar: Crea un archivo llamado test.php en la misma carpeta donde está wp-config.php. Pega este código:

<?php
$enlace = mysqli_connect("localhost", "TU_USUARIO", "TU_CONTRASEÑA", "TU_BASE_DE_DATOS");

if (!$enlace) {
    echo "Error: No se pudo conectar a MySQL." . PHP_EOL;
    echo "Error de depuración: " . mysqli_connect_error() . PHP_EOL;
    exit;
}

echo "Éxito: Se realizó una conexión apropiada a MySQL. La base de datos mi_bd es genial." . PHP_EOL;
echo "Información del host: " . mysqli_get_host_info($enlace) . PHP_EOL;

mysqli_close($enlace);
?>

Sustituye TU_USUARIO, TU_CONTRASEÑA y TU_BASE_DE_DATOS por tus datos reales. Guarda el archivo y accede a www.tudominio.com/test.php.

Si te da un error de conexión, el problema está en los datos que has puesto en el script. Ajusta los datos.
Si te da "Éxito", el problema está en que el archivo wp-config.php tiene datos diferentes a los que funcionan. Compara ambos archivos.

[WARNING] Borra el archivo test.php inmediatamente después de usarlo. Dejarlo en el servidor expone tus credenciales de la base de datos a cualquiera que conozca la URL.

Paso 4: ¿Qué pasa si cambio de hosting o muevo mi web?

Conectar WordPress a una base de datos MySQL no es solo para instalaciones nuevas. Es un proceso que tendrás que repetir si migras tu sitio.

El procedimiento es el mismo:

Exporta tu base de datos desde el panel antiguo (phpMyAdmin -> Exportar).
Crea una nueva base de datos y usuario en el nuevo panel (cPanel o Plesk).
Importa el archivo .sql que exportaste en la nueva base de datos (phpMyAdmin -> Importar).
Sube todos los archivos de WordPress al nuevo hosting.
Edita el wp-config.php con las nuevas credenciales (DB_NAME, DB_USER, DB_PASSWORD y DB_HOST).

Un error típico es olvidar cambiar el DB_HOST si el nuevo proveedor usa un host distinto. Siempre revisa el correo de bienvenida de tu nuevo hosting.

Extras: Conexión remota y otros paneles (Syspanel)

A veces, necesitas conectar WordPress a una base de datos que no está en el mismo servidor que los archivos de WordPress. Esto es raro en hosting compartido, pero común en VPS o servidores dedicados.

En ese caso, el DB_HOST no será localhost, sino una IP pública (ej. 123.456.789.123) o un nombre de dominio (ej. db.midominio.com). Para que esto funcione, el servidor de la base de datos debe tener habilitado el acceso remoto y el cortafuegos debe permitir la conexión desde la IP del servidor web.

[INFO] Si tu hosting utiliza el panel Syspanel (anteriormente conocido como HestiaCP), el proceso de creación de bases de datos es muy similar al de Plesk. Accede a tu panel Syspanel a través del puerto 2106 (ej. https://tudominio.com:2106), busca la sección "Bases de datos" y crea una nueva. El host suele ser localhost también.

Preguntas Frecuentes (FAQ) sobre conectar WordPress a MySQL

Para finalizar, resolvamos las dudas más habituales que nos llegan al soporte.

¿Por qué me pide "Prefijo de tabla" al instalar WordPress?

Eso es otra cosa. El prefijo de tabla (por defecto wp_) es para las tablas dentro de la base de datos. No tiene nada que ver con la conexión. No lo confundas con el nombre de la base de datos.

¿Puedo usar la misma base de datos para dos sitios WordPress?

Técnicamente sí, pero no es recomendable. Si usas la misma base de datos, necesitarás usar prefijos de tabla diferentes (ej. sitio1_ y sitio2_) para evitar conflictos. Es mucho más limpio y seguro crear una base de datos separada para cada instalación de WordPress.

¿Qué es phpMyAdmin y para qué sirve?

phpMyAdmin es una herramienta web que te permite gestionar tu base de datos MySQL a través de una interfaz gráfica. La encuentras en cPanel y en Plesk. Sirve para importar/exportar bases de datos, ejecutar consultas SQL y, en caso de emergencia, reparar tablas. No la necesitas para conectar WordPress, pero sí para gestionar el contenido de la BD.

Al editar `wp-config.php`, ¿puedo romper algo?

Sí, si borras una línea de más o pones un carácter extra, puedes romper el sitio. Por eso es vital usar un editor de texto plano y no un procesador de textos (como Word). Si lo rompes, siempre puedes volver a subir una copia limpia del archivo desde tu instalación original o desde el panel de control.

¿La contraseña de la base de datos es la misma que la de mi email?

No. La contraseña de la base de datos es única y la creas tú (o tu hosting) específicamente para ese usuario de MySQL. Es una práctica de seguridad clave mantenerlas separadas.

Conectar WordPress a una base de datos MySQL es un proceso lógico. Una vez que entiendes que wp-config.php es el puente entre tu sitio y el archivador de datos, todo el misterio desaparece. Espero que esta guía te haya sido de gran ayuda. Si sigues teniendo problemas, revisa los logs de errores de tu servidor o contacta con tu proveedor de hosting, pero con estos pasos, habrás resuelto el 95% de los casos. ¡Buena suerte con tu WordPress!