Configurar wp-config.php: Conexión a base de datos en WordPress

¿Te ha pasado que intentas entrar a tu WordPress y de repente ves un mensaje que dice "Error al establecer la conexión con la base de datos"? No te asustes. Es uno de los problemas más comunes, pero también de los más fáciles de solucionar si sabes dónde mirar.

En este artículo, vamos a desglosar, paso a paso y sin tecnicismos innecesarios, cómo configurar la conexión de WordPress a tu base de datos. Vamos a hablar de ese archivo mágico llamado wp-config.php, de las constantes DB_NAME y DB_USER, y de cómo evitar los errores más frecuentes.

Al final de esta guía, no solo sabrás arreglar el problema, sino que entenderás por qué ocurre. Vamos a ello.

¿Qué es exactamente la conexión a la base de datos?

Piensa en WordPress como un coche. La base de datos es el motor. Sin motor, el coche no se mueve. WordPress necesita hablar constantemente con la base de datos para guardar tus artículos, comentarios, usuarios y configuraciones. Esa "conversación" se establece mediante un archivo de configuración.

Si esa comunicación falla, WordPress se queda bloqueado y te muestra el famoso error de conexión.

¿Dónde se guardan los datos de conexión?

Todos los datos que WordPress necesita para encontrar y conectarse a la base de datos viven en un archivo llamado wp-config.php. Este archivo se encuentra en la raíz de tu instalación de WordPress (la carpeta principal donde están los archivos como index.php o wp-admin).

Es el archivo más importante de configuración. Ahí le dices a WordPress: "Oye, la base de datos está en esta dirección, se llama así, el usuario es este y la contraseña es esta otra".

Las 4 constantes clave: DB_NAME, DB_USER, DB_PASSWORD y DB_HOST

Dentro de wp-config.php, hay cuatro líneas de código que son las protagonistas. Son las que definen la conexión base de datos WordPress.

Se ven así:

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'tu_contraseña_super_secreta' );
define( 'DB_HOST', 'localhost' );

Vamos a explicar cada una para que no te pierdas:

DB_NAME: Es el nombre de la base de datos. Es como el apellido de tu sitio. Si tienes un panel de control como cPanel o Syspanel, lo verás listado en la sección de bases de datos MySQL.
DB_USER: Es el nombre de usuario que tiene permiso para entrar a esa base de datos. No es tu usuario de administrador de WordPress, es un usuario de la base de datos.
DB_PASSWORD: Es la contraseña de ese usuario de la base de datos.
DB_HOST: Es la dirección del servidor donde vive la base de datos. En el 90% de los casos, esto es localhost, pero a veces, si usas un hosting externo o una base de datos separada, puede ser una IP o un nombre de servidor como mysql.servidor.com.

[INFO] No confundas el usuario de la base de datos con el usuario administrador de tu WordPress. Son cosas totalmente diferentes. El usuario de la base de datos es como la llave física de la puerta del almacén, y el usuario de WordPress es la llave del coche.

¿Cómo editar el archivo wp-config.php de forma segura?

Antes de tocar nada, haz una copia de seguridad del archivo original. Es tu red de seguridad. Puedes descargarlo por FTP o desde el administrador de archivos de tu panel de hosting.

Para editar el archivo, tienes dos opciones:

Usar el administrador de archivos del hosting: Entra a tu panel de control (cPanel, Syspanel, etc.), busca "Administrador de archivos" o "File Manager", navega hasta la raíz de tu WordPress, busca wp-config.php, haz clic derecho y selecciona "Editar".
Usar un cliente FTP: Conecta con FileZilla o similar, navega a la carpeta raíz, descarga el archivo, edítalo con un editor de texto plano (como Notepad++ o Sublime Text) y súbelo de nuevo.

[WARNING] Nunca uses el Bloc de notas de Windows para editar este archivo. Puede añadir caracteres invisibles que rompan el código. Usa un editor de código o un editor de texto plano avanzado.

Paso a paso: Configurar los datos en wp-config.php

Supongamos que ya tienes los datos de tu base de datos a mano. Sigue estos pasos:

