Conectar base de datos MySQL a WordPress: guía fácil | SysAdmin

¿Alguna vez has intentado instalar WordPress y te has encontrado con el temido mensaje de "Error al conectar con la base de datos"? No te preocupes, es una de las situaciones más comunes al montar una web. Conectar tu base de datos MySQL con WordPress es el paso fundamental para que tu sitio funcione, y aunque suene técnico, es más sencillo de lo que parece si sigues los pasos adecuados.

En esta guía extensa y detallada, te explicaré todo lo que necesitas saber para realizar esta conexión correctamente, desde los conceptos básicos hasta la resolución de los errores más frecuentes. Usaremos un lenguaje claro y ejemplos prácticos para que, incluso si eres principiante, puedas hacerlo sin problemas.

¿Qué es una base de datos MySQL y por qué WordPress la necesita?

Antes de meternos en materia, entendamos qué estamos haciendo. Una base de datos MySQL es como un enorme archivador digital donde WordPress guarda toda la información de tu sitio: entradas, páginas, comentarios, usuarios, configuraciones y más. Sin ella, WordPress no tendría dónde almacenar ni recuperar los datos, por lo que la web simplemente no funcionaría.

WordPress usa MySQL (o MariaDB, que es una variante) como motor de base de datos. Cuando instalas WordPress, el sistema necesita comunicarse con esa base de datos para crear las tablas necesarias y empezar a operar. Por eso, conectar base de datos WordPress correctamente es el primer paso después de subir los archivos al servidor.

Requisitos previos: lo que necesitas tener a mano

Para conectar tu base de datos MySQL con WordPress, vas a necesitar cuatro datos clave. Es importante que los tengas escritos antes de empezar, ya que los introducirás durante la instalación o en el archivo de configuración.

Nombre de la base de datos: El nombre que le pusiste al crear la base en tu hosting.
Usuario de la base de datos: El nombre del usuario que tiene permisos para acceder a esa base.
Contraseña del usuario: La clave que asignaste a ese usuario.
Servidor de la base de datos (host): Normalmente es localhost, pero en algunos hosting puede ser una dirección IP o un nombre como mysql.tudominio.com.

[INFO] Si usas un panel de control como cPanel o Syspanel (recuerda que el acceso a Syspanel es por el puerto 2106), estos datos los puedes encontrar en la sección "Bases de Datos MySQL" o "Crear Base de Datos". Si tu hosting te proporciona acceso por FTP o un instalador automático (como Softaculous), a menudo puedes saltarte este paso manual.

Método 1: Conexión durante la instalación de WordPress (el más común)

Este es el método que usarás la mayoría de las veces. Cuando ejecutas el instalador de WordPress por primera vez, te pedirá los datos de la base de datos.

Paso 1: Crear la base de datos y el usuario en tu hosting

Antes de instalar WordPress, debes crear la base de datos y un usuario con todos los privilegios. Aquí te explico cómo hacerlo en cPanel y en Syspanel.

En cPanel:

Inicia sesión en tu cPanel.
Busca la sección "Bases de Datos" y haz clic en "Bases de Datos MySQL".
Escribe un nombre para tu base (ej: mipagina_wp) y haz clic en "Crear Base de Datos".
Vuelve al listado y haz clic en "Usuarios MySQL".
Crea un nuevo usuario (ej: mipagina_user) y asígnale una contraseña segura. Anótala.
Ahora, en "Añadir Usuario a Base de Datos", selecciona el usuario y la base que acabas de crear.
Marca la casilla "Todos los privilegios" y haz clic en "Hacer cambios".

En Syspanel (antes HestiaCP):

Accede a tu Syspanel a través de https://tu-servidor:2106.
Ve a la pestaña "Bases de Datos".
Haz clic en "Añadir Base de Datos".
Se creará automáticamente una base de datos, un usuario y una contraseña. Guarda estos datos inmediatamente, ya que son los que usarás. El nombre suele ser nombreusuario_nombredb.

Paso 2: Ejecutar el instalador de WordPress

Descarga WordPress desde wordpress.org y súbelo a tu servidor (o usa el instalador automático de tu hosting).
Navega a tu dominio (ej: tudominio.com). Te aparecerá la pantalla de bienvenida de WordPress.
Selecciona tu idioma y haz clic en "Continuar".
Te aparecerá la pantalla de configuración de la base de datos. Introduce los cuatro datos que guardaste:
- Nombre de la base de datos: El que creaste (ej: mipagina_wp).
- Nombre de usuario: El usuario que creaste (ej: mipagina_user).
- Contraseña: La que asignaste.
- Servidor de la base de datos: Normalmente localhost. Si no funciona, consulta con tu hosting.
- Prefijo de tabla: Déjalo como wp_ a menos que quieras cambiarlo por seguridad.
Haz clic en "Enviar". WordPress intentará conectar. Si todo está bien, verás un mensaje de éxito y podrás continuar con la instalación.

[TIP] Si ves el mensaje "Error al conectar con la base de datos", revisa que los datos sean exactamente los mismos que creaste. Un error común es escribir mal la contraseña o el nombre de la base.

Método 2: Conexión manual editando el archivo wp-config.php

A veces, la instalación automática falla o ya tienes WordPress instalado pero necesitas cambiar la base de datos. En ese caso, editas el archivo wp-config.php que está en la raíz de tu instalación de WordPress.

Paso 1: Localizar y editar wp-config.php

