Conectar WordPress a MySQL: Guía fácil para principiantes

¿Te has encontrado con el temido mensaje "Error al establecer una conexión con la base de datos" al intentar abrir tu WordPress? Respira, no has roto nada irreparable. Es el problema más común para quienes dan sus primeros pasos en la gestión de su propio sitio web. La buena noticia es que conectar WordPress a MySQL es un proceso mecánico y, con esta guía, lo harás sin necesidad de ser un genio de la programación. Vamos a desmitificar el archivo wp-config.php y te daré las claves para que tu web hable con su base de datos sin contratiempos.

¿Qué es eso de "conectar WordPress MySQL"?

Imagina que WordPress es una tienda de ropa y MySQL es el almacén trasero donde guardas toda la mercancía, los precios y la lista de clientes. Cuando alguien visita tu tienda (tu web), WordPress necesita ir al almacén (base de datos) a buscar los productos, las páginas y los ajustes para mostrarlos en el escaparate. Sin esa conexión, la tienda está abierta pero vacía y rota: no puede mostrar nada. Por eso, conectar WordPress a MySQL es el puente vital entre la interfaz que ven tus visitantes y los datos que hacen funcionar tu sitio.

Para los no técnicos, la forma más sencilla de entenderlo es que la base de datos es un archivo gigante y organizado, mientras que WordPress es el programa que sabe leer y escribir en él. La conexión se define con cuatro datos: el nombre de la base de datos, el usuario, la contraseña y el servidor (normalmente localhost). Si uno de estos cuatro no coincide, la conexión falla.

La pieza clave: el archivo `wp-config.php`

Todo este misterio se resuelve en un solo archivo. Cuando instalas WordPress en la raíz de tu hosting, encontrarás un archivo llamado wp-config.php. Es el cerebro de la configuración. Aquí es donde le dices a WordPress: "Oye, el almacén está en esta dirección, con estas llaves". wp-config.php base de datos es la sección que vamos a editar.

No te asustes por el nombre .php. No es un virus ni nada raro. Es un archivo de texto con instrucciones. Para editarlo, necesitas un editor de texto plano como el Bloc de Notas de Windows o TextEdit en Mac (nunca uses Word, porque añade formato invisible que rompe el código).

Localizando las líneas de conexión

Dentro de wp-config.php, busca un bloque que se parece a esto (es la parte más importante):

// ** Configuración de la base de datos ** //
define( 'DB_NAME', 'tu_nombre_de_bd' );
define( 'DB_USER', 'tu_usuario_bd' );
define( 'DB_PASSWORD', 'tu_contraseña_bd' );
define( 'DB_HOST', 'localhost' );

Aquí tienes el mapa del tesoro:

DB_NAME: Es el nombre exacto de tu base de datos. Si usas cPanel o Syspanel, suele ser algo así como usuario_wpbd.
DB_USER: El usuario que tiene permiso para entrar a esa base de datos. Normalmente es usuario_wp o similar.
DB_PASSWORD: La contraseña de ese usuario. Ojo, no es la contraseña de tu panel de control, sino la que creaste específicamente para la BD.
DB_HOST: Esto casi siempre es localhost. Solo en casos de bases de datos remotas (muy raro en hosting compartido) cambiará a algo como mysql.servidor.com.

[INFO] Si usas el panel de control Syspanel, recuerda que la gestión de bases de datos se hace desde su interfaz, a la que accedes a través del puerto 2106. Allí podrás crear la BD y el usuario, y te dará los datos exactos que debes copiar en tu wp-config.php.

Guía paso a paso: Crear la base de datos y conectar

Vamos a la acción. Sigue estos pasos en orden y en 15 minutos tendrás tu WordPress funcionando.

Paso 1: Crear la base de datos en tu panel de hosting

Antes de conectar, necesitas el "almacén". Esto se hace desde tu panel de control. Los pasos son casi idénticos en cPanel, Plesk o Syspanel.

Inicia sesión en tu panel de hosting (recuerda, en Syspanel es el puerto 2106).
Busca la sección "Bases de Datos MySQL" o "MySQL Databases".
En el campo "Nueva Base de Datos", escribe un nombre (ej: mipagina_blog). Haz clic en "Crear Base de Datos".
Ahora, en la sección "Usuarios MySQL", crea un usuario nuevo (ej: mipagina_admin). Elige una contraseña segura y guárdala en un lugar seguro (te hará falta ya mismo).
Finalmente, en la sección "Añadir Usuario a la Base de Datos", selecciona tu usuario y tu base de datos, y asígnale TODOS los privilegios (o "ALL PRIVILEGES"). Esto es crucial. Sin permisos, WordPress no puede leer ni escribir.

[WARNING] No uses la contraseña de tu correo ni del panel. Una contraseña débil es la puerta de entrada para los hackers. Usa el generador de contraseñas del propio panel.

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

Ahora que ya tienes la BD y el usuario, vamos a presentarlos.

Ve a la carpeta de tu sitio en el hosting (normalmente public_html o htdocs).
Descarga el archivo wp-config.php a tu ordenador. Si no existe, puedes crearlo copiando el archivo wp-config-sample.php y renombrándolo.
Ábrelo con el Bloc de Notas.
Reemplaza las líneas que vimos antes con los datos que acabas de crear. Por ejemplo:
- DB_NAME = mipagina_blog
- DB_USER = mipagina_admin
- DB_PASSWORD = Tu_Contraseña_SuperSegura_123
- DB_HOST = localhost
Guarda el archivo (asegúrate de que no se guarde como .txt). Si lo descargaste con otro nombre, súbelo de vuelta a la carpeta raíz de tu hosting. Si el archivo ya existía, simplemente sobrescribe el original.

