Conectar WordPress a base de datos MySQL: guía paso a paso

¿Qué es la conexión de WordPress a una base de datos?

Antes de empezar con los pasos técnicos, es importante entender qué significa conectar WordPress a una base de datos. WordPress es un sistema de gestión de contenidos (CMS) que utiliza una base de datos para almacenar toda tu información: entradas, páginas, comentarios, configuraciones de plugins, usuarios y más. Sin una base de datos, WordPress no puede funcionar, ya que no tendría dónde guardar ni recuperar los datos de tu sitio.

La base de datos más común para WordPress es MySQL, aunque también puede usar MariaDB (una variante compatible). Cuando instalas WordPress por primera vez, el proceso de configuración te pide los datos de conexión a la base de datos. Si ya tienes un sitio y necesitas cambiarla (por ejemplo, por un cambio de servidor o una migración), también puedes hacerlo manualmente.

En este artículo, te guiaré paso a paso para que puedas conectar WordPress a tu base de datos, tanto durante la instalación como después, si ya tienes el sitio funcionando. Incluyo consejos prácticos, alertas importantes y una sección de preguntas frecuentes para resolver tus dudas.

Requisitos previos para conectar WordPress a una base de datos

Para poder conectar WordPress a una base de datos, necesitas tener acceso a cierta información. Aquí te detallo lo que debes tener listo:

Un servidor web (como Apache o Nginx) donde esté instalado WordPress.
Un sistema de gestión de bases de datos (MySQL o MariaDB) instalado y funcionando.
Credenciales de la base de datos: nombre de la base de datos, usuario, contraseña y host (generalmente "localhost" o la IP del servidor).
Acceso al panel de control de tu hosting (como cPanel, Syspanel u otro) o acceso por línea de comandos (SSH) si eres más técnico.

[TIP] Si usas un panel de control como Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es el 2106. Puedes acceder a tu panel escribiendo en el navegador: https://tudominio.com:2106. Allí podrás crear bases de datos y usuarios fácilmente.

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

El primer paso es tener una base de datos lista para usar. Si ya la tienes creada, puedes saltar al paso 2. Si no, aquí te explico cómo hacerlo desde un panel de control típico.

Desde Syspanel (HestiaCP)