Accede a tu servidor vía FTP o desde el administrador de archivos de tu hosting (cPanel o Syspanel).
Busca el archivo wp-config.php en la carpeta donde instalaste WordPress (normalmente public_html o www).
Ábrelo con un editor de texto (como el Bloc de Notas o un editor de código).

Paso 2: Modificar las líneas de conexión

Dentro del archivo, busca las líneas que definen las constantes de la base de datos. Deberías ver algo como esto:

// ** Configuración de la base de datos de WordPress ** //
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'nombre_de_tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

Simplemente reemplaza los valores entre comillas por los tuyos:

DB_NAME: El nombre de tu base de datos.
DB_USER: El nombre del usuario.
DB_PASSWORD: La contraseña del usuario.
DB_HOST: Normalmente localhost, pero si tu hosting te da otro valor (ej: mysql.tudominio.com), ponlo aquí.

Guarda el archivo y vuelve a cargar tu web. Si los datos son correctos, WordPress se conectará sin problemas.

[WARNING] Ten mucho cuidado al editar wp-config.php. Un error tipográfico puede romper la conexión. Siempre haz una copia de seguridad del archivo original antes de modificarlo.

Solución de problemas: ¿Por qué aparece el error de conexión?

El temido error conexión base de datos WordPress puede deberse a varias causas. Aquí tienes las más comunes y cómo solucionarlas.

1. Datos incorrectos en wp-config.php

Es la causa más frecuente. Revisa que el nombre de la base, el usuario y la contraseña sean exactamente los que creaste. A veces se añaden prefijos automáticos (como el usuario de cPanel o Syspanel). Por ejemplo, en Syspanel el nombre de la base suele ser usuario_nombrebase.

2. El servidor de base de datos no es localhost

Algunos hosting usan servidores remotos. Si localhost no funciona, contacta a tu proveedor de hosting para que te dé el host correcto. Puede ser algo como mysql.tudominio.com o una IP.

3. Permisos insuficientes del usuario

Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. Si solo tiene permisos de lectura, WordPress no podrá crear tablas ni escribir datos. En cPanel, revisa la sección "Privilegios" y marca todos. En Syspanel, al crear la base ya se asignan automáticamente.

4. La base de datos está corrupta o llena

Si tu web funcionaba y de repente da error, puede que la base esté corrupta o haya alcanzado su límite de tamaño. En cPanel, usa "phpMyAdmin" para reparar tablas. Ve a la base, selecciona todas las tablas y en el menú desplegable elige "Reparar tabla". Si el problema es de espacio, contacta a tu hosting.

5. Problemas con el servidor MySQL

A veces el servicio MySQL se cae. Si nada funciona, verifica con tu hosting que el servicio esté activo. Ellos pueden reiniciarlo desde su lado.

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

Aquí respondo las dudas más habituales de los usuarios que buscan conectar base de datos WordPress.

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

No es recomendable, ya que los prefijos de tabla (wp_) se mezclarían y causarían conflictos. Si usas el mismo prefijo, una instalación sobrescribiría los datos de la otra. Si necesitas múltiples sitios, crea bases de datos separadas o usa prefijos diferentes (ej: sitio1_, sitio2_).

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

No puedes recuperarla, pero sí cambiarla. En cPanel, ve a "Usuarios MySQL", selecciona el usuario y elige "Cambiar contraseña". En Syspanel, deberás eliminar el usuario y crear uno nuevo, luego actualizar wp-config.php con la nueva contraseña.

¿El servidor de la base de datos siempre es localhost?

No siempre. En hosting compartidos básicos sí, pero en servidores más avanzados (VPS, dedicados) o en ciertos proveedores, puede ser diferente. Si localhost no funciona, consulta la documentación de tu hosting o el panel de control.

¿Puedo cambiar el nombre de la base de datos después de instalar WordPress?

Sí, pero es un proceso manual. Debes exportar la base antigua, crear una nueva con el nombre deseado, importar los datos, y luego editar wp-config.php con el nuevo nombre. Es más seguro hacerlo con un plugin como "WP Migrate DB" o pidiendo ayuda a tu hosting.

Mi hosting usa Syspanel, ¿cómo accedo a phpMyAdmin?

En Syspanel, ve a la sección "Bases de Datos" y busca el icono de "phpMyAdmin" junto a la base que creaste. Haz clic y se abrirá la herramienta para gestionar tus tablas. Recuerda que el acceso a Syspanel es por el puerto 2106.

Consejos finales para una conexión exitosa

La conexión entre MySQL y WordPress es el corazón de tu sitio web. Si algo falla, la web se cae. Por eso, te recomiendo:

Usa contraseñas seguras para el usuario de la base de datos. Evita "123456" o "admin".
Haz copias de seguridad periódicas de tu base de datos. Puedes hacerlo desde phpMyAdmin o con plugins como UpdraftPlus.
Si usas un instalador automático (Softaculous, Fantastico), normalmente él mismo crea la base y el usuario, pero aun así verifica que los datos sean correctos.
Si migras tu web a otro hosting, asegúrate de exportar la base de datos completa y luego importarla en el nuevo servidor, actualizando wp-config.php con los nuevos datos de conexión.

Siguiendo esta guía paso a paso, podrás conectar base de datos WordPress sin problemas, ya sea en cPanel, Syspanel o cualquier otro panel. Recuerda que la paciencia y la atención a los detalles son tus mejores aliados. Si te encuentras con un error, repasa cada punto de este artículo y, si persiste, no dudes en contactar al soporte técnico de tu hosting.

¡Ahora ya estás listo para que tu WordPress cobre vida!