Conectar WordPress a MySQL en Plesk: Solución a errores comunes

¿Qué necesitas para conectar WordPress a MySQL en Plesk?

Antes de empezar con el proceso, es importante que tengas claros los tres elementos básicos que intervienen en la conexión entre WordPress y tu base de datos. Sin ellos, el proceso sería como intentar abrir una puerta sin llave: simplemente no funcionará.

Estos son los datos que necesitarás tener a mano:

Nombre de la base de datos: Es el identificador único que le pusiste a tu base de datos MySQL al crearla.
Usuario de la base de datos: La cuenta que tiene permisos para acceder y modificar los datos.
Contraseña del usuario: La clave secreta asociada al usuario anterior.
Host de la base de datos: La dirección del servidor donde se encuentra alojada tu base de datos. En la mayoría de los casos, especialmente en Plesk, será localhost.

Una vez que tengas estos cuatro datos, el proceso de conectar WordPress a tu base de datos se reduce a editar un archivo de configuración. Pero vamos paso a paso, porque cada fase tiene su importancia y sus posibles errores.

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

Si aún no has creado tu base de datos, este es el primer paso. No puedes conectar WordPress a una base de datos que no existe. Plesk hace este proceso bastante sencillo y visual, pero vamos a desglosarlo para que no te pierdas.

### Accediendo al panel de Plesk

Primero, inicia sesión en tu panel de control de Plesk. Normalmente, la dirección es algo como https://tu-dominio.com:8443 o la URL que te haya proporcionado tu proveedor de hosting. Una vez dentro, busca la sección que dice "Bases de datos". Suele estar en el menú lateral o en la pestaña de "Sitios web y dominios".

### Creando la base de datos

Haz clic en el botón "Agregar base de datos" o "Crear nueva base de datos".
En el campo "Nombre de la base de datos", escribe un nombre descriptivo. Por ejemplo, mipagina_wp. Evita usar caracteres especiales o espacios; usa guiones bajos en su lugar.
En el campo "Tipo de base de datos", asegúrate de que esté seleccionado MySQL.
Deja la opción del servidor de bases de datos como esté por defecto (normalmente es localhost).
Haz clic en "Aceptar" o "OK".

### Creando un usuario para la base de datos

Ahora que tienes la base de datos creada, necesitas un usuario que pueda conectarse a ella. Plesk te permite hacer esto directamente desde la misma pantalla.

Dentro de la configuración de tu nueva base de datos, busca la sección que dice "Agregar usuario de base de datos".
Escribe un nombre de usuario. Por ejemplo, wp_usuario.
Escribe una contraseña segura. Te recomiendo usar el generador de contraseñas que incluye Plesk, ya que crea claves muy difíciles de adivinar. Guárdala en un lugar seguro, la necesitarás más adelante.
Haz clic en "Aceptar".

[TIP] Asegúrate de que el usuario que has creado tenga todos los privilegios sobre la base de datos. Por defecto, Plesk suele asignarlos, pero si no es así, búscalo en las opciones de la base de datos y marca "TODOS LOS PRIVILEGIOS". Esto es crucial para que WordPress pueda instalar plugins, temas y gestionar archivos multimedia sin problemas.

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

Ahora viene la parte más importante del proceso. WordPress guarda toda la información de conexión en un archivo llamado wp-config.php. Este archivo se encuentra en la raíz de tu instalación de WordPress.

### ¿Cómo encuentro el archivo?

Tienes dos formas principales de hacerlo:

A través del Administrador de archivos de Plesk: En tu panel de Plesk, ve a "Administrador de archivos". Navega hasta la carpeta donde está instalado tu WordPress (normalmente httpdocs o public_html). Busca el archivo wp-config.php.
A través de FTP: Usa un cliente FTP como FileZilla para conectarte a tu servidor. Navega a la misma carpeta raíz y descarga el archivo wp-config.php a tu computadora para editarlo con un editor de texto plano como el Bloc de notas o Sublime Text.

### Editando el archivo correctamente

Una vez que tengas el archivo abierto, busca la sección que comienza con // ** Ajustes de MySQL ** //. Encontrarás líneas de código que definen el nombre de la base de datos, el usuario, la contraseña y el host. Deberías ver algo como esto:

// ** Ajustes de MySQL ** //
/** Nombre de la base de datos de WordPress */
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );

/** Usuario de la base de datos de MySQL */
define( 'DB_USER', 'tu_usuario' );

/** Contraseña de la base de datos de MySQL */
define( 'DB_PASSWORD', 'tu_contraseña' );

/** Host de la base de datos de MySQL */
define( 'DB_HOST', 'localhost' );

Ahora, simplemente reemplaza los valores entre comillas con los datos que creaste en el Paso 1.

En DB_NAME, pon el nombre de tu base de datos (ej: mipagina_wp).
En DB_USER, pon el nombre de tu usuario (ej: wp_usuario).
En DB_PASSWORD, pon la contraseña que elegiste.
En DB_HOST, normalmente deja localhost. Solo cámbialo si tu proveedor de hosting te indica un host diferente.

[WARNING] NO uses un editor de texto enriquecido como Microsoft Word para editar este archivo. Debes usar un editor de texto plano, ya que los procesadores de texto añaden caracteres invisibles que pueden romper el código y provocar el temido error de conexión con la base de datos.

Una vez que hayas editado los valores, guarda el archivo y súbelo de nuevo al servidor si lo habías descargado. Si lo editaste directamente en el Administrador de archivos de Plesk, guarda los cambios.

Paso 3: Subir WordPress y ejecutar la instalación