Inicia sesión en tu panel Syspanel usando el puerto 2106 (ejemplo: https://tudominio.com:2106).
Ve a la sección Base de datos o MySQL.
Haz clic en Añadir base de datos.
Completa los campos:
- Nombre de la base de datos: elige un nombre descriptivo, por ejemplo mipagina_wp.
- Usuario: crea un usuario, por ejemplo usuario_wp.
- Contraseña: genera una contraseña segura (puedes usar el generador automático).
Guarda los cambios. El sistema te mostrará los datos de conexión (host, nombre, usuario y contraseña). Anótalos.

Desde cPanel

Entra a cPanel de tu hosting.
Busca la sección Bases de datos MySQL.
Haz clic en Crear nueva base de datos y ponle un nombre.
Luego, en Usuarios MySQL, crea un nuevo usuario con contraseña.
Finalmente, en Añadir usuario a base de datos, asigna el usuario a la base de datos y otórgale todos los privilegios.

[WARNING] No uses caracteres especiales ni espacios en el nombre de la base de datos o del usuario. Solo letras, números y guiones bajos. Esto evita errores de conexión.

Paso 2: Configurar la conexión durante la instalación de WordPress

Si estás instalando WordPress desde cero, el proceso es guiado. Aquí te explico cómo proceder:

Descarga la última versión de WordPress desde wordpress.org y súbela a tu servidor (o usa el instalador automático de tu hosting).
Accede a tu dominio en el navegador (por ejemplo, https://tudominio.com). Verás la pantalla de bienvenida de WordPress.
Selecciona tu idioma y haz clic en Continuar.
Te aparecerá una pantalla con los datos de la base de datos. Debes ingresar:
- Nombre de la base de datos: el que creaste en el paso 1.
- Usuario de la base de datos: el usuario que creaste.
- Contraseña: la contraseña de ese usuario.
- Host de la base de datos: normalmente es localhost. Si tu base de datos está en otro servidor, pon la IP o el nombre del host.
- Prefijo de tabla: déjalo como wp_ a menos que tengas razones para cambiarlo (por seguridad, puedes usar otro prefijo como miwp_).
Haz clic en Enviar. WordPress verificará la conexión. Si todo está bien, verás un mensaje de éxito.
Continúa con la instalación: pon el título del sitio, usuario administrador, contraseña y correo electrónico.

[INFO] Si ves un error de conexión, revisa que los datos sean correctos. Asegúrate de que el usuario tenga permisos para acceder a la base de datos. También verifica que el servidor MySQL esté funcionando.

Paso 3: Configurar la conexión en un WordPress ya instalado

Si ya tienes WordPress funcionando y necesitas cambiar la base de datos (por ejemplo, después de una migración), debes modificar el archivo wp-config.php. Este archivo se encuentra en la raíz de tu instalación de WordPress.

Localizar y editar wp-config.php

Accede a tu servidor mediante FTP, cPanel (Administrador de archivos) o SSH.
Busca el archivo wp-config.php en la carpeta principal de WordPress.
Ábrelo con un editor de texto (como Notepad++ o el editor de cPanel).
Busca las líneas que definen la conexión a la base de datos. Se ven así:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

Reemplaza los valores entre comillas con los nuevos datos:
- DB_NAME: el nombre de tu nueva base de datos.
- DB_USER: el usuario de la base de datos.
- DB_PASSWORD: la contraseña correspondiente.
- DB_HOST: si es el mismo servidor, déjalo como localhost. Si es externo, pon la IP o el nombre del host.
Guarda los cambios y sube el archivo si lo editaste localmente.

[WARNING] Antes de editar wp-config.php, haz una copia de seguridad del archivo original. Si algo sale mal, puedes restaurarlo fácilmente.

Verificar la conexión

Después de modificar el archivo, accede a tu sitio web. Si todo está correcto, verás tu sitio funcionando normalmente. Si aparece un error de conexión a la base de datos, revisa que los datos sean exactos (mayúsculas, minúsculas, espacios). También asegúrate de que la nueva base de datos tenga los datos migrados (puedes usar un plugin como "WP Migrate DB" o importar un SQL manualmente).

Solución de problemas comunes al conectar WordPress a una base de datos

A veces la conexión falla. Aquí tienes los errores más frecuentes y cómo solucionarlos:

Error 1: "Error al establecer conexión con la base de datos"

Causa: Los datos de conexión son incorrectos o el servidor MySQL no responde.
Solución: Verifica el nombre de la base de datos, usuario, contraseña y host en wp-config.php. Comprueba que MySQL esté activo en tu servidor.

Error 2: "Base de datos no encontrada"

Causa: El nombre de la base de datos no existe o tiene un error tipográfico.
Solución: Revisa el nombre en tu panel de control. A veces los paneles añaden un prefijo (como el nombre de usuario). Por ejemplo, en Syspanel, la base de datos puede llamarse usuario_nombre.

Error 3: "Permiso denegado para el usuario"

Causa: El usuario no tiene privilegios suficientes sobre la base de datos.
Solución: Desde tu panel, asigna al usuario todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, etc.).

Error 4: "Host de base de datos no válido"

Causa: El valor de DB_HOST no es correcto.
Solución: Normalmente es localhost. Si tu base de datos está en un servidor separado, usa la IP o el nombre del host (por ejemplo, mysql.servidor.com). Pregunta a tu proveedor de hosting si no estás seguro.

[TIP] Si usas Syspanel, el host suele ser localhost a menos que tengas un servidor de bases de datos dedicado. En ese caso, tu proveedor te dará la dirección exacta.

FAQ WordPress sobre conexión a base de datos

Aquí respondo las preguntas más comunes que recibimos en soporte técnico.

1. ¿Puedo cambiar el prefijo de las tablas después de instalar WordPress?

Sí, pero no es recomendable hacerlo manualmente porque implica modificar muchas tablas y archivos. Si necesitas cambiarlo, usa un plugin como "Change Table Prefix" o hazlo antes de la instalación. Si ya tienes contenido, es más seguro dejar el prefijo original.

2. ¿Qué hago si olvido la contraseña de la base de datos?

Puedes cambiarla desde el panel de control de tu hosting. En Syspanel, ve a la sección de bases de datos, selecciona el usuario y cambia la contraseña. Luego, actualiza el archivo wp-config.php con la nueva contraseña.

3. ¿Es seguro usar "localhost" como host de base de datos?

Sí, es seguro si tu base de datos está en el mismo servidor que WordPress. De hecho, es la configuración más común y recomendada para sitios pequeños y medianos. Para sitios grandes, a veces se usa un servidor de bases de datos separado por rendimiento.

4. ¿Puedo tener varias bases de datos para un solo WordPress?

No, WordPress solo funciona con una base de datos. Sin embargo, puedes tener múltiples sitios WordPress en el mismo servidor, cada uno con su propia base de datos.

5. ¿Cómo migrar mi WordPress a una nueva base de datos?

Primero, exporta la base de datos antigua (usando phpMyAdmin o un plugin). Luego, crea una nueva base de datos en el nuevo servidor e importa el SQL. Finalmente, actualiza wp-config.php con los nuevos datos de conexión.

6. ¿Qué es MySQL y por qué lo usa WordPress?

MySQL es un sistema de gestión de bases de datos relacional. WordPress lo usa porque es gratuito, rápido y ampliamente compatible con la mayoría de servidores. Es el motor estándar para almacenar y recuperar datos.

7. ¿Puedo conectar WordPress a una base de datos remota?

Sí, es posible. En wp-config.php, cambia DB_HOST por la IP o nombre del servidor remoto. Asegúrate de que el servidor remoto permita conexiones externas y que el usuario tenga permisos desde cualquier host (o desde la IP de tu servidor web).

Consejos finales para mantener tu conexión segura

Usa contraseñas fuertes para la base de datos. Evita palabras comunes o fechas.
Cambia el prefijo de tabla por defecto (wp_) durante la instalación para dificultar ataques de inyección SQL.
Actualiza WordPress, plugins y temas regularmente. Las vulnerabilidades pueden exponer tu base de datos.
Haz copias de seguridad periódicas de tu base de datos. Puedes usar plugins como "UpdraftPlus" o herramientas del hosting.
No compartas tus credenciales de la base de datos con nadie que no sea de confianza.

[INFO] En Syspanel, puedes programar copias de seguridad automáticas de tus bases de datos desde el panel. Es muy útil para no olvidarte.

Con estos pasos, ya sabes cómo conectar WordPress a una base de datos, tanto en instalaciones nuevas como existentes. Recuerda que la paciencia y la atención a los detalles son clave. Si te surge alguna duda, consulta la documentación de tu hosting o contacta con soporte técnico. ¡Buena suerte con tu sitio web!