Conectar WordPress a MySQL en Plesk | Configurar wp-config.php

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

Antes de lanzarnos a la configuración, es fundamental que entiendas qué estamos haciendo. WordPress es un gestor de contenidos (CMS) que guarda todos tus artículos, páginas, comentarios, usuarios y ajustes en una base de datos MySQL. Los archivos del tema, plugins y el propio núcleo de WordPress están en el servidor, pero sin la base de datos, tu web no es más que un cascarón vacío.

Cuando instalas WordPress en un servidor con Plesk, el panel de control te ofrece asistentes gráficos que hacen el 90% del trabajo. Sin embargo, en ocasiones necesitas hacerlo manualmente: migraciones, instalaciones personalizadas, o simplemente porque el asistente falló a mitad de camino. Ahí es donde entra en juego el archivo wp-config.php, el "cerebro" que le dice a WordPress dónde encontrar su base de datos.

Este artículo te guiará paso a paso para conectar WordPress a MySQL en Plesk, configurando correctamente el archivo wp-config.php. Además, resolveremos los errores más comunes que aparecen en el camino.

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

No puedes conectar WordPress a una base de datos que no existe. Así que lo primero es crearla desde el panel de Plesk. Sigue estos pasos:

Inicia sesión en tu panel de Plesk (normalmente algo como https://tu-dominio.com:8443).
En el menú lateral, busca la sección "Bases de datos" (o "Databases").
Haz clic en "Agregar base de datos" (o "Add Database").
Completa los campos:
- Nombre de la base de datos: por ejemplo, wordpress_db. Evita espacios y caracteres raros.
- Tipo de base de datos: selecciona MySQL.
- Servidor: elige el servidor MySQL que quieras (si solo tienes uno, ya vendrá seleccionado).
En la sección de "Usuario de la base de datos", marca la opción de crear un nuevo usuario:
- Nombre de usuario: por ejemplo, wp_user.
- Contraseña: genera una segura o escribe una tú mismo. Guárdala bien, la necesitarás en el paso 3.
Haz clic en "Aceptar" o "OK".

[TIP] Anota el nombre de la base de datos, el usuario y la contraseña en un bloc de notas. Son los tres datos que usarás en el archivo wp-config.php.

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

El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress. Es decir, en la misma carpeta donde están las carpetas wp-admin, wp-content y wp-includes.

Para editarlo, tienes dos opciones:

Desde el administrador de archivos de Plesk: ve a "Administrador de archivos" en el panel, navega hasta tu carpeta de WordPress (normalmente httpdocs o public_html) y busca wp-config.php.
Desde FTP: conéctate con FileZilla o cualquier cliente FTP y descarga el archivo a tu ordenador.

Una vez que lo tengas localizado, ábrelo con un editor de texto plano (Notepad++, Sublime, o el editor que trae Plesk). El archivo es un script PHP con varias constantes definidas. Las que nos interesan son las de la base de datos, que están al principio del archivo y se ven así:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_usuario');
define('DB_HOST', 'localhost');

Paso 3: Configurar las constantes de conexión

Ahora viene la parte clave. Debes reemplazar los valores de estas constantes con los datos de tu base de datos recién creada.

define('DB_NAME', 'wordpress_db'); // El nombre exacto que pusiste en Plesk
define('DB_USER', 'wp_user');      // El usuario que creaste
define('DB_PASSWORD', 'TuContraseñaSegura'); // La contraseña que generaste
define('DB_HOST', 'localhost');    // Normalmente 'localhost', pero mira el paso siguiente

[WARNING] No uses comillas dobles dentro de los valores. Si tu contraseña contiene caracteres especiales como $, " o \, asegúrate de que esté entre comillas simples y que el carácter esté escapado. Un error aquí puede provocar un fallo de conexión.

¿Qué pongo en DB_HOST?

En la mayoría de los servidores con Plesk, el valor es localhost. Sin embargo, si tu base de datos está en un servidor separado (por ejemplo, un MySQL dedicado), tendrás que poner la IP o el nombre del servidor.

Para saberlo, revisa en Plesk la sección de "Bases de datos" y mira los detalles de tu base de datos. Ahí aparecerá el nombre del servidor (suele ser localhost o una IP tipo 127.0.0.1).

Paso 4: Guardar y subir el archivo

Una vez que hayas editado las cuatro líneas, guarda el archivo. Si lo estabas editando en local, súbelo de nuevo a tu servidor, reemplazando el archivo original.

Si lo estás editando directamente desde el administrador de archivos de Plesk, simplemente haz clic en "Guardar" y listo.

[TIP] Antes de subir el archivo, haz una copia de seguridad del original. Si algo sale mal, siempre puedes restaurarlo.

Paso 5: Probar la conexión

Ahora viene el momento de la verdad. Abre tu navegador y visita la URL de tu WordPress. Si todo ha ido bien, verás tu web funcionando sin problemas.

Si estás en plena instalación, deberías ver el asistente de instalación de WordPress. Si ya tenías WordPress instalado, deberías ver tu web tal y como estaba.

Error: "Error establishing a database connection" en WordPress y Plesk

Este es el error más temido y el más común cuando hablamos de conectar WordPress a MySQL en Plesk. La pantalla se queda en blanco o muestra ese mensaje en inglés. No te preocupes, tiene solución.

Causas y soluciones:

Datos incorrectos en wp-config.php: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste en Plesk. Un simple error tipográfico o un espacio extra rompe la conexión.
El usuario no tiene permisos sobre la base de datos: En Plesk, cuando creas un usuario junto con la base de datos, se le asignan automáticamente todos los privilegios. Pero si el usuario ya existía, es posible que no tenga permisos. Ve a la sección de "Bases de datos" en Plesk, selecciona tu base de datos y en la pestaña "Usuarios" asegúrate de que tu usuario esté marcado con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).
El servidor MySQL no está corriendo: Esto es menos común, pero puede pasar. En Plesk, ve a "Herramientas y configuración" > "Servicios" y verifica que el servicio MySQL esté activo.
Puerto incorrecto en DB_HOST: Si tu MySQL no escucha en el puerto 3306 (el estándar), tendrás que especificarlo. Por ejemplo: localhost:3307. Revisa la configuración de tu servidor.
El prefijo de tabla no coincide: Si estás migrando una web, el prefijo de las tablas (por defecto wp_) debe coincidir con el que tienes en la base de datos. Asegúrate de que la línea $table_prefix = 'wp_'; sea la correcta.

