Cómo conectar WordPress a tu base de datos MySQL (wp-config.php)

¿Te ha aparecido el temido mensaje "Error al establecer la conexión con la base de datos" en tu WordPress? No te preocupes, no eres la primera persona a la que le pasa y, sobre todo, no es el fin del mundo. Este error es uno de los más comunes, pero también uno de los más fáciles de solucionar si sabes dónde mirar.

En este artículo, vamos a desmitificar por completo el proceso de conectar WordPress a MySQL. Aprenderás, paso a paso y sin tecnicismos innecesarios, a configurar el archivo wp-config.php, que es el "cerebro" que une tu sitio web con su base de datos.

Tanto si estás migrando tu web, cambiando de servidor, o simplemente has recibido un aviso de tu proveedor de hosting sobre un cambio de credenciales, esta guía te servirá como un mapa. Vamos a ello.

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

Imagina que tu WordPress es un coche. El motor es el propio CMS (el sistema de gestión de contenidos), pero sin gasolina no va a ninguna parte. Esa gasolina es la base de datos MySQL, donde se almacenan tus artículos, páginas, comentarios y ajustes.

El archivo wp-config.php es la llave de contacto. Es un archivo de configuración que se encuentra en la raíz de tu instalación de WordPress (normalmente en la carpeta public_html o www). En él se le dicen al sistema exactamente dónde está la gasolinera (el servidor de la base de datos), qué tipo de gasolina usar (el nombre de la base de datos) y quién es el conductor (usuario y contraseña).

Sin una configuración correcta en este archivo, WordPress es simplemente un montón de código PHP que no puede comunicarse con tus datos. Por eso, conectar WordPress a MySQL es el primer paso fundamental para que tu web funcione.

Antes de empezar: Reúne tus credenciales de la base de datos

Para poder editar el wp-config.php y cambiar la base de datos de WordPress, necesitas tener a mano la siguiente información. Es como tener la receta antes de cocinar.

1. Nombre de la base de datos: Suele ser algo como usuario_bdwordpress.
2. Usuario de la base de datos: Normalmente es el mismo que el nombre, o algo similar como usuario_wpuser.
3. Contraseña: La contraseña que asignaste a ese usuario de la base de datos.
4. Host de la base de datos: Casi siempre es localhost, pero en algunos servidores gestionados puede ser algo como mysql.tudominio.com o una dirección IP (ej. 127.0.0.1).

¿Dónde encuentro esto? Si usas un panel de control de hosting clásico como cPanel, busca la sección "Bases de Datos MySQL". Si tu hosting usa Syspanel (recuerda, el acceso es por el puerto 2106), la sección de bases de datos estará claramente etiquetada en el menú lateral. Es cuestión de hacer clic en "Bases de Datos MySQL" y ahí tendrás toda la información.

Paso a paso: Cómo editar wp-config.php para conectar WordPress a MySQL

Vamos a lo importante. Existen dos formas principales de hacerlo: editando el archivo directamente en el servidor o usando un cliente FTP. Te mostraré el método más común y seguro.

Método 1: Editar el archivo desde el Administrador de Archivos del hosting

Esta es la forma más visual y recomendada para principiantes.

1. Accede a tu panel de control: Entra en cPanel o en Syspanel (recuerda, puerto 2106).
2. Abre el Administrador de Archivos: Busca el icono que dice "Administrador de Archivos" o "File Manager".
3. Navega a la raíz de tu web: Entra en la carpeta public_html o htdocs (o la carpeta que hayas especificado para tu sitio). Ahí deberías ver todos los archivos de tu WordPress, incluyendo el famoso wp-config.php.
4. Edita el archivo: Haz clic derecho sobre wp-config.php y selecciona "Editar" o "Edit". Se abrirá un editor de texto en línea. Es posible que te pida confirmación para guardar una copia de seguridad; es una excelente idea aceptar.
5. Localiza la sección de la base de datos: Busca el bloque que dice // ** Ajustes de MySQL ** //. Verás algo similar a esto:

// ** Ajustes de MySQL ** //
/** Nombre de la base de datos de WordPress */
define( 'DB_NAME', 'nombre_base_datos' );

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

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

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

6. Sustituye los valores: Ahora, con cuidado, reemplaza las palabras que están entre comillas simples. Por ejemplo:
   • En 'nombre_base_datos', pon el nombre exacto de tu base de datos.
   • En 'usuario_base_datos', pon el usuario exacto.
   • En 'contraseña_secreta', pon la contraseña.
   • En 'localhost', pon el host que te haya indicado tu proveedor.
7. Guarda los cambios: Busca el botón "Guardar" (o "Save") en la esquina superior derecha del editor y haz clic. ¡Listo!

Método 2: Usar un cliente FTP (como FileZilla)

Si te sientes más cómodo con FTP, también es muy sencillo.

1. Conéctate a tu servidor: Abre FileZilla y conéctate usando tus credenciales FTP.
2. Descarga el archivo: Navega a la carpeta raíz de tu WordPress, busca wp-config.php, haz clic derecho y selecciona "Descargar".
3. Edítalo con un editor de texto: Abre el archivo descargado con un editor como el Bloc de Notas o Notepad++.
4. Realiza los mismos cambios: Busca la sección de MySQL y modifica los valores de DB_NAME, DB_USER, DB_PASSWORD y DB_HOST tal y como se explicó en el método anterior.
5. Guarda el archivo y súbelo de nuevo: En FileZilla, arrastra el archivo modificado desde tu ordenador a la carpeta raíz del servidor. Te preguntará si quieres sobrescribir el archivo existente; acepta.

[WARNING]
¡Ojo con la sintaxis! No borres las comillas simples, los puntos y comas o los paréntesis que rodean a los valores. Un solo carácter mal colocado puede provocar que WordPress no arranque. Si ves un error de PHP, revisa que no hayas eliminado algo por accidente.

Error de conexión a la base de datos de WordPress: Solución de problemas

Has seguido todos los pasos, pero el error persiste. No desesperes. Vamos a diagnosticar los problemas más comunes que causan el error de conexión a la base de datos de WordPress.

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

Este es el error más genérico. Indica que WordPress no puede comunicarse con MySQL. Las causas suelen ser:

