Conectar WordPress a Base de Datos MySQL | Guía Completa

¿Te ha pasado que instalas WordPress y te aparece el temido mensaje de "Error al establecer conexión con la base de datos"? No te preocupes, es uno de los problemas más comunes al montar una web, pero también uno de los más fáciles de solucionar si sabes qué estás haciendo.

En esta guía completa, paso a paso y sin tecnicismos innecesarios, vamos a explicarte cómo conectar WordPress a una base de datos MySQL ya sea usando cPanel, Plesk o DirectAdmin.

Aquí no solo verás dónde hacer clic, sino que entenderás qué significa cada dato que te pide WordPress. Al final, serás capaz de configurar tu wp-config.php con los ojos cerrados y sabrás qué hacer si algo sale mal.

Vamos a ello.

¿Qué necesitas antes de empezar?

Antes de lanzarnos a configurar nada, es importante que tengas a mano dos o tres cosas. No te asustes, son básicas.

Para conectar WordPress a MySQL necesitas cuatro datos imprescindibles:

Nombre de la base de datos (Database Name).
Usuario de la base de datos (Database User).
Contraseña de ese usuario (Database Password).
Host de la base de datos (Database Host).

Piensa en ello como si fueran las llaves de tu casa. Sin ellas, WordPress no puede entrar a guardar sus cosas (artículos, usuarios, comentarios) dentro de la base de datos.

[INFO]
El "Host de la base de datos" suele ser localhost en el 99% de los casos, pero a veces (sobre todo en hosting compartido) es algo como mysql.tudominio.com o localhost:/tmp/mysql5.sock. Lo veremos más adelante.

Paso 1: Crear la base de datos y el usuario

Primero lo primero. Necesitas tener una base de datos vacía y un usuario con permisos para usarla. Esto se hace desde el panel de control de tu hosting. Vamos a ver los tres casos más comunes.

Opción A: Configurar WordPress con cPanel

cPanel es el panel más popular del mundo. Si tu hosting lo usa, sigue estos pasos:

Inicia sesión en tu cPanel (normalmente en tudominio.com/cpanel).
Busca la sección "Bases de Datos" y haz clic en "Asistente para Bases de Datos MySQL" (o "MySQL Database Wizard"). Es la opción más fácil porque te guía paso a paso.
Paso 1: Escribe un nombre para tu base de datos. El sistema añadirá automáticamente un prefijo con tu nombre de usuario (ej. usuario_wpdb). Haz clic en "Siguiente".
Paso 2: Crea un usuario para esa base de datos. Elige un nombre (ej. usuario_wpuser) y una contraseña segura. cPanel tiene un botón para generar una contraseña aleatoria y segura. Guárdala en un lugar seguro.
Paso 3: Marca la casilla "TODOS LOS PRIVILEGIOS" (o "ALL PRIVILEGES") y haz clic en "Siguiente".

¡Listo! Ya tienes tu base de datos y tu usuario creados. Anota el nombre completo de la base y el nombre completo del usuario (con el prefijo), ya que los necesitarás en el paso 2.

[TIP]
Si prefieres hacerlo manualmente, también puedes usar "MySQL Databases" en cPanel. Primero creas la base de datos, luego el usuario, y finalmente añades el usuario a la base de datos con "ALL PRIVILEGES".

Opción B: Configurar WordPress con Plesk

Plesk tiene una interfaz más moderna y limpia. El proceso es ligeramente distinto:

Accede a tu panel de Plesk.
En el menú lateral izquierdo, busca la sección "Bases de Datos" dentro de tu dominio.
Haz clic en "Agregar base de datos" (o "Add Database").
Rellena el campo "Nombre de la base de datos" (ej. wordpress_db).
En el apartado de "Usuario de base de datos", marca la opción "Crear nuevo usuario" e introduce el nombre de usuario y una contraseña segura.
Asegúrate de que el "Tipo de base de datos" sea MySQL.
Haz clic en "Aceptar" o "OK".

Plesk suele crear automáticamente el usuario y otorgarle todos los privilegios sobre esa base de datos. No necesitas hacer nada más.

Opción C: Configurar WordPress con DirectAdmin

DirectAdmin es otro panel muy común, especialmente en servidores VPS. Así se hace:

Inicia sesión en tu DirectAdmin.
Busca el icono de "MySQL Management" (o "Gestión de MySQL").
Haz clic en "Create new database" (o "Crear nueva base de datos").
Introduce un nombre para la base de datos (ej. wordpress_db).
Añade un usuario (ej. wp_user).
Escribe una contraseña para ese usuario.
Haz clic en "Create" (o "Crear").