[INFO] Si has migrado tu web desde otro hosting, es muy probable que el problema sea el prefijo de las tablas. Revisa tu base de datos con phpMyAdmin (desde Plesk) para ver si las tablas se llaman wp_posts, wp_options, etc.

Configuración avanzada: añadir claves de seguridad

Una vez que la conexión funciona, es una buena práctica añadir las claves de seguridad (Authentication Unique Keys and Salts). Estas claves mejoran la seguridad de tu instalación, cifrando las cookies y las contraseñas.

En el archivo wp-config.php, justo después de la sección de la base de datos, hay un bloque que dice:

define('AUTH_KEY', 'pon tu frase única aquí');
define('SECURE_AUTH_KEY', 'pon tu frase única aquí');
define('LOGGED_IN_KEY', 'pon tu frase única aquí');
define('NONCE_KEY', 'pon tu frase única aquí');
define('AUTH_SALT', 'pon tu frase única aquí');
define('SECURE_AUTH_SALT', 'pon tu frase única aquí');
define('LOGGED_IN_SALT', 'pon tu frase única aquí');
define('NONCE_SALT', 'pon tu frase única aquí');

Puedes generar claves aleatorias desde https://api.wordpress.org/secret-key/1.1/salt/. Copia y pega las que te dé la página. No pasa nada si ya tienes unas puestas, puedes cambiarlas cuando quieras.

Preguntas frecuentes (FAQ)

¿Puedo usar el mismo usuario para varias bases de datos?

Sí, puedes. Pero no es recomendable por seguridad. Lo ideal es un usuario por base de datos. Si necesitas hacerlo, asegúrate de que el usuario tenga permisos solo sobre las bases de datos que vaya a usar.

¿Qué hago si no encuentro el archivo wp-config.php?

Si no existe, puedes crearlo. WordPress incluye un archivo llamado wp-config-sample.php. Cópialo y renómbralo a wp-config.php, luego edítalo con los datos de tu base de datos.

¿Cómo cambio la contraseña de la base de datos desde Plesk?

Ve a "Bases de datos" > selecciona tu base de datos > pestaña "Usuarios" > haz clic en el usuario > "Cambiar contraseña". Después de cambiarla, tendrás que actualizar también el archivo wp-config.php con la nueva contraseña.

¿Puedo conectar WordPress a una base de datos externa (fuera de Plesk)?

Sí, es posible. En el DB_HOST tendrás que poner la IP del servidor MySQL externo y asegurarte de que el puerto 3306 esté abierto en el firewall. Además, el servidor MySQL debe tener configurado el acceso remoto.

¿Qué es Syspanel y en qué se diferencia de Plesk?

Syspanel es el nombre que recibe el panel de control HestiaCP en este contexto. Si tu hosting usa Syspanel, el puerto de acceso es el 2106 (en lugar del 8443 de Plesk). El proceso de creación de bases de datos y configuración de wp-config.php es muy similar, aunque los nombres de los menús pueden variar ligeramente.

Resumen y consejos finales

Conectar WordPress a una base de datos MySQL en Plesk es un proceso sencillo si sigues los pasos correctos. La clave está en tener los datos exactos de tu base de datos y en escribir correctamente el archivo wp-config.php.

Recuerda:

Crea siempre la base de datos y el usuario desde Plesk para evitar problemas de permisos.
Guarda las contraseñas en un lugar seguro.
Si algo falla, revisa primero los datos de conexión y luego los permisos del usuario.
No te olvides de las claves de seguridad para una instalación robusta.

La mayoría de los errores de conexión se deben a pequeñas erratas o a la falta de permisos. Con un poco de paciencia y esta guía, tendrás tu WordPress funcionando en cuestión de minutos.

[TIP] Si después de todo sigues con problemas, prueba a instalar WordPress desde el instalador de Plesk. A veces es más rápido que buscar el fallo manualmente, y el instalador configura todo automáticamente.

Glosario rápido

MySQL: Sistema de gestión de bases de datos relacional. Es el motor que usa WordPress.
wp-config.php: Archivo de configuración principal de WordPress. Contiene los datos de conexión a la base de datos.
Plesk: Panel de control de hosting que facilita la gestión de sitios web, bases de datos, correo, etc.
DB_HOST: Dirección del servidor de base de datos. Normalmente localhost.
Prefijo de tablas: Cadena que precede a los nombres de las tablas de WordPress. Por defecto es wp_.

Esperamos que este artículo te haya sido de ayuda. Si tienes más dudas, no dudes en consultar la documentación oficial de WordPress o contactar con tu proveedor de hosting. ¡Buena suerte con tu web!