Conectar WordPress a MySQL | Guía de Configuración wp-config.php

¿Por qué WordPress necesita una base de datos MySQL?

WordPress no es solo un montón de archivos PHP y CSS. Cada artículo, página, comentario, usuario y ajuste de tu sitio se guarda en una base de datos MySQL. Piensa en ella como el cerebro de tu web: sin ella, WordPress no puede recordar nada, ni siquiera quién eres para poder iniciar sesión.

Por eso, cuando instalas WordPress, uno de los pasos más importantes es conectar WordPress a una base de datos MySQL. Si este paso falla, verás el temido error de "Error al establecer una conexión con la base de datos". No te preocupes, es un problema muy común y solucionable. En esta guía te voy a explicar, paso a paso y sin tecnicismos, cómo hacerlo tanto en cPanel como en Plesk, los dos paneles de control de hosting más habituales.

Vamos a desglosar todo el proceso, desde crear la base de datos hasta editar el archivo wp-config.php, y resolveremos los errores más frecuentes.

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

Para conectar WordPress a MySQL necesitas básicamente 4 datos. Es como tener las llaves de tu casa:

Nombre de la base de datos (ej: usuario_wpdb).
Usuario de la base de datos (ej: usuario_wpuser).
Contraseña de ese usuario (la que tú hayas creado).
Host de la base de datos (normalmente localhost, pero a veces puede ser algo como sql.tudominio.com).

Con estos cuatro datos podremos realizar la conexión. Si no los tienes, el primer paso será crearlos. Vamos a ello.

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

cPanel es el panel más extendido. Su interfaz es muy visual y con iconos. Sigue estos pasos al pie de la letra.

Paso 1: Acceder a "Asistente para bases de datos MySQL"

Dentro de tu cPanel, busca la sección "Bases de Datos". Ahí verás la opción "Asistente para bases de datos MySQL" (MySQL Database Wizard). Es la opción más fácil porque te guía paso a paso. Haz clic en ella.

Paso 2: Crear la base de datos

Te pedirá que pongas un nombre. No hace falta que pongas el prefijo que ves (normalmente es tu nombre de usuario), ya que cPanel lo añade automáticamente. Por ejemplo, si escribes miprimerablog, el nombre final será tuusuario_miprimerablog. Anota este nombre completo. Haz clic en "Siguiente".

Paso 3: Crear un usuario y contraseña

Ahora crea un usuario para esa base de datos. Igual que antes, verás un prefijo que se añadirá solo. Elige un nombre fácil de recordar, como adminwp. Luego, crea una contraseña segura. Puedes usar el botón de "Generar" que te ofrece cPanel para que sea aleatoria y robusta. Es importante que la guardes en un lugar seguro (un gestor de contraseñas es ideal). Haz clic en "Crear usuario".

Paso 4: Asignar todos los privilegios

Este es el paso más crucial. Después de crear el usuario, te preguntará qué privilegios quieres asignarle. Para WordPress, la opción más sencilla y segura es marcar la casilla "TODOS LOS PRIVILEGIOS". No te compliques con permisos específicos; WordPress necesita casi todos para funcionar correctamente (instalar plugins, crear tablas, etc.). Haz clic en "Siguiente" y... ¡listo! Ya tienes tu base de datos y tu usuario creados en cPanel.

[TIP]
Anota estos tres datos en un bloc de notas: Nombre de la BD, Usuario y Contraseña. Los necesitarás en unos minutos. El host, en el 99% de los casos en cPanel, es localhost.

Parte 2: Crear la base de datos y el usuario en Plesk

Plesk tiene una interfaz más moderna y orientada a tareas. El proceso es ligeramente diferente, pero igual de sencillo.

Paso 1: Ir a "Bases de datos"

En el panel de control de Plesk, busca en el menú lateral la sección "Bases de datos" (o "Databases" si está en inglés). Haz clic en el botón "Agregar base de datos" (o "Add Database").

Paso 2: Configurar la nueva base de datos

Se abrirá un formulario. Deberás completar:

Nombre de la base de datos: Elige uno descriptivo, por ejemplo, basedatos_wordpress.
Servidor de base de datos: Normalmente hay una sola opción (MySQL). Déjala como está.
Tipo de base de datos: Selecciona MySQL.
Usuario de la base de datos: Marca la casilla "Crear un nuevo usuario" si no tienes uno. Introduce un nombre de usuario y una contraseña segura.
Privilegios: En el menú desplegable de abajo, elige "Todos los privilegios".

