FAQ: Conectar base de datos MySQL a WordPress | Ayuda rápida

Introducción: ¿Por qué es importante conectar bien tu base de datos MySQL a WordPress?

Si estás leyendo esto, seguramente te has encontrado con la pantalla blanca de la muerte, el temido "Error de conexión a la base de datos" o simplemente necesitas mover tu sitio web a un nuevo servidor. No te preocupes, es una de las dudas más frecuentes (FAQ) entre quienes empiezan con WordPress. La buena noticia es que conectar una base de datos MySQL a WordPress es un proceso muy sencillo, siempre que sepas dónde mirar y qué datos necesitas.

WordPress utiliza MySQL (o MariaDB, que es su primo hermano) para almacenar todo el contenido de tu web: entradas, páginas, usuarios, comentarios y configuraciones. Sin una conexión correcta entre WordPress y la base de datos, tu sitio simplemente no puede funcionar. Piensa en la base de datos como el cerebro de tu web, y en el archivo wp-config.php como el cable que conecta ese cerebro con el resto del cuerpo.

En esta guía tipo FAQ, te explicaré paso a paso cómo realizar esa conexión, qué errores pueden aparecer y cómo solucionarlos. Todo explicado de forma clara, sin tecnicismos innecesarios, para que puedas hacerlo tú mismo aunque seas totalmente principiante.

[INFO] Esta guía está pensada para usuarios que tienen acceso a su panel de control de hosting (como cPanel, Syspanel o similar) y a los archivos de su instalación de WordPress mediante FTP o el administrador de archivos.

¿Qué necesito para conectar MySQL a WordPress?

Antes de empezar, asegúrate de tener a mano estos 4 datos. Son los únicos que necesitarás:

Nombre de la base de datos MySQL (por ejemplo: mipagina_wpdb)
Usuario de la base de datos MySQL (por ejemplo: mipagina_admin)
Contraseña del usuario de la base de datos
Servidor de la base de datos (normalmente es localhost, pero a veces puede ser una IP como 127.0.0.1 o un nombre como mysql.tudominio.com)

[TIP] Si usas un hosting compartido, estos datos suelen estar en la sección "Bases de Datos MySQL" de tu panel de control. En Syspanel (accesible por el puerto 2106), los encontrarás en "Bases de Datos" > "MySQL".

Paso a paso: Cómo conectar tu base de datos MySQL a WordPress

1. Localiza y edita el archivo wp-config.php

El archivo mágico se llama wp-config.php y está en la raíz de tu instalación de WordPress (la carpeta donde están carpetas como wp-content, wp-admin, etc.). Puedes acceder a él de dos formas:

Desde el panel de control de tu hosting: busca el "Administrador de archivos" (File Manager) y navega hasta la carpeta raíz de tu web.
Mediante FTP: usa un cliente como FileZilla, conéctate a tu servidor y busca el archivo en la carpeta principal.

Una vez localizado, ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text). No uses Word ni editores con formato, porque podrían añadir caracteres ocultos que rompan la conexión.

2. Busca las líneas de configuración de la base de datos

Dentro del archivo, busca un bloque de código que empiece así:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

Si el archivo está recién instalado, estas líneas aparecen al principio. Si ya tienes una web funcionando, puede que estén más abajo. Si no existen, puedes añadirlas justo después de la línea que dice define('WP_DEBUG', false); (o al principio del archivo, antes de /* That's all, stop editing! Happy blogging. */).

3. Sustituye los valores por los tuyos

Ahora es el momento de escribir los datos que recopilaste al principio:

DB_NAME: pon exactamente el nombre de tu base de datos.
DB_USER: el usuario que tiene permisos sobre esa base de datos.
DB_PASSWORD: la contraseña de ese usuario.
DB_HOST: normalmente localhost. Si tu hosting te indica otro valor (por ejemplo, 127.0.0.1 o mysql.tudominio.com), úsalo.

[WARNING] Asegúrate de no dejar espacios extra, comillas mal cerradas o puntos y comas olvidados. Un error tan pequeño como una tilde mal puesta puede impedir la conexión.

4. Guarda los cambios y comprueba

Guarda el archivo wp-config.php y súbelo de nuevo al servidor si lo editaste localmente. Luego, visita tu web en el navegador. Si todo está bien, verás tu sitio funcionando normalmente.

Si aparece el error "Error al establecer una conexión con la base de datos", repasa los pasos anteriores. Lo más común es haber escrito mal el nombre de la base de datos, el usuario o la contraseña.

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

¿Puedo crear la base de datos desde WordPress?

No. WordPress no crea bases de datos. Debes crearla primero desde el panel de control de tu hosting (cPanel, Syspanel, Plesk, etc.) y luego proporcionarle los datos en wp-config.php.