DirectAdmin crea la base de datos, el usuario y le da todos los permisos en un solo paso. Es muy directo.

[INFO]
Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar a DirectAdmin. Accede a tu panel a través del puerto 2106 (ej. https://tudominio.com:2106). Busca la sección "Bases de Datos" y crea una nueva. Tendrás que especificar el nombre de la base, el usuario y la contraseña. Syspanel también te dará todos los privilegios automáticamente.

Paso 2: Configurar el archivo `wp-config.php`

Ahora viene la parte más importante. Este archivo es el "cerebro" que le dice a WordPress cómo conectarse a tu base de datos.

¿Dónde está el archivo?

Este archivo se encuentra en la raíz de tu instalación de WordPress. Es decir, en la carpeta donde tienes instalado WordPress, normalmente en public_html, htdocs o www.

Puedes editarlo de dos maneras:

Desde el panel de hosting: Usa el "Administrador de archivos" (File Manager) de cPanel, Plesk o DirectAdmin. Navega hasta la carpeta raíz y busca el archivo wp-config.php.
Desde FTP: Conecta con un cliente FTP (como FileZilla) y descarga el archivo a tu ordenador para editarlo con un editor de texto plano (como Notepad++ o Sublime Text).

Editando el archivo

Una vez que tengas el archivo abierto, verás un montón de código PHP. No te asustes. Solo tienes que buscar una sección concreta que dice:

// ** Configuración de la base de datos ** //
define( 'DB_NAME', 'nombre_de_la_base_de_datos' );
define( 'DB_USER', 'usuario_de_la_base_de_datos' );
define( 'DB_PASSWORD', 'contraseña_de_la_base_de_datos' );
define( 'DB_HOST', 'localhost' );

Ahora, sustituye los valores con los datos que creaste en el Paso 1:

DB_NAME: Pega aquí el nombre exacto de la base de datos que creaste (incluyendo el prefijo que te añadió el panel, ej. usuario_wpdb).
DB_USER: Pega aquí el nombre exacto del usuario que creaste (ej. usuario_wpuser).
DB_PASSWORD: Pega aquí la contraseña que elegiste para ese usuario.
DB_HOST: En la mayoría de los casos, déjalo como localhost. Pero si tu hosting es un poco especial, lo encontrarás en la sección de "Base de Datos" de tu panel. A veces es algo como mysql.tudominio.com o localhost:/tmp/mysql5.sock. Si no estás seguro, usa localhost primero.

[WARNING]
¡IMPORTANTE! No edites este archivo con un procesador de texto como Word o Google Docs, ya que pueden añadir caracteres invisibles que rompan el código. Usa siempre un editor de texto plano.

Ejemplo real

Imagina que en cPanel creaste la base hola_wpdb y el usuario hola_wpuser con la contraseña MiClaveSecreta#2023.

Tu configuración en wp-config.php debería verse así:

define( 'DB_NAME', 'hola_wpdb' );
define( 'DB_USER', 'hola_wpuser' );
define( 'DB_PASSWORD', 'MiClaveSecreta#2023' );
define( 'DB_HOST', 'localhost' );

Guarda el archivo y súbelo de vuelta si lo estabas editando en tu ordenador.

Paso 3: Probar la conexión

Una vez que has guardado el archivo, es hora de la verdad. Abre tu navegador y visita la URL de tu sitio web.

Si todo está bien: Verás la pantalla de instalación de WordPress (si es una instalación nueva) o tu sitio web funcionando con normalidad (si es una instalación existente).
Si algo falla: Verás un mensaje de error. No te preocupes, es normal y vamos a solucionarlo.

Solucionar el error de conexión a la base de datos

Es el error más frustrante, pero casi siempre tiene una solución sencilla. Aquí tienes las causas más comunes y cómo arreglarlas.

1. Error: "Error al establecer conexión con la base de datos"

Este es el error genérico. Significa que WordPress no ha podido comunicarse con tu base de datos. Las causas más comunes son:

Datos incorrectos en wp-config.php: Revisa una y otra vez el nombre de la base de datos, el usuario y la contraseña. Un simple error tipográfico es la causa número uno. Recuerda que los nombres suelen tener prefijos.
El host es incorrecto: Si no es localhost, prueba a cambiarlo. A veces, la información del host está en el correo de bienvenida de tu hosting o en el panel de control. Busca "Database Host" o "MySQL Host".
La base de datos no existe: Asegúrate de que realmente la creaste en el paso 1.

Solución: Vuelve a abrir tu wp-config.php y verifica cada línea con los datos exactos de tu panel de control.

2. Error: "Error al conectar con la base de datos" (con más detalle)

A veces el error te da más pistas, como:

"Unknown database" (Base de datos desconocida): El nombre de la base de datos es incorrecto. Vuelve a mirarlo en tu panel.
"Access denied for user" (Acceso denegado para el usuario): El usuario o la contraseña son incorrectos, o el usuario no tiene permisos sobre esa base de datos. Revisa que hayas marcado "ALL PRIVILEGES" en cPanel o que el usuario esté asociado a la base en Plesk/DirectAdmin.
"Connection refused" (Conexión rechazada): El host de la base de datos es incorrecto. Prueba con localhost o busca el host correcto en tu panel.

3. Error: "No se pudo seleccionar la base de datos"

Este error indica que WordPress encontró el servidor MySQL, pero no pudo elegir la base de datos que le indicaste.

Solución: Es casi seguro que el nombre de la base de datos en DB_NAME no coincide exactamente con el que creaste en el panel. Verifica que has incluido el prefijo correcto.

Configurar WordPress cPanel, Plesk o DirectAdmin: Resumen rápido

Para que no se te olvide, aquí tienes una tabla resumen de los pasos:

Panel de Control	Crear Base de Datos	Crear Usuario	Asignar Privilegios	Archivo a Editar
cPanel	"MySQL Database Wizard"	Se crea en el wizard	"ALL PRIVILEGES"	`wp-config.php`
Plesk	"Add Database"	Se crea en el mismo paso	Automático	`wp-config.php`
DirectAdmin	"MySQL Management"	Se crea en el mismo paso	Automático	`wp-config.php`
Syspanel (HestiaCP)	"Bases de Datos"	Se crea en el mismo paso	Automático	`wp-config.php`

[INFO]
El puerto de acceso para el panel de Syspanel es el 2106. No lo olvides si tu hosting lo usa.

Preguntas frecuentes (FAQ)

Aquí tienes las dudas más habituales que nos encontramos en soporte.

¿Qué es `localhost` en WordPress?

localhost es un nombre especial que le dice a WordPress que la base de datos está en el mismo servidor que el sitio web. Es lo más común en hosting compartido.

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

Técnicamente puedes, pero no es recomendable. Mezclarías los datos de dos sitios en la misma tabla, lo que puede causar conflictos y errores. Es mucho mejor crear una base de datos separada para cada instalación.

¿Cómo cambio la contraseña de la base de datos?

Puedes cambiarla desde tu panel de control (cPanel, Plesk, DirectAdmin). Importante: Si cambias la contraseña, también debes actualizarla en el archivo wp-config.php de tu WordPress, o tu sitio dejará de funcionar.

¿Qué es el prefijo de la base de datos?

Es un identificador que añade tu panel de control al nombre de tu base de datos y usuario para evitar conflictos con otros usuarios en el mismo servidor. Por ejemplo, si tu usuario de cPanel es juan, tu base de datos se llamará juan_wpdb.

¿Por qué me sale "Error al conectar con la base de datos" después de mover mi web a otro hosting?

Porque los datos de conexión (nombre de usuario, contraseña, host) han cambiado. Debes editar el archivo wp-config.php con los nuevos datos que te haya proporcionado el nuevo hosting.

¿Necesito conocimientos de PHP para hacer esto?

No. Solo necesitas saber editar un archivo de texto y reemplazar cuatro líneas. Es un proceso muy mecánico. Si sigues esta guía, lo harás sin problemas.

¿Qué pasa si no tengo acceso a cPanel, Plesk o DirectAdmin?

Entonces necesitarás acceder a tu servidor por SSH (si sabes lo que es) o contactar con tu proveedor de hosting para que te cree la base de datos y el usuario. Es la opción más segura si no tienes experiencia técnica.

¿Cómo sé si mi WordPress se está conectando a la base de datos correctamente?

Si tu sitio web carga sin errores y puedes iniciar sesión en el panel de administración (/wp-admin), entonces la conexión es correcta. Si hay problemas, verás los mensajes de error que hemos comentado.

Esperamos que esta guía te haya sido de gran ayuda. Como ves, conectar WordPress a una base de datos MySQL no es magia, es solo cuestión de poner los datos correctos en el lugar correcto.

Si has seguido todos los pasos y todavía tienes problemas, no dudes en contactar con tu proveedor de hosting. Ellos pueden verificar la configuración de tu servidor y ayudarte a resolver cualquier problema de permisos o de red. ¡Buena suerte con tu WordPress!