Conectar base de datos MySQL en WordPress: Guía fácil

¿Te has encontrado con el mensaje "Error al establecer una conexión con la base de datos" en tu WordPress? No te preocupes, es una de las incidencias más comunes y, por suerte, una de las más fáciles de solucionar. En esta guía completa y paso a paso, vamos a explicarte exactamente qué es eso de conectar MySQL WordPress, cómo funciona la WordPress base de datos y, sobre todo, cómo configurar correctamente el archivo wp-config.php MySQL para que tu sitio web funcione sin problemas.

Vamos a desglosar todo el proceso de manera sencilla, como si estuviéramos tomando un café y te lo explicara un amigo. No necesitas ser un experto en programación; solo sigue estos pasos y tendrás tu WordPress database connection funcionando a la perfección.

¿Qué significa "conectar MySQL WordPress"?

Antes de meternos en harina, entendamos los conceptos básicos. Piensa en WordPress como una tienda online. La base de datos MySQL es el almacén donde guardas todos tus productos (artículos, páginas, usuarios, comentarios, configuraciones). El archivo wp-config.php es como el mapa que le dice a WordPress dónde está ese almacén y cómo entrar.

Cuando hablamos de conectar MySQL WordPress, nos referimos al proceso mediante el cual WordPress localiza tu base de datos, se identifica con un usuario y contraseña, y establece una comunicación estable. Sin esta conexión, tu web simplemente no puede funcionar, porque no tiene dónde guardar ni recuperar la información.

[INFO] La base de datos no es lo mismo que los archivos de WordPress (el código PHP, las plantillas, los plugins). La base de datos guarda el contenido dinámico; los archivos guardan el programa en sí.

¿Dónde se configura la conexión? El archivo wp-config.php

El corazón de la WordPress database connection es un archivo llamado wp-config.php. Este archivo se encuentra en la carpeta raíz de tu instalación de WordPress (normalmente en public_html o www).

Si no lo ves, puede que esté oculto. No te asustes, es normal. Para ver archivos ocultos en un panel de control como cPanel o Syspanel, busca una opción que diga "Mostrar archivos ocultos" (dotfiles).

¿Qué información necesito para configurar wp-config.php?

Para rellenar correctamente el wp-config.php MySQL, necesitarás cuatro datos clave, que normalmente te proporciona tu empresa de hosting o tu panel de control:

Nombre de la base de datos: (Database Name) Ejemplo: miusuario_wpdb
Usuario de la base de datos: (Database Username) Ejemplo: miusuario_wpuser
Contraseña de la base de datos: (Database Password) La clave que elegiste al crear el usuario.
Servidor de la base de datos: (Database Host) Normalmente es localhost, pero a veces puede ser una dirección IP o un nombre como mysql.tudominio.com.

[WARNING] Nunca uses un editor de texto plano como el Bloc de notas de Windows para editar wp-config.php. Usa un editor de código como VS Code, Sublime Text, o el editor de archivos de tu panel de control (cPanel, Syspanel). Los editores simples pueden añadir caracteres invisibles que rompen el archivo.

Paso a paso: Cómo configurar la conexión a la base de datos

Aquí tienes los pasos exactos para conectar MySQL WordPress manualmente. Es el método más fiable.

Paso 1: Localiza y abre tu archivo wp-config.php

Accede a tu hosting mediante FTP (FileZilla, por ejemplo) o a través del administrador de archivos de tu panel de control (como Syspanel, accesible por el puerto 2106). Navega hasta la carpeta donde está instalado WordPress y busca el archivo wp-config.php. Ábrelo con un editor de texto.

Paso 2: Encuentra las líneas de configuración de la base de datos

Dentro del archivo, busca un bloque de código que se parezca a esto (es muy probable que ya esté, pero con valores incorrectos o genéricos):

// ** Configuración de la base de datos de WordPress - Puedes obtenerla desde tu hosting ** //
define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña_base_datos' );
define( 'DB_HOST', 'localhost' );