• Credenciales incorrectas: Es el caso más frecuente. Revisa que no haya espacios en blanco al copiar y pegar los nombres o contraseñas. A veces, las contraseñas contienen caracteres extraños (como $, & o #) que pueden causar problemas. Si es así, considera cambiar la contraseña de la base de datos desde tu panel de control y usar una más simple (aunque segura).
• Host incorrecto: Asegúrate de que DB_HOST es exactamente el que te ha dado tu hosting. Mientras que localhost es lo común, algunos servidores usan puertos específicos (ej. localhost:3307). Si tu proveedor te dio un host y un puerto, escríbelo juntos con dos puntos.
• El servidor de la base de datos está caído: En raras ocasiones, el problema es del servidor. Si las credenciales son correctas, contacta con tu proveedor de hosting para verificar que el servicio MySQL está activo.

2. El error "No se pudo conectar a la base de datos" o "No se pudo seleccionar la base de datos"

Este error es más específico. Significa que WordPress sí encontró el servidor MySQL, pero no pudo "elegir" la base de datos. Las causas son:

• El nombre de la base de datos es incorrecto: Verifica que el nombre en DB_NAME coincide exactamente con el que ves en tu panel de control. A menudo, el nombre incluye un prefijo con tu usuario de hosting (ej. usuariohost_wp1).
• El usuario no tiene permisos sobre esa base de datos: En cPanel o Syspanel, debes asegurarte de que el usuario que estás usando está asignado a la base de datos y tiene todos los privilegios. A veces se crea el usuario y la base de datos por separado, pero no se han vinculado. Busca la opción "Añadir usuario a base de datos" y verifica que la asociación existe.

[TIP]
Si acabas de crear la base de datos y el usuario en tu panel de control, a veces tarda unos minutos en propagarse. Espera 5 minutos y vuelve a intentarlo antes de modificar nada más.

¿Cómo cambiar la base de datos de WordPress a un nuevo servidor?

Este es un proceso común al migrar de hosting. La buena noticia es que seguir los pasos anteriores ya te permite cambiar la base de datos de WordPress. Simplemente, en el wp-config.php, pon los nuevos datos (nombre, usuario, contraseña y host) de la nueva base de datos.

Sin embargo, hay un paso extra crucial: la migración de los datos.

1. Exporta la base de datos antigua: En tu panel de control antiguo, usa phpMyAdmin para exportar la base de datos a un archivo .sql.
2. Crea la nueva base de datos: En tu nuevo hosting, crea una base de datos y un usuario, y asígnale todos los permisos.
3. Importa los datos: En el nuevo phpMyAdmin, importa el archivo .sql que exportaste antes.
4. Actualiza wp-config.php: Ahora sí, edita el archivo en el nuevo servidor con las nuevas credenciales.

[INFO]
Este proceso de migración manual funciona, pero ten en cuenta que si cambias el dominio o la URL del sitio, necesitarás también editar las opciones siteurl y home en la tabla wp_options de la base de datos, o usar un plugin de migración para que todo sea automático.

Preguntas frecuentes (FAQ) sobre la conexión a MySQL

¿Puedo usar localhost siempre?
No siempre. La mayoría de los hostings compartidos usan localhost, pero algunos servidores dedicados o de pago usan un hostname específico para la base de datos, como mysql.midominio.com. Siempre es mejor consultar la documentación de tu proveedor.

¿Qué hago si olvidé mi contraseña de la base de datos?
No pasa nada. Desde tu panel de control (cPanel o Syspanel en el puerto 2106), ve a la sección de Bases de Datos MySQL y busca la opción "Cambiar contraseña". Después de cambiarla, tendrás que actualizarla también en el archivo wp-config.php.

¿Es seguro editar wp-config.php?
Sí, es totalmente seguro si lo haces con cuidado. Solo estás cambiando valores de configuración. Asegúrate de no añadir espacios extra o romper la sintaxis del archivo. Es recomendable hacer una copia de seguridad del archivo antes de editarlo.

¿Por qué veo un error 500 después de editar el archivo?
Esto suele ser un problema de sintaxis. Has borrado o añadido un carácter extra en el archivo PHP. Descarga el archivo y revísalo línea por línea. Lo más común es que falte un punto y coma ; o una comilla '.

¿Puedo cambiar el prefijo de las tablas de la base de datos desde wp-config.php?
Sí, puedes. En el mismo archivo, busca la línea que dice $table_prefix = 'wp_'; y cámbiala por el prefijo que desees. Esto es una medida de seguridad, pero solo debes hacerlo antes de instalar WordPress o si sabes exactamente lo que estás haciendo, ya que puede romper la web si ya tienes contenido.

Conclusión: Resolviendo el misterio de la conexión

Conectar WordPress a MySQL no es magia negra, es solo saber dónde apuntar. El archivo wp-config.php es tu herramienta clave. Hemos visto que la mayoría de los errores de conexión se deben a simples errores tipográficos o a credenciales mal vinculadas en el panel de control.

La próxima vez que veas un error de base de datos, respira hondo. Ahora ya sabes que solo tienes que seguir estos pasos:

1. Verifica las credenciales en tu panel de hosting.
2. Edita wp-config.php con los datos correctos.
3. Revisa que el usuario esté asignado a la base de datos con todos los privilegios.

Con esta guía, deberías ser capaz de resolver el 99% de los problemas de conexión. Y si el problema persiste, recuerda que tu proveedor de hosting siempre estará ahí para echarte una mano. ¡Mucha suerte con tu WordPress!