Paso 3: Probar la conexión

Este es el momento de la verdad. Abre tu navegador y escribe la URL de tu sitio (ej: www.tudominio.com).

Si ves tu web: ¡Felicidades! La conexión es correcta. Si estás instalando desde cero, verás el asistente de instalación de WordPress.
Si ves el error de conexión: Revisa los datos del paso anterior. ¿El nombre de la BD es exacto? ¿El usuario y la contraseña? Un simple espacio de más al copiar pegar puede ser el culpable.

El error de conexión más común y cómo solucionarlo

El famoso "Error al establecer una conexión con la base de datos" puede aparecer por varias razones. Aquí tienes un mini checklist para diagnosticarlo.

1. Credenciales incorrectas (el 90% de las veces)

Es lo primero que debes verificar. Vuelve a tu panel de hosting y asegúrate de que el nombre de la BD, el usuario y la contraseña en wp-config.php coinciden exactamente (incluyendo mayúsculas y minúsculas).

2. El servidor de la base de datos no es localhost

A veces, el hosting usa un servidor separado para MySQL. Si has verificado las credenciales y sigue fallando, revisa el DB_HOST. En lugar de localhost, podría ser algo como mysql.tudominio.com o db.syspanel.local. Esta información la encuentras en la sección de bases de datos de tu panel de control, o en el correo de bienvenida de tu hosting.

3. El usuario no tiene todos los privilegios

Vuelve a la sección de "Añadir Usuario a la Base de Datos" y asegúrate de que el usuario está vinculado a la BD correcta y que tiene marcada la casilla de "TODOS LOS PRIVILEGIOS". Sin esto, WordPress no puede crear las tablas necesarias para funcionar.

4. Reparar la base de datos (si el error persiste)

WordPress tiene un truco oculto para reparar bases de datos dañadas. Añade esta línea al final de tu wp-config.php (justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */):

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y visita tudominio.com/wp-admin/maint/repair.php. Te aparecerá un botón para "Reparar la base de datos". Una vez hecho, borra esa línea inmediatamente, porque deja una vulnerabilidad de seguridad.

[WARNING] Activar WP_ALLOW_REPAIR sin protección es peligroso. Cualquiera podría acceder a esa URL. Úsalo solo si es necesario y elimínalo justo después de arreglar el error.

Preguntas frecuentes sobre el setup de la base de datos

Aquí tienes las dudas que más nos llegan al soporte técnico.

¿Puedo cambiar el prefijo de las tablas de WordPress?

Sí. En el mismo wp-config.php hay una línea que dice $table_prefix = 'wp_';. Puedes cambiarlo a miprefijo_ para dificultar los ataques de inyección SQL. Hazlo antes de instalar WordPress, no después, porque si lo cambias con la web ya funcionando, la romperás.

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

No hay problema. Ve a tu panel de hosting (Syspanel, puerto 2106), entra en la sección de usuarios MySQL y selecciona "Cambiar contraseña". Luego, actualiza el DB_PASSWORD en tu wp-config.php con la nueva contraseña.

¿Es lo mismo "conectar WordPress MySQL" que "wordpress database setup"?

Sí, son términos intercambiables. El setup (configuración) es el proceso de crear la BD y darle los datos a WordPress. La conexión es el resultado de ese proceso. Ambos se refieren a lo mismo: hacer que WordPress y MySQL se entiendan.

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

Técnicamente sí, pero es una pésima idea. Cada WordPress tiene su propio conjunto de tablas (posts, usuarios, opciones). Si comparten BD, se mezclarán y tu sitio se corromperá. Siempre crea una base de datos nueva para cada instalación de WordPress.

¿Qué significa el error "Too many connections"?

Esto significa que tu base de datos ha alcanzado el límite de conexiones simultáneas. Es un problema de recursos del servidor, no de configuración. Suele pasar en planes de hosting muy básicos o si tienes demasiados plugins que hacen consultas pesadas. La solución es optimizar el rendimiento o contratar un plan superior.

Resumen y consejo final

Conectar WordPress a MySQL no es magia, es pura lógica. WordPress database setup se resume en tres pasos: crear la BD, crear el usuario y pegar esos datos en wp-config.php. La próxima vez que veas el error de conexión, ya sabes por dónde empezar: revisa las credenciales, luego el DB_HOST y, por último, los permisos del usuario.

[TIP] Si estás migrando tu web a un nuevo hosting, este proceso es idéntico. Solo tienes que exportar tu base de datos antigua, importarla en el nuevo hosting y actualizar los datos en el wp-config.php. No edites nunca el archivo con editores visuales como WordPad o Word, ya que pueden insertar caracteres invisibles que rompen el código PHP.

Con esta guía, ya no dependes de un técnico para resolver el problema más básico de WordPress. Has dado el primer paso para entender cómo funciona tu web por dentro. Si el error persiste después de todos estos pasos, puede ser un problema del servidor (firewall o MySQL bloqueado). En ese caso, contacta con tu proveedor de hosting y diles que ya has verificado el wp-config.php y las credenciales; ellos podrán revisar los logs del servidor para ayudarte. ¡Mucha suerte con tu web!