Paso 3: Sustituye los valores con los tuyos

Ahora, simplemente reemplaza los textos entre comillas simples con los datos correctos que obtuviste antes.

'nombre_base_datos' → Pon exactamente el nombre que te dio tu hosting.
'usuario_base_datos' → Pon el usuario que creaste.
'contraseña_base_datos' → Pon la contraseña de ese usuario.
'localhost' → Si tu hosting te ha dado un host diferente, cámbialo. Si no, déjalo como localhost.

Ejemplo real:

define( 'DB_NAME', 'midominio_wpblog' );
define( 'DB_USER', 'midominio_adminwp' );
define( 'DB_PASSWORD', 'MiContraseñaSegura123!' );
define( 'DB_HOST', 'localhost' );

Paso 4: Guarda los cambios y sube el archivo

Guarda el archivo wp-config.php y, si lo estabas editando localmente, súbelo de nuevo a tu servidor, sobrescribiendo el antiguo. Si lo editaste directamente en el panel de control, los cambios ya están aplicados.

Paso 5: Prueba tu sitio web

Ahora, accede a tu dominio. Si todo está correcto, tu WordPress cargará sin problemas. Si ves otro error, no te desesperes; sigue leyendo.

[TIP] Si estás migrando un sitio web, además de cambiar estos datos, asegúrate de que la información en las tablas de la base de datos (como la URL del sitio) también esté actualizada.

Errores comunes al conectar MySQL WordPress y cómo solucionarlos

A veces, incluso siguiendo los pasos, pueden surgir problemas. Aquí tienes los más frecuentes y cómo resolverlos.

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

Este es el clásico. Significa que WordPress no puede ni siquiera hablar con el servidor de la base de datos.

Posibles causas y soluciones:

Datos incorrectos en wp-config.php: Vuelve a revisar el nombre, usuario y contraseña. Un simple error tipográfico (una letra mayúscula donde no toca) lo causa.
El servidor de base de datos no es 'localhost': Algunos hostings (como los que usan Syspanel o ciertos servidores dedicados) requieren un host específico. Revisa el correo de bienvenida de tu hosting o consulta con el soporte.
El usuario no tiene permisos sobre la base de datos: Esto es muy común. En tu panel de control (cPanel, Syspanel), busca "Bases de datos MySQL" y asegúrate de que el usuario esté añadido a la base de datos y tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, añádelo y asígnale todos los permisos.
La base de datos no existe: A veces la creamos mal o con otro nombre. Verifica que la base de datos esté creada en tu panel.

Error: "PHP no está instalado o la extensión MySQL no está disponible"

WordPress necesita una extensión de PHP para hablar con MySQL. Si ves este error, contacta a tu soporte técnico y pídeles que activen la extensión mysqli o pdo_mysql en la configuración de PHP.

Error: "La conexión se restableció" o "Página en blanco"

Esto puede indicar un problema más grave, como un error de sintaxis en el wp-config.php. Revisa que no hayas borrado una coma, un punto y coma o una comilla. Si tienes dudas, descarga una copia limpia de WordPress y extrae el wp-config-sample.php original para comparar.

Cómo crear la base de datos y el usuario (si no los tienes)

Si estás empezando desde cero, necesitarás crear la WordPress base de datos y un usuario. Aquí te explicamos cómo hacerlo en un panel típico como cPanel o Syspanel (recuerda, el puerto de Syspanel es el 2106).

Usando Syspanel (HestiaCP)

Accede a tu Syspanel: https://tudominio.com:2106
Inicia sesión con tus credenciales de administrador.
Busca la sección "Bases de datos" o "Base de datos".
Haz clic en "Añadir base de datos".
Completa los campos:
- Nombre de la base de datos: Elige uno descriptivo (ej: miblog_wp).
- Usuario de la base de datos: Elige un nombre (ej: miblog_user).
- Contraseña: Genera una segura (usa el generador del panel) o crea una tú. Guárdala bien.
Haz clic en "Guardar". El sistema creará la base de datos, el usuario y asignará los permisos automáticamente.