Haz clic en "Aceptar" o "OK". Plesk creará la base de datos y el usuario automáticamente, y te mostrará un resumen con los datos. El host de la base de datos en Plesk suele ser también localhost, pero a veces puede mostrarte una dirección como localhost:3306 (el puerto). Si es así, en WordPress tendrás que poner solo localhost.

[INFO]
Tanto en cPanel como en Plesk, si ya tienes una base de datos creada previamente pero no recuerdas la contraseña, puedes cambiarla desde el panel. En cPanel, dentro de "Bases de datos MySQL", busca la opción "Cambiar contraseña". En Plesk, dentro de los detalles de la base de datos, puedes restablecer la contraseña del usuario.

Parte 3: Configurar el archivo wp-config.php

Ya tienes la base de datos creada. Ahora es el momento de hacer la conexión WordPress MySQL. Esto se hace a través de un archivo de configuración llamado wp-config.php. Es el corazón de la configuración de WordPress.

¿Qué es wp-config.php?

Es un archivo que se encuentra en la raíz de tu instalación de WordPress (la carpeta donde subiste todos los archivos de WordPress, normalmente public_html). Contiene la información esencial para que WordPress se comunique con la base de datos.

Opción A: Si estás instalando WordPress desde cero

Cuando descargas WordPress desde wordpress.org y lo subes a tu hosting, no existe el archivo wp-config.php. WordPress te lo creará automáticamente durante la instalación.

Abre tu navegador y ve a tu dominio (ej: www.tudominio.com).
Verás la pantalla de instalación de WordPress en español.
En el primer paso, te pedirá elegir el idioma. Selecciona "Español" y continúa.
Aquí viene el momento clave. Te pedirá los datos de la base de datos:
- Nombre de la base de datos: Escribe el nombre completo que creaste (ej: tuusuario_miprimerablog).
- Usuario de la base de datos: Escribe el usuario que creaste.
- Contraseña: Escribe la contraseña.
- Servidor de la base de datos: Escribe localhost.
- Prefijo de la tabla: Puedes dejarlo como wp_. Cambiarlo es una medida de seguridad extra, pero para este tutorial lo dejaremos igual.
Haz clic en "Enviar".

WordPress intentará conectarse a la base de datos. Si los datos son correctos, te llevará a la siguiente pantalla para configurar tu sitio web (título, usuario administrador, etc.). ¡Enhorabuena, has conectado WordPress a MySQL con éxito!

Opción B: Si ya tienes WordPress instalado y necesitas cambiar la conexión

Puede que te hayan dado un sitio ya instalado o que hayas movido tu web de servidor. En este caso, el archivo wp-config.php ya existe y tendrás que editarlo manualmente.

Accede a tu hosting mediante el Administrador de Archivos de cPanel o Plesk, o mediante un cliente FTP como FileZilla.
Navega hasta la carpeta raíz de tu WordPress (normalmente public_html o htdocs).
Busca el archivo wp-config.php y descárgalo a tu ordenador para editarlo con un editor de texto plano (como el Bloc de notas, pero te recomiendo uno como Sublime Text o Visual Studio Code).
Busca las líneas que se ven así:

// ** Ajustes de MySQL ** //
define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña_base_datos' );
define( 'DB_HOST', 'localhost' );

Reemplaza nombre_base_datos, usuario_base_datos, contraseña_base_datos con los datos de tu nueva base de datos. Deja DB_HOST como localhost a menos que tu proveedor te indique otra cosa.
Guarda el archivo y súbelo de vuelta a tu servidor, sobrescribiendo el antiguo.

[WARNING]
NUNCA uses el Bloc de notas de Windows para editar wp-config.php directamente desde el servidor. Puede añadir caracteres invisibles que rompan el archivo. Siempre descárgalo, edítalo en tu ordenador y súbelo de nuevo.

Parte 4: Solucionar el error de conexión a la base de datos

El error "Error al establecer una conexión con la base de datos" (Error establishing a database connection) es el más temido. Pero no es el fin del mundo. Suele ser uno de estos tres problemas:

1. Datos incorrectos en wp-config.php

Es el error más común. Revisa que has escrito bien el nombre de la base de datos, el usuario y la contraseña. Un simple error tipográfico o un espacio extra pueden causar este problema. Vuelve a mirar el archivo wp-config.php y verifica que los datos coinciden exactamente con los que creaste en cPanel o Plesk.