Si estás instalando WordPress desde cero, este paso es el siguiente. Si ya tenías WordPress instalado y solo estás cambiando la base de datos, puedes saltar al Paso 4.

Para una instalación nueva, sube todos los archivos de WordPress a tu carpeta raíz (httpdocs o public_html). Puedes usar el Administrador de archivos de Plesk o FTP. Una vez subidos, abre tu navegador y visita tu dominio (ej: https://tudominio.com). WordPress detectará que no hay una instalación configurada y te mostrará el asistente de instalación.

Sigue los pasos del asistente. Te pedirá el nombre de tu sitio, un usuario administrador y una contraseña. WordPress usará automáticamente los datos que configuraste en el wp-config.php para conectarse a la base de datos y crear las tablas necesarias.

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

Este es, sin duda, el problema más común al que nos enfrentamos todos. El mensaje típico es: "Error al establecer la conexión con la base de datos". No te preocupes, casi siempre tiene una solución sencilla. Vamos a repasar las causas más frecuentes y cómo solucionarlas.

### 1. Datos incorrectos en wp-config.php

Este es el error más común. Vuelve a revisar el archivo wp-config.php y asegúrate de que los cuatro valores (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST) son exactamente los que creaste en Plesk. Un simple error tipográfico, un espacio extra o una letra en mayúscula que no debería estar, pueden provocar este error.

[WARNING] Presta mucha atención a las mayúsculas y minúsculas en los nombres de la base de datos y del usuario. En MySQL, los nombres de las bases de datos y los usuarios pueden ser sensibles a mayúsculas y minúsculas, dependiendo de la configuración del servidor.

### 2. El usuario no tiene permisos

Es posible que el usuario que creaste no tenga todos los privilegios sobre la base de datos. Ve a Plesk, entra en tu base de datos y verifica que el usuario tenga marcados todos los permisos, especialmente ALL PRIVILEGES o todos los que aparezcan en la lista.

### 3. El host de la base de datos no es 'localhost'

Aunque es raro, algunos proveedores de hosting utilizan un host específico para sus bases de datos. Si tu proveedor te ha dado una dirección diferente, como mysql.tudominio.com, deberás cambiar el valor de DB_HOST en tu archivo wp-config.php. Esta información suele estar en el correo de bienvenida de tu hosting o en la documentación de soporte.

### 4. Problemas con el prefijo de las tablas

Si estás intentando conectar WordPress a una base de datos que ya existía, es posible que las tablas tengan un prefijo diferente al que WordPress espera por defecto (wp_). Si este es el caso, deberás indicar el prefijo correcto en tu archivo wp-config.php. Busca la línea que dice:

$table_prefix = 'wp_';

Y cámbiala por el prefijo que utilicen tus tablas. Por ejemplo, si tus tablas se llaman miwp_opciones, el prefijo sería miwp_.

Preguntas frecuentes (FAQ) sobre conectar WordPress a MySQL en Plesk

Aquí te dejo algunas de las dudas más habituales que resolvemos en soporte técnico. Seguro que alguna te resulta familiar.

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

No es recomendable. Cada instalación de WordPress debe tener su propia base de datos. Si usas la misma, las tablas se mezclarán y los datos de un sitio podrían sobrescribir a los del otro, causando errores graves e incluso la pérdida de información.

¿Qué hago si he olvidado la contraseña de mi base de datos?

No pasa nada, puedes cambiarla desde Plesk. Ve a la sección de "Bases de datos", selecciona tu base de datos y busca la opción de cambiar la contraseña del usuario. Después de cambiarla, tendrás que actualizar también el valor en tu archivo wp-config.php.

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

En la mayoría de los casos, sí. Ambos apuntan al servidor local. Sin embargo, algunos servidores pueden tener configuraciones que hagan que uno funcione y el otro no. Si localhost no te funciona, prueba con 127.0.0.1.

¿Por qué me aparece "Error al conectar con la base de datos" justo después de migrar mi sitio?

Esto es muy común al migrar sitios web. Las causas más frecuentes son que los datos en el wp-config.php no se han actualizado con los de la nueva base de datos o que el archivo se ha corrompido durante la transferencia. Revisa el Paso 2 y el Paso 4 de esta guía.

¿Necesito conocimientos avanzados para hacer esto?

Para nada. Con esta guía, cualquier persona puede hacerlo. Solo necesitas seguir los pasos con calma y asegurarte de copiar y pegar los datos correctamente. Si te atascas, siempre puedes contactar con el soporte técnico de tu hosting.

[INFO] Si tu hosting utiliza Syspanel (antes conocido como HestiaCP) en lugar de Plesk, el proceso es similar, pero el panel es diferente. Para acceder a la gestión de bases de datos en Syspanel, deberás hacerlo a través del puerto 2106 (ej: https://tu-dominio.com:2106). Busca la sección de "Bases de datos" y sigue los mismos principios que te he explicado aquí, ya que la lógica de creación de bases de datos y usuarios es muy parecida.

Conclusión final

Conectar WordPress a una base de datos MySQL en Plesk es un proceso fundamental y, una vez que lo entiendes, muy sencillo. La clave está en tener los datos correctos y saber dónde colocarlos. Hemos visto cómo crear la base de datos y el usuario, cómo editar el archivo wp-config.php y cómo solucionar los errores más comunes, especialmente el temido error de conexión a la base de datos.

Recuerda que la paciencia es tu mejor aliada. Revisa cada dato dos veces, guarda los cambios y, si algo falla, no dudes en volver a esta guía. Con un poco de práctica, podrás hacerlo en cuestión de minutos. Si aun así tienes problemas, tu proveedor de hosting siempre estará ahí para echarte una mano. ¡Mucha suerte con tu WordPress!