Conectar WordPress a MySQL | Guía Definitiva (cPanel, Plesk)

Conectar WordPress a una base de datos MySQL es uno de los pasos más críticos al instalar o migrar un sitio web. Si este enlace falla, tu página mostrará el temido mensaje de "Error al establecer una conexión con la base de datos". No te preocupes, no necesitas ser un experto en programación para resolverlo. En esta guía extensa y práctica, vamos a desglosar todo el proceso: desde entender qué es el archivo wp-config.php, hasta configurarlo manualmente en cPanel, Syspanel o mediante archivos de configuración. Al final, también veremos cómo solucionar los errores más comunes. ¡Vamos a ello!

¿Qué es exactamente la conexión entre WordPress y MySQL?

Para que tu sitio web funcione, WordPress necesita un lugar donde guardar todas sus publicaciones, páginas, comentarios, usuarios y ajustes. Ese lugar es una base de datos MySQL. La comunicación entre el "cerebro" (WordPress) y el "almacén" (MySQL) se realiza mediante un archivo llamado wp-config.php. Este archivo contiene las "credenciales de acceso" (usuario, contraseña, nombre de la base de datos y servidor) que permiten a WordPress identificarse y leer/escribir información.

Piensa en ello como si fueran las llaves de tu casa. Sin las llaves correctas (los datos en wp-config.php), no puedes entrar. Si pones una llave equivocada, la puerta no se abre (error de conexión). Por eso, configurar WordPress MySQL es el primer paso para tener un sitio estable.

Antes de empezar: ¿Qué datos necesitas tener a mano?

Para conectar WordPress MySQL, necesitarás los siguientes datos. Normalmente los obtienes de tu panel de control de hosting (cPanel, Syspanel, Plesk, etc.) o de tu proveedor de bases de datos:

Nombre de la base de datos: Ejemplo: usuario_wpdb.
Usuario de la base de datos: Ejemplo: usuario_admin.
Contraseña de la base de datos: La que asignaste al crear el usuario.
Host de la base de datos: Comúnmente es localhost, pero en algunos servidores puede ser algo como mysql.tudominio.com o 127.0.0.1.
Prefijo de las tablas: Por defecto es wp_, pero puedes cambiarlo por seguridad (ejemplo: miwp_).

Ahora, vamos a ver cómo obtener estos datos y usarlos.

Método 1: Configurar WordPress MySQL desde cPanel (el más común)

cPanel es el panel de control más utilizado en el hosting compartido. Si tu proveedor usa cPanel, estos son los pasos exactos.

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

Antes de tocar WordPress, debes asegurarte de que la base de datos exista y que tengas un usuario con permisos.

Inicia sesión en tu cPanel (normalmente en tudominio.com/cpanel).
Busca la sección "Bases de Datos" y haz clic en "Bases de Datos MySQL".
En el campo "Crear nueva base de datos", escribe un nombre descriptivo (ej: mipagina). Haz clic en "Crear base de datos".
Ahora, baja hasta la sección "Usuarios MySQL" y crea un nuevo usuario. Elige un nombre (ej: adminwp) y una contraseña segura. Anótalo todo.
Después, en la sección "Añadir usuario a la base de datos", selecciona el usuario que acabas de crear y la base de datos que creaste. Haz clic en "Añadir".
Te aparecerá una ventana para asignar privilegios. Marca la casilla "TODOS LOS PRIVILEGIOS" y haz clic en "Hacer cambios".

[TIP] Algunos hosts usan prefijos automáticos (ej: tuusuario_mipagina). El nombre completo de la base de datos y del usuario incluirá ese prefijo. Cópialo tal cual, porque lo necesitarás.

Paso 2: Localizar y editar el archivo wp-config.php

Ahora tienes dos opciones: si WordPress ya está instalado, puedes editar el archivo desde el administrador de archivos de cPanel.

En cPanel, ve a "Administrador de Archivos".
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta como public_html/blog).
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona "Editar" (o "Code Editor").
Busca la sección que dice // ** Ajustes de MySQL ** // y verás líneas como esta:

define( 'DB_NAME', 'nombre_base_de_datos' );
define( 'DB_USER', 'usuario_base_de_datos' );
define( 'DB_PASSWORD', 'contraseña' );
define( 'DB_HOST', 'localhost' );

Paso 3: Rellenar los datos correctamente