2. Host de la base de datos incorrecto

Aunque casi siempre es localhost, algunos hosts utilizan un servidor de bases de datos separado. Revisa la documentación de tu proveedor de hosting. A veces el host es algo como mysql.tudominio.com o una IP. Si has cambiado de hosting, es posible que el DB_HOST haya cambiado.

3. Contraseña incorrecta o privilegios insuficientes

Si has cambiado la contraseña desde cPanel o Plesk, asegúrate de que WordPress esté usando la nueva. También verifica que el usuario de la base de datos tiene asignados "TODOS LOS PRIVILEGIOS". Si solo tiene algunos, puede que falle la conexión.

¿Cómo solucionarlo paso a paso?

Ve a tu panel de control (cPanel o Plesk) y abre la sección de "Bases de datos MySQL".
Comprueba los nombres de la base de datos y del usuario. Asegúrate de que son exactamente los que tienes en wp-config.php.
Cambia la contraseña del usuario de la base de datos desde el panel. Es la forma más rápida de asegurarse de que es correcta. Copia la nueva contraseña y pégala directamente en el archivo wp-config.php.
Verifica los privilegios. Asegúrate de que el usuario tiene "TODOS LOS PRIVILEGIOS" sobre la base de datos.
Revisa el host. Si todo lo demás falla, prueba a cambiar DB_HOST de localhost a 127.0.0.1. A veces el servidor no reconoce localhost como un nombre válido.

[TIP]
Si después de todo esto sigue fallando, contacta con el soporte de tu hosting. Es posible que haya un problema en el servidor que no puedas ver tú. Diles el error exacto que te sale y que ya has verificado los datos de la base de datos.

Parte 5: Preguntas frecuentes (FAQ)

Aquí tienes las dudas más comunes que nos llegan al soporte sobre este tema.

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

Técnicamente sí, pero es altamente desaconsejado. Cada WordPress usa un prefijo de tabla (por defecto wp_). Si usas la misma base de datos, tendrías que cambiar el prefijo en el wp-config.php de uno de ellos (ej: wp_blog1_). Es un dolor de cabeza y puede causar conflictos de datos. Crea una base de datos independiente para cada sitio web.

¿Qué es el puerto 3306?

Es el puerto por defecto del servidor MySQL. A veces, el DB_HOST se muestra como localhost:3306. En WordPress, lo normal es poner solo localhost. Si tu hosting te lo pide, tendrás que escribirlo como localhost:3306 en el campo DB_HOST. Es raro, pero puede pasar.

¿Cómo cambio el prefijo de las tablas de WordPress?

Para cambiar el prefijo de forma segura, necesitas editar el wp-config.php y cambiar la línea:

$table_prefix = 'wp_';

por algo como:

$table_prefix = 'miprefijo_';

Pero esto no es suficiente. También necesitas renombrar todas las tablas en la base de datos desde phpMyAdmin. Es un proceso más avanzado. Si no sabes lo que haces, es mejor no tocarlo o usar un plugin de seguridad que lo haga por ti.

¿Necesito conocimientos de SQL para hacer esta conexión?

No, en absoluto. Todo el proceso se hace a través de las interfaces gráficas de cPanel y Plesk. Tú solo necesitas crear una base de datos, un usuario y asignar una contraseña. El lenguaje SQL se usa internamente por WordPress, pero tú no tienes que escribir ni una sola línea.

¿Qué pasa si mi WordPress está en un subdirectorio?

Si tu WordPress está en una subcarpeta (ej: tudominio.com/blog), el proceso es exactamente el mismo. Solo tienes que asegurarte de que el archivo wp-config.php que editas es el que está dentro de esa subcarpeta, y no el de la raíz.

Conclusión

Conectar WordPress a una base de datos MySQL no tiene que ser un dolor de cabeza. Como has visto, es un proceso de 3 pasos: crear la base de datos, crear el usuario y configurar el wp-config.php. Tanto en cPanel como en Plesk, las herramientas te guían para que no te pierdas.

La próxima vez que veas el error de conexión, ya sabes por dónde empezar a mirar: los datos en wp-config.php y los privilegios del usuario en tu panel de control. Con un poco de paciencia y siguiendo estos pasos, tu sitio web volverá a estar en línea en cuestión de minutos.

Si te surge cualquier otra duda, no dudes en contactar con nuestro equipo de soporte. Estamos aquí para ayudarte.