Configurar wp-config.php para conectar WordPress a MySQL

¿Tu sitio WordPress te muestra el temido "Error al conectar con la base de datos"? No te preocupes, es uno de los problemas más comunes y, afortunadamente, casi siempre tiene una solución sencilla.

Este error significa que WordPress no puede comunicarse con el servidor donde se guardan tus contenidos, usuarios y configuraciones. La clave para arreglarlo está en un archivo llamado wp-config.php.

En esta guía extensa y paso a paso, aprenderás qué es ese archivo, cómo funciona y cómo configurarlo correctamente para conectar tu WordPress a tu base de datos MySQL. Al final, te convertirás en un experto en este tema y podrás resolver este error por ti mismo.

¿Qué es el archivo wp-config.php y por qué es tan importante?

Piensa en WordPress como una tienda de ropa. La base de datos es el almacén donde guardas toda la mercancía (tus artículos, páginas, comentarios y ajustes). El archivo wp-config.php es el plano que le dice a la tienda dónde está el almacén y cómo abrir su puerta.

Sin este archivo, WordPress es como un empleado nuevo que no sabe dónde está el almacén: no puede mostrar nada a los clientes. Por eso, sin una configuración correcta, tu sitio web no puede funcionar.

Este archivo se encuentra en la carpeta raíz de tu instalación de WordPress (normalmente en public_html, htdocs o similar, dependiendo de tu hosting). Es el corazón de la configuración de tu sitio, ya que define no solo la conexión a la base de datos, sino también las claves de seguridad, el prefijo de las tablas y otras opciones críticas.

Preparación: Reúne tus datos de conexión a MySQL

Antes de tocar nada, necesitas tener a mano los cuatro datos principales que WordPress necesita para conectarse a tu base de datos. Normalmente los encuentras en el panel de control de tu hosting (como cPanel, Plesk o Syspanel).

1. El nombre de la base de datos (DB_NAME)

Es el nombre del "almacén". En algunos hostings, se ve como usuario_wp123 o simplemente mibasededatos.

2. El usuario de la base de datos (DB_USER)

Es el nombre de usuario que tiene permiso para entrar al almacén. A menudo es el mismo que tu usuario de hosting, pero puede ser diferente.

3. La contraseña del usuario (DB_PASSWORD)

La clave de acceso para ese usuario. Debes tener mucho cuidado con las mayúsculas, minúsculas y caracteres especiales.

4. El host de la base de datos (DB_HOST)

Es la dirección del servidor donde se encuentra la base de datos. En el 95% de los casos, será localhost, pero a veces puede ser una dirección IP o un nombre de servidor como sql.midominio.com.

[TIP] Si tu hosting tiene un panel llamado Syspanel (accesible a través del puerto 2106), busca la sección "Bases de Datos" o "MySQL". Allí podrás crear una nueva base de datos y un usuario, o ver los datos de los existentes. Es el lugar más seguro para obtener esta información.

Cómo editar el archivo wp-config.php (Métodos paso a paso)

Existen dos formas principales de editar este archivo: a través del panel de control de tu hosting o mediante un cliente FTP. Ambas son válidas; elige la que te resulte más cómoda.

Método A: Editarlo desde el Administrador de Archivos de tu Hosting

Este es el método más fácil para principiantes, ya que no requiere instalar programas adicionales.