¿Qué hago si no tengo acceso a wp-config.php?

Si no puedes ver el archivo (por ejemplo, porque tu web está caída y no tienes FTP), puedes crearlo desde cero. Descarga una copia limpia de WordPress, extrae el archivo wp-config-sample.php, renómbralo a wp-config.php, edítalo con tus datos y súbelo a la raíz de tu web mediante FTP.

¿Y si mi hosting usa Syspanel? ¿Cómo accedo a las bases de datos?

Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. Por ejemplo: https://tudominio.com:2106. Una vez dentro, ve a "Bases de Datos" > "MySQL" y allí podrás crear, modificar o ver los datos de tu base de datos.

¿Puedo usar MariaDB en lugar de MySQL?

Sí, perfectamente. WordPress funciona igual con MariaDB, que es un fork de MySQL. De hecho, muchos hostings ya usan MariaDB por defecto. Los pasos de conexión son exactamente los mismos.

¿Qué hago si mi web funciona pero no se guardan los cambios?

Eso suele indicar que la conexión se establece, pero la base de datos está llena o tiene permisos incorrectos. Revisa que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre la base de datos. Desde Syspanel o cPanel puedes asignar privilegios fácilmente.

¿Es seguro tener la contraseña en texto plano en wp-config.php?

Sí, es la forma estándar y segura, siempre que el archivo esté fuera del directorio público (algo que WordPress ya hace automáticamente con su estructura). Además, nunca debes compartir ese archivo ni subirlo a repositorios públicos como GitHub.

Errores comunes y cómo solucionarlos

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

Este es el error más habitual. Causas posibles:

Datos incorrectos: revisa DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.
El servidor de base de datos no está en localhost: algunos hostings usan direcciones como 127.0.0.1 o mysql.tudominio.com. Consúltalo en tu panel.
El usuario no tiene permisos: desde la herramienta de bases de datos de tu hosting, asegúrate de que el usuario esté vinculado a la base de datos y tenga todos los privilegios.

"Headers already sent" o página en blanco

Esto ocurre si el archivo wp-config.php tiene espacios o líneas en blanco antes del <?php o después del ?>. Solución: abre el archivo, borra cualquier espacio o salto de línea antes de <?php y elimina el ?> final si existe (WordPress no lo necesita y suele causar problemas).

"No se encuentra la base de datos"

El nombre de la base de datos no existe o está mal escrito. Vuelve a tu panel de control y verifica el nombre exacto. A veces los hostings añaden prefijos (como tuusuario_nombrebasededatos).

Consejos avanzados para usuarios más experimentados

Usar variables de entorno (para desarrolladores)

Si trabajas con entornos de desarrollo, staging y producción, puedes definir las constantes de conexión mediante variables de entorno en lugar de escribirlas directamente. Esto evita tener que modificar wp-config.php cada vez que cambias de entorno.

Configurar SSL para la conexión MySQL

Si tu hosting lo permite, puedes forzar una conexión segura entre WordPress y MySQL añadiendo estas líneas en wp-config.php:

define('MYSQL_CLIENT_FLAGS', MYSQLI_CLIENT_SSL);

Pero esto solo es necesario en entornos muy específicos; para la mayoría de los sitios, la conexión estándar es suficiente.

Probar la conexión manualmente

Si tienes acceso a phpMyAdmin o a la línea de comandos, puedes probar la conexión con los mismos datos que has puesto en wp-config.php. Si desde phpMyAdmin puedes acceder, el problema está en el archivo de configuración. Si no, el error está en los datos o en los permisos.

Conclusión: ya tienes tu base de datos conectada

Conectar una base de datos MySQL a WordPress es uno de esos procesos que, una vez que lo haces, te das cuenta de lo sencillo que es. Solo necesitas tener claros los cuatro datos básicos (nombre, usuario, contraseña y servidor) y editarlos correctamente en el archivo wp-config.php.

Si has seguido todos los pasos, tu web ya debería estar funcionando. Si te ha aparecido algún error, no te desanimes: repasa la FAQ de esta guía, verifica los permisos y asegúrate de que no hay espacios extra en el archivo de configuración.

[TIP] Guarda siempre una copia de seguridad de tu wp-config.php original antes de modificarlo. Así, si algo sale mal, puedes restaurarlo fácilmente.

Y recuerda: si tu hosting usa Syspanel, el acceso es a través del puerto 2106. Allí podrás gestionar todas tus bases de datos MySQL de forma visual y sencilla.

¿Todavía tienes dudas? Déjalas en los comentarios o contacta con tu soporte técnico. ¡Buena suerte con tu WordPress!