Abre el archivo wp-config.php con tu editor.
Busca las líneas que empiezan con define( 'DB_NAME' y las siguientes.
Sustituye los valores entre comillas simples por los tuyos.
Guarda el archivo y súbelo de vuelta al servidor (si lo estabas editando localmente).

Eso es todo. Si los datos son correctos, tu WordPress debería volver a la vida.

Los errores más comunes y cómo solucionarlos

Aquí es donde la cosa se pone interesante. Vamos a ver los errores típicos que te puedes encontrar y qué significan.

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

Este es el clásico. Puede significar varias cosas:

Los datos son incorrectos: Has copiado mal el nombre de la base de datos, el usuario o la contraseña. Revisa que no haya espacios extra o caracteres raros.
El servidor de la base de datos no está disponible: A veces el servidor MySQL se cae o está sobrecargado. Espera unos minutos y vuelve a intentarlo.
El DB_HOST es incorrecto: Si tu hosting usa un host específico y has puesto localhost, no funcionará. Revisa la documentación de tu proveedor de hosting.

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

Este error es más específico. Significa que WordPress se ha conectado al servidor, pero no encuentra la base de datos que le has indicado en DB_NAME.

El nombre está mal escrito: Revisa la ortografía. Las mayúsculas y minúsculas importan.
La base de datos no existe: Puede que la hayas borrado por accidente, o que esté en otro servidor. Ve a tu panel de control y verifica que la base de datos esté ahí.

Error: "El usuario no tiene acceso a la base de datos"

Aquí el problema es de permisos. El usuario DB_USER no tiene privilegios para entrar en la base de datos DB_NAME.

Entra en tu panel de control de hosting.
Busca la sección de bases de datos MySQL.
Asegúrate de que el usuario esté asignado a la base de datos y que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

El error de los "saltos de línea" o "headers already sent"

Esto es un poco más raro, pero ocurre. Si editas el archivo y lo guardas con una codificación incorrecta (como UTF-8 con BOM), puede añadir caracteres invisibles que rompan la conexión.

Abre el archivo en tu editor.
Ve a "Codificación" o "Encoding" y asegúrate de que sea UTF-8 sin BOM.
Guarda y vuelve a subir.

Configurar WordPress desde el panel de control (Syspanel)

Si tu hosting usa Syspanel, el proceso para crear y gestionar la base de datos es muy visual. Recuerda, para acceder a Syspanel, la URL es la de tu dominio seguida de :2106 (por ejemplo, https://tudominio.com:2106).

Dentro de Syspanel, busca la sección "Bases de Datos". Ahí podrás:

Crear una nueva base de datos y un usuario asociado.
Ver los datos de conexión (nombre de la base, usuario y host).
Asignar el usuario a la base de datos con todos los privilegios.

Una vez que tengas esos datos, solo tienes que rellenarlos en tu wp-config.php como te hemos explicado antes.

[TIP] En Syspanel, el DB_HOST suele ser localhost, pero si tienes dudas, busca la sección de "Información de la base de datos" o contacta con el soporte de tu hosting.

¿Qué pasa si he olvidado mi contraseña de la base de datos?

No pasa nada, es más común de lo que crees. Puedes cambiarla desde tu panel de control.

Ve a la sección de bases de datos MySQL de tu hosting (cPanel, Syspanel, etc.).
Busca el usuario de la base de datos.
Elige la opción "Cambiar contraseña".
Crea una nueva contraseña segura.
Actualiza el archivo wp-config.php con la nueva contraseña.

[WARNING] Cambiar la contraseña de la base de datos romperá la conexión hasta que actualices el wp-config.php. Hazlo todo en el mismo momento para minimizar el tiempo de inactividad.

Consejos de seguridad y buenas prácticas

Configurar la conexión base de datos WordPress no es solo poner los datos y listo. Hay que tener cuidado.

No uses la cuenta "root" de la base de datos

Siempre crea un usuario específico para tu WordPress con los permisos mínimos necesarios. Esto limita el daño si tu sitio es hackeado.

Guarda el archivo wp-config.php fuera de la raíz

Puedes mover el archivo wp-config.php a un directorio por encima de la raíz de tu WordPress. WordPress lo buscará automáticamente. Esto añade una capa extra de seguridad, ya que no será accesible desde el navegador.

Mantén tus credenciales seguras

Nunca compartas tu contraseña de la base de datos por correo electrónico o en foros. Guárdala en un gestor de contraseñas.

Preguntas frecuentes (FAQ) sobre la conexión

Aquí tienes algunas de las dudas más habituales que nos llegan al soporte.

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

Técnicamente sí, pero no es recomendable. Cada WordPress necesita sus propias tablas. Si usas la misma base, puedes tener conflictos de datos y problemas de rendimiento. Es mejor una base de datos por sitio.

¿Qué hago si el error persiste después de revisar todo?

Revisa los logs de error del servidor. En cPanel o Syspanel, busca la sección "Registros de errores" o "Error Logs". Ahí verás el error exacto de MySQL, que te dará una pista más precisa.

¿Necesito reiniciar algo después de cambiar wp-config.php?

No. WordPress lee el archivo wp-config.php en cada petición. Solo tienes que guardar los cambios y recargar la página. No es necesario reiniciar ningún servicio.

¿Y si mi hosting usa un `DB_HOST` diferente a `localhost`?

Es fácil de saber. Si al configurar con localhost te da error, es muy probable que necesites un host específico. Revisa el correo de bienvenida de tu hosting o la documentación de soporte. A menudo, si tienes un plan de hosting compartido, el host suele ser una URL como mysql.tudominio.com.

¿Por qué aparece "Error de conexión" de repente si no he tocado nada?

Puede ser por varias razones: el servidor de la base de datos se reinició, hubo un pico de tráfico que saturó el servidor, o el proveedor de hosting hizo un cambio de servidor y olvidó actualizar los datos de conexión. Lo primero es comprobar si el servicio de MySQL está activo desde tu panel de control.

Resumen final

Configurar la conexión de WordPress a la base de datos es un proceso sencillo una vez que entiendes qué es cada cosa. Recuerda los puntos clave:

El archivo wp-config.php es el centro de todo.
Las constantes DB_NAME, DB_USER, DB_PASSWORD y DB_HOST son las que debes revisar.
La mayoría de los errores se deben a datos mal escritos o a permisos incorrectos.
Usa siempre un editor de texto plano avanzado.
Si tienes Syspanel, recuerda que el acceso es por el puerto 2106.

Con esta guía, ya tienes las herramientas para solucionar el 99% de los problemas de conexión a la base de datos. No tengas miedo de mirar el archivo de configuración; es tu aliado, no tu enemigo.

Si has seguido todos los pasos y aún tienes problemas, no dudes en contactar con el soporte de tu hosting. Les puedes decir: "He revisado mi wp-config.php y las constantes DB_NAME y DB_USER parecen correctas, pero sigo teniendo el error de conexión". Eso les dará una pista clara de que ya has hecho los deberes y agilizará la solución.

Esperamos que este artículo te haya sido de gran ayuda. Ahora ya sabes cómo domar a esa bestia llamada base de datos.