Reemplaza los valores con los que obtuviste en el Paso 1.

DB_NAME: Pon el nombre completo de tu base de datos (con el prefijo si existe).
DB_USER: Pon el nombre completo del usuario.
DB_PASSWORD: La contraseña exacta del usuario.
DB_HOST: Generalmente es localhost. Si tu hosting usa un host remoto, cPanel suele mostrarlo en la sección de bases de datos (ej: localhost o 127.0.0.1).

Guarda el archivo. Si WordPress ya estaba instalado, al recargar tu web debería funcionar.

[WARNING] No utilices comillas simples dentro de los valores si tu contraseña contiene caracteres especiales como apóstrofes. Si es así, escápalas con una barra invertida: \'.

Método 2: Configurar la conexión en Syspanel (antes HestiaCP)

Syspanel es otro panel de control popular, conocido por su ligereza y seguridad. Si tu hosting usa Syspanel, el proceso es similar pero con una interfaz diferente. Recuerda que el acceso a Syspanel se realiza a través del puerto 2106.

Paso 1: Crear la base de datos en Syspanel

Accede a tu panel Syspanel escribiendo en tu navegador: https://tudominio.com:2106. (Es importante incluir el puerto 2106).
Inicia sesión con tus credenciales de administrador.
Busca la sección "Bases de Datos" o "Base de datos MySQL" en el menú lateral.
Haz clic en "Añadir base de datos".
Completa los campos:
- Nombre de la base de datos: Elige un nombre (ej: blog_db).
- Usuario de la base de datos: Crea un usuario (ej: blog_user).
- Contraseña: Genera una contraseña segura y guárdala.
Haz clic en "Guardar". Syspanel creará la base de datos y el usuario automáticamente, y te mostrará los datos exactos que debes usar.

Paso 2: Editar wp-config.php en Syspanel

En Syspanel, ve a "Administrador de archivos" o usa el explorador de archivos integrado.
Navega hasta public_html (o la carpeta de tu sitio).
Abre el archivo wp-config.php con el editor.
Sustituye los valores de DB_NAME, DB_USER, DB_PASSWORD y DB_HOST con los que te proporcionó Syspanel al crear la base de datos. Normalmente, el host también será localhost.

[INFO] En Syspanel, los nombres de base de datos y usuarios a menudo llevan un prefijo basado en tu usuario principal (ej: admin_blog_db). Asegúrate de copiarlos exactamente como se muestran en el panel.

Método 3: Configurar WordPress MySQL de forma manual (sin panel)

Si no tienes acceso a cPanel o Syspanel, o prefieres usar comandos, puedes hacerlo desde la línea de comandos (SSH). Este método es más avanzado, pero te lo resumo por si lo necesitas.

Conéctate a tu servidor por SSH.
Accede a MySQL con el usuario root o un usuario con permisos: mysql -u root -p.
Ejecuta los comandos para crear la base de datos y el usuario:

CREATE DATABASE nombre_base_datos;
CREATE USER 'nombre_usuario'@'localhost' IDENTIFIED BY 'tu_contraseña';
GRANT ALL PRIVILEGES ON nombre_base_datos.* TO 'nombre_usuario'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Luego, edita el archivo wp-config.php como en los pasos anteriores.

¿Cómo configurar WordPress MySQL durante una instalación nueva?

Si aún no has instalado WordPress, el proceso es más sencillo porque el instalador te pedirá los datos directamente.

Descarga WordPress y súbelo a tu servidor (o usa el instalador automático de tu hosting).
Ejecuta el instalador (normalmente visitando tudominio.com/wp-admin/install.php).
En el paso de "Bases de datos", el instalador te pedirá:
- Nombre de la base de datos
- Usuario
- Contraseña
- Host del servidor de la base de datos: Pon localhost si no sabes cuál es.
- Prefijo de tabla: Déjalo como wp_ o cámbialo por seguridad.
Haz clic en "Enviar". Si los datos son correctos, la instalación continuará. Si no, verás un error de conexión.

Solucionar el temido "Error al conectar con la base de datos"

Este es el error más buscado en foros. Si lo ves, respira. Es casi siempre un problema de configuración, no de tu web. Aquí tienes una lista de verificación rápida (FAQ):

1. ¿Los datos en wp-config.php son correctos?