Usando cPanel

Inicia sesión en tu cPanel.
Busca "Bases de datos MySQL" o "MySQL Databases".
En "Crear nueva base de datos", escribe el nombre y haz clic en "Crear base de datos".
Baja a "Usuarios de MySQL", crea un nuevo usuario y contraseña.
En "Añadir usuario a la base de datos", selecciona el usuario y la base de datos que acabas de crear.
Marca la casilla "Todos los privilegios" y haz clic en "Hacer cambios".

[INFO] Los nombres de las bases de datos y usuarios en muchos hostings compartidos llevan un prefijo (ej: tudominio_). Asegúrate de copiar el nombre completo que te muestra el panel.

Preguntas Frecuentes (FAQ) sobre WordPress database connection

Aquí respondemos a las dudas más habituales de nuestros usuarios.

¿Puedo cambiar el prefijo de las tablas de la base de datos?

Sí, pero es una operación avanzada. Se define en wp-config.php con la línea $table_prefix = 'wp_';. Cambiarlo a algo único (ej: xyz_) puede mejorar la seguridad, pero si lo haces en un sitio ya funcionando, tendrás que renombrar todas las tablas manualmente o usar un plugin. No lo recomiendo si no tienes experiencia.

¿Qué hago si pierdo la contraseña de la base de datos?

Tranquilo, puedes cambiarla desde tu panel de control (cPanel, Syspanel). Busca la sección de "Bases de datos MySQL" y cambia la contraseña del usuario. Luego, actualiza esa misma contraseña en tu archivo wp-config.php. Si no lo haces, tu web dejará de funcionar hasta que lo sincronices.

¿Es lo mismo "localhost" que "127.0.0.1"?

Sí, para el 99% de los casos, son equivalentes. localhost es un nombre que se resuelve a la IP 127.0.0.1. Si tu hosting te pide uno u otro, usa el que te indiquen. Si no, localhost es la opción estándar.

¿Puedo conectar WordPress a una base de datos remota (en otro servidor)?

Sí, es posible, pero no es recomendable para principiantes. Implica cambiar el DB_HOST por la IP del servidor remoto y asegurarte de que el servidor de la base de datos permita conexiones externas (lo cual es un riesgo de seguridad). Para sitios web normales, la base de datos debe estar en el mismo servidor que WordPress.

¿Cada cuánto debo revisar la conexión a la base de datos?

No necesitas revisarla a menudo. La conexión es estable. Lo que sí debes hacer es mantener tu WordPress, plugins y temas actualizados, así como hacer copias de seguridad periódicas de tu WordPress base de datos. Si empiezas a ver errores de conexión, es señal de que algo anda mal en el servidor o en la configuración.

Consejos finales para una conexión sólida

Configurar correctamente la conexión MySQL WordPress es el primer paso para tener un sitio web fiable. Aquí tienes un resumen de buenas prácticas:

Usa contraseñas seguras: Tanto para el usuario de la base de datos como para el administrador de WordPress. Una contraseña débil es la puerta de entrada para los hackers.
Haz copias de seguridad: Antes de tocar el wp-config.php, siempre es buena idea tener una copia de seguridad de los archivos y de la base de datos.
No edites con editores básicos: Usa siempre un editor de código o el editor del panel.
Si algo falla, vuelve a lo básico: Revisa los cuatro datos (nombre, usuario, contraseña, host) y los permisos del usuario.

Esperamos que esta guía te haya sido de gran ayuda. Conectar MySQL WordPress es un proceso que, una vez que lo entiendes, se vuelve muy sencillo. Si tienes más dudas, no dudes en consultar nuestra sección de ayuda o contactar con nuestro equipo de soporte. ¡Tu web te lo agradecerá!