Accede a tu panel de control de hosting. Puede ser cPanel, Plesk o Syspanel (recuerda, para Syspanel el puerto es el 2106).
Busca el Administrador de Archivos (File Manager). En cPanel suele estar en la sección "Archivos".
Navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html o htdocs.
Busca el archivo llamado wp-config.php. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Haz clic derecho sobre el archivo y selecciona Editar o Edit.
Se abrirá un editor de texto. Busca las líneas que comienzan con define('DB_NAME', define('DB_USER', define('DB_PASSWORD' y define('DB_HOST'.
Reemplaza los valores que están entre comillas simples '...' con los datos correctos que recopilaste en el paso anterior.
Guarda los cambios (normalmente con un botón "Save" o "Guardar cambios") y cierra el editor.

Método B: Editarlo con un Cliente FTP (como FileZilla)

Este método te da un control total y es útil si prefieres trabajar desde tu computadora.

Descarga e instala un cliente FTP gratuito como FileZilla.
Conéctate a tu servidor usando las credenciales FTP que te proporcionó tu hosting (normalmente son diferentes a las de la base de datos).
En el panel derecho (el servidor), navega hasta la carpeta raíz de WordPress.
Localiza el archivo wp-config.php en el panel derecho.
Haz clic derecho sobre él y selecciona "Ver/Editar" (View/Edit). Se descargará a tu computadora y se abrirá en un editor de texto.
Edita las líneas de la base de datos como se explicó en el método anterior.
Guarda el archivo en tu computadora.
Sube el archivo modificado de vuelta al servidor. FileZilla te preguntará si quieres sobrescribir el archivo existente. Acepta y confirma la acción.

[WARNING] Antes de editar cualquier cosa, siempre crea una copia de seguridad del archivo original. Puedes descargarlo a tu PC o renombrarlo en el servidor (por ejemplo, wp-config-copia.php). Si algo sale mal, podrás restaurarlo fácilmente.

Configuración paso a paso de las constantes de la base de datos

Aquí tienes un ejemplo visual de cómo deberían verse las líneas en tu archivo wp-config.php:

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

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

/** Contraseña del usuario de la base de datos MySQL */
define( 'DB_PASSWORD', 'mi_contraseña_secreta' );

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

Paso 1: Define el nombre de la base de datos (DB_NAME)

Esta es la primera línea. Asegúrate de que el valor entre las comillas simples coincida exactamente con el nombre que creaste o que te proporcionó tu hosting. Un error de una letra o un guion bajo hará que la conexión falle.

Paso 2: Define el usuario y la contraseña (DB_USER y DB_PASSWORD)

Estas dos líneas van de la mano. El usuario debe tener permisos para acceder a la base de datos que definiste en el paso anterior. Si acabas de crear la base de datos, asegúrate de haber asignado este usuario a ella con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

La contraseña es la clave de acceso. Cópiala y pégala directamente desde tu panel de hosting para evitar errores de escritura. Ten en cuenta que es sensible a mayúsculas y minúsculas.

Paso 3: Configura el host de la base de datos (DB_HOST)

Este es el paso que más confusión genera. La regla general es usar localhost, pero hay excepciones.

Usa localhost si tu base de datos está en el mismo servidor que tu sitio web. Es lo más común en la mayoría de los hostings compartidos.
Usa la dirección del servidor específico si tu hosting te ha dado una URL de base de datos separada (por ejemplo, mysql.midominio.com o db123456789.hosting.com).
Usa una dirección IP en algunos casos de hosting administrado o VPS.

[INFO] Si tu hosting utiliza Syspanel, el puerto de acceso al panel es el 2106, pero el host de la base de datos para wp-config.php no es ese puerto. Generalmente, el host de la base de datos sigue siendo localhost o la dirección que te indiquen en la sección de bases de datos de Syspanel. No confundas el puerto del panel con el puerto de MySQL (que suele ser el 3306, aunque rara vez se especifica en wp-config.php).

Errores comunes y sus soluciones (FAQ)

Aquí tienes las soluciones a los problemas más frecuentes que encontrarás al conectar WordPress con MySQL.

"Error al conectar con la base de datos" (General)

Este es el error genérico. La causa más común es un error de escritura en los datos de DB_NAME, DB_USER o DB_PASSWORD.

Solución: Revisa cada línea, carácter por carácter. Asegúrate de que no haya espacios en blanco al principio o al final de los valores. Copia y pega los datos directamente desde tu panel de control de hosting.

"No se pudo seleccionar la base de datos" (Error específico)

Este error indica que el nombre de la base de datos (DB_NAME) es incorrecto o que el usuario (DB_USER) no tiene permisos para acceder a ella.

Solución: Verifica que el nombre de la base de datos exista en tu panel de control. Luego, asegúrate de que el usuario que has definido esté vinculado a esa base de datos y tenga todos los privilegios necesarios. En muchos paneles, esto se hace en la sección "MySQL Databases" o "Bases de Datos".

"El servidor no funciona" o "No se pudo conectar al servidor MySQL"

Este error sugiere que el host (DB_HOST) es incorrecto o que el servidor de base de datos está caído.

Solución: Prueba a cambiar DB_HOST de localhost a 127.0.0.1 o viceversa. Si tu hosting te ha dado un host específico, úsalo. Si el problema persiste, contacta a tu proveedor de hosting para asegurarte de que el servicio MySQL esté activo.

"Definición de DB_HOST incorrecta" (Error avanzado)

A veces, el problema no es el valor, sino el puerto. Algunos hosts requieren que especifiques un puerto personalizado (que no es el 3306 estándar).

Solución: Añade el puerto al valor de DB_HOST de esta manera: localhost:3307 o mysql.midominio.com:3307. Reemplaza 3307 con el puerto que te indique tu hosting.

La solución definitiva: Restablecer el archivo wp-config.php

Si has probado todo y nada funciona, la solución más limpia es crear un archivo wp-config.php desde cero. WordPress tiene un instalador web que puede hacer esto por ti.

Renombra o elimina el archivo wp-config.php actual desde tu administrador de archivos o FTP.
Ve a la URL de tu sitio web (por ejemplo, www.tudominio.com).
WordPress detectará que falta el archivo y te mostrará el asistente de instalación.
Sigue los pasos: selecciona tu idioma y luego te pedirá los datos de la base de datos (nombre, usuario, contraseña, host).
Ingresa los datos correctos y continúa. WordPress creará un nuevo archivo wp-config.php automáticamente.
Si los datos son correctos, el asistente te llevará a la pantalla de instalación o te permitirá continuar con tu sitio existente.

Este método es infalible porque evita cualquier error de edición manual. Asegúrate de tener los datos de tu base de datos a mano antes de comenzar.

[WARNING] Si renombras el archivo wp-config.php, tu sitio web quedará inaccesible hasta que completes el asistente de instalación. No te preocupes, es un proceso rápido y seguro, pero asegúrate de tener tiempo para terminarlo.

Consejos de seguridad adicionales para tu wp-config.php

Una vez que tu sitio funcione, es importante proteger este archivo tan crítico.

No lo compartas nunca: Este archivo contiene las credenciales de tu base de datos. Nunca lo publiques en foros, chats o lo envíes por correo electrónico.
Mantén tu WordPress actualizado: Las actualizaciones de WordPress, temas y plugins suelen incluir parches de seguridad que protegen tu archivo wp-config.php.
Usa contraseñas fuertes para la base de datos: Evita contraseñas simples. Usa una combinación de letras mayúsculas, minúsculas, números y símbolos.
Considera mover el archivo: Por seguridad avanzada, WordPress permite mover el archivo wp-config.php a un directorio por encima de la raíz de tu sitio web (fuera del alcance público). Esto dificulta que un atacante pueda leerlo. Sin embargo, esta es una práctica más avanzada y no es necesaria para sitios pequeños.

Conclusión: Tu sitio, conectado y funcionando

Configurar la conexión a la base de datos MySQL a través del archivo wp-config.php es una habilidad fundamental para cualquier administrador de WordPress. Aunque pueda parecer intimidante al principio, es un proceso lógico y sencillo una vez que entiendes qué hace cada línea.

Hemos cubierto desde los conceptos básicos hasta la resolución de problemas avanzados. Ahora tienes el conocimiento para diagnosticar y solucionar el temido "Error al conectar con la base de datos" por ti mismo.

Recuerda siempre verificar tus datos, hacer una copia de seguridad antes de editar y no tener miedo a experimentar (con precaución). Con esta guía, ya no dependes de un técnico para resolver este problema tan común.

Si todo lo demás falla, tu proveedor de hosting (ya sea con cPanel, Plesk o Syspanel en el puerto 2106) es siempre tu mejor recurso para obtener ayuda específica sobre tu servidor. ¡Buena suerte con tu sitio web!