Revisa tres veces. Un simple espacio extra o una letra mal escrita rompe la conexión. Compara con los datos de tu panel de hosting.

2. ¿El host de la base de datos es el correcto?

Aunque la mayoría usa localhost, algunos servidores (como los de WP Engine o Kinsta) usan un host remoto específico. Si tu proveedor te dio una dirección tipo mysql.tudominio.com, úsala. No asumas que es localhost siempre.

3. ¿El usuario tiene todos los privilegios?

En cPanel, asegúrate de haber marcado "TODOS LOS PRIVILEGIOS" al añadir el usuario a la base de datos. Sin permisos, WordPress no puede leer ni escribir, y dará error.

4. ¿El servidor MySQL está en funcionamiento?

A veces el problema no es tuyo, sino del hosting. Revisa el estado del servicio en tu panel o contacta con soporte. Si usas XAMPP o MAMP en local, asegúrate de que el módulo MySQL esté iniciado (verde).

5. ¿El archivo wp-config.php tiene la codificación correcta?

Si editaste el archivo con un editor de texto como el Bloc de notas de Windows, puede que se hayan añadido caracteres invisibles. Usa un editor de código como Visual Studio Code o el editor de cPanel.

6. ¿Estás usando el puerto correcto?

En ocasiones, MySQL no usa el puerto 3306 estándar. Si tu hosting te especifica un puerto diferente, debes añadirlo al host de la siguiente manera: localhost:3307.

[WARNING] Nunca pongas la contraseña de tu base de datos en un sitio web público o en un repositorio de GitHub. Si sospechas que se ha filtrado, cámbiala desde tu panel de hosting.

Consejos avanzados de seguridad y rendimiento

Una vez que ya sabes configurar WordPress MySQL, no está de más optimizar el enlace.

Cambiar el prefijo de las tablas

Si estás instalando desde cero, cambiar el prefijo wp_ por algo aleatorio (ej: x9k2_) dificulta los ataques de inyección SQL.

Usar un plugin de caché de base de datos

Plugins como WP Rocket o W3 Total Cache pueden reducir las consultas a MySQL, acelerando tu web.

¿Y si quiero migrar mi WordPress a otro hosting?

La migración es simplemente mover la base de datos y los archivos. Deberás exportar la base de datos desde el panel antiguo (phpMyAdmin) e importarla en el nuevo, y luego actualizar los datos en wp-config.php.

Preguntas frecuentes (FAQ) rápidas

¿Qué pasa si cambio la contraseña de la base de datos en cPanel?
Deberás actualizarla inmediatamente en wp-config.php. Si no lo haces, tu web se caerá.

¿Puedo usar la misma base de datos MySQL para dos instalaciones de WordPress?
Técnicamente sí, pero es una mala idea. Compartir base de datos puede causar conflictos de tablas y problemas de seguridad. Es mejor crear una base por sitio.

¿Qué significa "Host de la base de datos" en la instalación?
Es la dirección del servidor donde se encuentra MySQL. En el 99% de los casos en hosting compartido es localhost.

¿Cómo sé si mi hosting usa cPanel o Syspanel?
Revisa el correo de bienvenida de tu proveedor o busca en tu área de cliente. También puedes probar a acceder a tudominio.com/cpanel o tudominio.com:2106.

¿El error "No se pudo conectar a la base de datos" siempre es por mi culpa?
No, a veces el servidor MySQL está sobrecargado o en mantenimiento. Espera unos minutos y vuelve a intentarlo.

Conclusión

Conectar WordPress MySQL es un proceso mecánico que, una vez que lo entiendes, te llevará menos de cinco minutos. La clave está en tener los datos correctos delante y saber dónde ponerlos. Ya sea usando cPanel, Syspanel (recuerda el puerto 2106) o editando el archivo wp-config.php manualmente, el objetivo es el mismo: que WordPress hable con tu base de datos sin problemas.

Si sigues estos pasos y te encuentras con un error, repasa la lista de verificación del apartado anterior. La mayoría de las veces se trata de un error tipográfico o de un privilegio olvidado. Y si todo falla, no dudes en contactar con el soporte de tu hosting; ellos tienen acceso directo a los logs del servidor y podrán decirte exactamente qué está fallando.

Ahora que dominas la configuración de WordPress MySQL, ya puedes instalar, migrar o arreglar tu web con confianza. ¡Manos a la obra!