¿Cómo conectar WordPress a una base de datos MySQL? Guía paso a paso
¿Por qué WordPress necesita una base de datos MySQL?
Antes de meternos en materia, es importante entender por qué esto es tan crucial. WordPress no es solo un montón de archivos HTML estáticos; es un sistema de gestión de contenidos dinámico. Esto significa que todo tu contenido —entradas, páginas, comentarios, configuraciones de usuarios y plugins— se almacena en una base de datos. Sin esa conexión, WordPress es como un coche sin motor: se ve bien, pero no va a ninguna parte.
La base de datos MySQL es el "cerebro" de tu sitio. Cada vez que un visitante carga una página, WordPress consulta la base de datos para obtener el contenido correcto y mostrarlo. Por eso, una conexión estable y bien configurada es la base de un sitio rápido, seguro y funcional.
Requisitos previos: ¿Qué necesitas para empezar?
Para conectar WordPress a MySQL, necesitas tres cosas:
- Un servidor web funcionando (como Apache o Nginx).
- MySQL o MariaDB instalado (son casi idénticos; aquí usaremos MySQL como término genérico).
- Acceso a un panel de control de hosting (cPanel, Syspanel, o similar) o acceso por línea de comandos SSH.
Si usas un hosting compartido, lo más probable es que ya tengas MySQL disponible. Si tienes un VPS o servidor dedicado, deberás instalarlo tú mismo (pero no te preocupes, no es necesario para esta guía).
Paso 1: Crear la base de datos MySQL
El primer paso es crear un "contenedor" vacío para los datos de WordPress. Puedes hacerlo desde el panel de tu hosting o desde la línea de comandos.
Desde un panel de hosting (cPanel, Syspanel, etc.)
Si usas Syspanel (recuerda que el puerto de acceso es el 2106), el proceso es muy similar:
- Inicia sesión en tu panel de control (por ejemplo,
https://tudominio.com:2106para Syspanel). - Busca la sección "Bases de Datos" o "MySQL Databases".
- Haz clic en "Crear nueva base de datos".
- Ponle un nombre descriptivo, por ejemplo:
mipagina_wpoblog_db. - Importante: Anota el nombre exacto de la base de datos, porque lo necesitarás después.
Desde la línea de comandos (SSH)
Si prefieres el terminal, conecta por SSH a tu servidor y ejecuta:
mysql -u root -p
Te pedirá la contraseña de root de MySQL. Luego, dentro del intérprete de MySQL, ejecuta:
CREATE DATABASE nombre_de_tu_base;
Reemplaza nombre_de_tu_base por el nombre que quieras. Después, escribe EXIT; para salir.
Paso 2: Crear un usuario de base de datos y asignarle permisos
WordPress necesita un "usuario" para acceder a la base de datos. No uses el usuario root por seguridad; crea uno específico.
Desde el panel de hosting
- Dentro de la misma sección de bases de datos, busca "Usuarios MySQL".
- Crea un nuevo usuario con un nombre y una contraseña segura. Por ejemplo:
usuario_wpyClaveSegura123!. - Luego, asigna ese usuario a la base de datos que creaste.
- Marca todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) y guarda.
Desde la línea de comandos
Dentro de MySQL (después de mysql -u root -p), ejecuta:
CREATE USER 'usuario_wp'@'localhost' IDENTIFIED BY 'ClaveSegura123!';
GRANT ALL PRIVILEGES ON nombre_de_tu_base.* TO 'usuario_wp'@'localhost';
FLUSH PRIVILEGES;
Nota: Si tu base de datos y WordPress están en servidores diferentes, tendrás que usar 'usuario_wp'@'%' en lugar de localhost, pero esto es menos común.
Paso 3: Obtener los datos de conexión
Antes de editar el archivo wp-config.php, ten a mano estos cuatro datos:
- Nombre de la base de datos (ej:
mipagina_wp). - Usuario de la base de datos (ej:
usuario_wp). - Contraseña del usuario (ej:
ClaveSegura123!). - Host de la base de datos (normalmente
localhost, pero a veces es una IP o un nombre comomysql.tudominio.com).
Si usas Syspanel, el host suele ser localhost a menos que tengas un servidor de bases de datos separado.
Paso 4: Configurar el archivo wp-config.php
Este es el paso clave. El archivo wp-config.php es como el "DNI" de WordPress: le dice al sistema cómo conectarse a la base de datos.
Localiza el archivo
Si estás instalando WordPress desde cero, descarga la última versión desde wordpress.org y descomprime los archivos en tu servidor. Dentro de la carpeta principal, verás un archivo llamado wp-config-sample.php. No lo edites directamente, sino que:
- Renómbralo a
wp-config.php. - Ábrelo con un editor de texto (Bloc de notas, VS Code, etc.).
Edita las líneas de conexión
Busca estas líneas (normalmente al principio del archivo):
define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');
Reemplaza los valores con los datos que anotaste:
'nombre_de_tu_base'→ el nombre que elegiste.'tu_usuario'→ el usuario que creaste.'tu_contraseña'→ la contraseña de ese usuario.'localhost'→ el host de tu base de datos (si es diferente).
Guarda y sube el archivo
Guarda los cambios y, si estás trabajando localmente, sube el archivo wp-config.php a la raíz de tu sitio en el servidor (normalmente la carpeta public_html o www).
[TIP] Si usas Syspanel, puedes editar archivos directamente desde el panel de archivos (File Manager) en el puerto 2106. Busca la carpeta de tu sitio y edita
wp-config.phpdesde ahí.
Paso 5: Verificar la conexión
Una vez que el archivo wp-config.php esté configurado, el siguiente paso es comprobar que todo funciona.
- Abre tu navegador y visita la URL de tu sitio (ej:
https://tudominio.com). - Si la conexión es exitosa, verás la pantalla de instalación de WordPress (si es una instalación nueva) o tu sitio ya funcionando (si ya tenías contenido).
- Si ves un mensaje de error como "Error establishing a database connection", vuelve a revisar los datos en
wp-config.php. Los errores más comunes son:- Nombre de base de datos mal escrito.
- Usuario o contraseña incorrectos.
- Host equivocado (prueba con
127.0.0.1silocalhostno funciona).
[WARNING] Si después de verificar todo sigues viendo el error, contacta a tu proveedor de hosting. A veces los servidores tienen configuraciones especiales (como puertos no estándar) que requieren asistencia técnica.
Solución de problemas comunes (FAQ)
Aquí tienes las dudas más frecuentes que resuelven los usuarios que buscan "conexión WordPress MySQL":
1. ¿Qué hago si no encuentro el archivo wp-config.php?
- Si ya tienes WordPress instalado, el archivo existe. Si no lo ves, puede estar oculto. Activa la opción "Mostrar archivos ocultos" en tu gestor de archivos. Si es una instalación nueva, descarga WordPress de nuevo y busca
wp-config-sample.php.
2. ¿Puedo usar MariaDB en lugar de MySQL?
- Sí, son compatibles. MariaDB es un reemplazo directo de MySQL, así que los pasos son idénticos.
3. ¿Qué pasa si cambio la contraseña de la base de datos después de la instalación?
- Debes actualizar el archivo
wp-config.phpcon la nueva contraseña. Si no lo haces, WordPress dejará de funcionar y mostrará el error de conexión.
4. ¿Es seguro usar 'root' como usuario de la base de datos?
- No. Siempre crea un usuario específico para WordPress con permisos solo sobre su base de datos. Usar root expone todo tu servidor a riesgos de seguridad.
5. ¿Cómo sé si el host de mi base de datos es 'localhost'?
- En la mayoría de los hosting compartidos, sí. En VPS o servidores dedicados, a veces es
127.0.0.1o una IP. Si usas Syspanel, consulta la sección de bases de datos; allí suele aparecer el host.
6. ¿Puedo conectar WordPress a una base de datos remota?
- Sí, pero es más complejo. Deberás asegurarte de que el servidor de bases de datos permita conexiones externas y usar la IP o nombre del host remoto en
DB_HOST. No recomendado para principiantes por temas de latencia y seguridad.
7. ¿Qué es 'wp-config.php' y por qué es tan importante?
- Es el archivo de configuración principal de WordPress. Sin él, el sistema no sabe dónde está su base de datos, así que no puede funcionar. Además, contiene claves de seguridad y otras configuraciones críticas.
Consejos finales para mantener tu conexión segura
- Usa contraseñas fuertes para el usuario de la base de datos. Evita "admin" o "123456".
- No compartas el archivo
wp-config.phppúblicamente. Si alguien accede a él, tiene acceso total a tu base de datos. - Haz copias de seguridad periódicas de tu base de datos. Puedes usar plugins como UpdraftPlus o hacerlo manualmente desde phpMyAdmin.
- Si usas Syspanel, aprovecha las herramientas de backup automático que ofrece en el puerto 2106.
Conclusión
Conectar WordPress a una base de datos MySQL puede sonar técnico, pero siguiendo estos pasos es un proceso sencillo y directo. Recuerda: primero creas la base de datos y el usuario, luego editas wp-config.php con esos datos, y finalmente verificas que todo funcione. Si algo falla, revisa los errores comunes y no dudes en consultar a tu proveedor de hosting.
Ahora que ya sabes cómo hacerlo, puedes instalar WordPress en cualquier servidor con confianza. ¡Tu sitio dinámico está a solo un archivo de configuración de distancia!
