Conectar base de datos a WordPress: tutorial paso a paso

Conectar tu sitio WordPress con una base de datos es uno de los pasos fundamentales para que tu web funcione correctamente. WordPress utiliza MySQL (o MariaDB) para almacenar todo tu contenido: entradas, páginas, comentarios, configuraciones de plugins y usuarios. Sin esta conexión, tu sitio no puede existir. En esta guía te explicaremos paso a paso cómo realizar esta conexión, ya sea durante una instalación nueva, una migración o una solución de errores.

¿Qué es una base de datos y por qué WordPress la necesita?

Imagina tu base de datos como un enorme archivador digital. Cada vez que alguien visita tu web, WordPress consulta este archivador para mostrar la información correcta. Sin una base de datos, tu sitio sería como una biblioteca sin libros. WordPress usa MySQL (o su variante MariaDB) como sistema gestor de base de datos. Esta es la tecnología estándar en la mayoría de los hosting compartidos, VPS y servidores dedicados.

La conexión entre WordPress y la base de datos se define en un archivo llamado wp-config.php. Este archivo contiene cuatro datos clave:

Nombre de la base de datos (DB_NAME)
Usuario de la base de datos (DB_USER)
Contraseña del usuario (DB_PASSWORD)
Servidor de la base de datos (DB_HOST)

Si alguno de estos datos es incorrecto, tu web mostrará el temido error "Error al establecer una conexión con la base de datos".

Requisitos previos antes de conectar

Antes de empezar, asegúrate de tener lo siguiente:

Acceso a tu panel de hosting (cPanel, Plesk, DirectAdmin o Syspanel).
Una base de datos MySQL ya creada (o los permisos para crearla).
Un usuario con todos los privilegios sobre esa base de datos.
Conocimiento de la dirección del servidor de base de datos (normalmente localhost, pero puede variar).
Tu sitio WordPress ya instalado o los archivos descargados.

[INFO] Si aún no tienes una base de datos, la mayoría de los paneles de hosting te permiten crearla en pocos clics. Más adelante te explicamos cómo hacerlo en los paneles más comunes.

Paso 1: Crear la base de datos y el usuario

El primer paso es tener una base de datos lista. Dependiendo de tu panel de control, el proceso varía ligeramente. Aquí te mostramos cómo hacerlo en los paneles más populares.

En cPanel

cPanel es uno de los paneles más utilizados en hosting compartido. Sigue estos pasos:

Inicia sesión en tu cPanel (normalmente tudominio.com/cpanel).
Busca la sección Bases de Datos y haz clic en MySQL Databases.
En Create New Database, escribe un nombre para tu base de datos (ej: mipagina_wp). Haz clic en Create Database.
Ve a MySQL Users y crea un nuevo usuario (ej: mipagina_user) con una contraseña segura. Anótala.
En Add User to Database, selecciona el usuario y la base de datos que creaste. Marca ALL PRIVILEGES y haz clic en Add.
Listo. Tu base de datos está creada. Recuerda que el nombre completo suele incluir el prefijo de tu cuenta (ej: tuusuario_mipagina_wp).

En Plesk

Plesk es común en servidores VPS y dedicados. El proceso es igual de sencillo:

Accede a tu panel de Plesk (normalmente tudominio.com:8443).
Ve a Bases de datos en el menú de la izquierda.
Haz clic en Añadir base de datos.
Introduce un nombre para la base de datos (ej: wordpress_db). Selecciona MySQL como tipo.
Marca la opción Crear un usuario de base de datos e introduce un nombre de usuario y contraseña.
Haz clic en Aceptar. La base de datos y el usuario se crearán automáticamente.

En DirectAdmin

DirectAdmin es otro panel popular, especialmente en servidores más económicos:

Inicia sesión en tu DirectAdmin (normalmente tudominio.com:2222).
Ve a MySQL Management en la sección de Extra Features o Account Manager.
Haz clic en Create new database.
Introduce un nombre para la base de datos. DirectAdmin te pedirá también un usuario y contraseña. Complétalos.
Haz clic en Create. La base de datos y el usuario se crearán automáticamente.

En Syspanel (HestiaCP)

Si tu hosting usa Syspanel (basado en HestiaCP), el proceso es similar. Recuerda que el puerto de acceso es el 2106.

Accede a tu Syspanel: tudominio.com:2106.
Ve a Bases de datos en el menú superior.
Haz clic en Añadir base de datos.
Introduce un nombre (ej: mipagina). Syspanel generará automáticamente un usuario y contraseña. Anótalos.
Selecciona el tipo MySQL y haz clic en Añadir.

[TIP] En Syspanel, el nombre de la base de datos suele tener el formato nombreusuario_nombrebasededatos. Asegúrate de copiarlo exactamente.

Paso 2: Obtener los datos de conexión

Una vez creada la base de datos y el usuario, necesitas cuatro datos:

DB_NAME: El nombre exacto de la base de datos (incluyendo prefijos si los hay).
DB_USER: El nombre del usuario que creaste.
DB_PASSWORD: La contraseña del usuario.
DB_HOST: Normalmente es localhost, pero en algunos hosting puede ser una IP o un nombre como mysql.tudominio.com. Si no estás seguro, consulta con tu proveedor de hosting o revisa el panel de control.

[WARNING] Nunca compartas estos datos públicamente. Si alguien los obtiene, podría acceder a toda tu información. Guárdalos en un lugar seguro.

Paso 3: Configurar la conexión en WordPress

Ahora que tienes los datos, es momento de conectar WordPress con la base de datos. Hay dos escenarios comunes: durante una instalación nueva o al migrar un sitio existente.

Durante una instalación nueva

Si estás instalando WordPress por primera vez, el proceso es guiado:

Descarga WordPress desde wordpress.org y súbelo a tu servidor (o usa el instalador automático de tu panel).
Accede a tudominio.com/wp-admin/install.php.
Selecciona tu idioma y haz clic en Continuar.
WordPress te pedirá los datos de conexión. Introduce:
- Nombre de la base de datos: el que creaste.
- Usuario de la base de datos: el que creaste.
- Contraseña: la del usuario.
- Servidor de la base de datos: normalmente localhost.
- Prefijo de tabla: puedes dejarlo como wp_ o cambiarlo por seguridad.
Haz clic en Enviar. Si todo está correcto, WordPress creará las tablas y te llevará a la pantalla de configuración del sitio.

En una migración o instalación manual

Si ya tienes los archivos de WordPress en tu servidor (por ejemplo, después de una migración), deberás editar el archivo wp-config.php manualmente:

Conéctate a tu servidor mediante FTP o el administrador de archivos de tu panel.
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca las líneas que comienzan con define( y reemplázalas con tus datos:

define('DB_NAME', 'tu_nombre_de_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Guarda el archivo y súbelo de nuevo al servidor (si lo editaste localmente).

[TIP] Si tu servidor usa una dirección diferente a localhost para la base de datos, pregúntale a tu proveedor. A veces es algo como mysql.tudominio.com o una IP como 192.168.1.100.

Solución de problemas comunes

A veces, incluso siguiendo todos los pasos, pueden surgir errores. Aquí tienes los más frecuentes y cómo solucionarlos.

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

Este es el error más común. Las causas pueden ser:

Datos incorrectos: Revisa que el nombre de la base de datos, usuario y contraseña sean exactamente los que creaste. A veces hay prefijos ocultos.
Servidor de base de datos incorrecto: Prueba cambiando localhost por 127.0.0.1 o la IP que te haya proporcionado tu hosting.
Usuario sin permisos: Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. En cPanel, puedes verificarlo en la sección MySQL Databases.
Base de datos no creada: Verifica que la base de datos exista en tu panel.

[WARNING] Si después de revisar todo sigue sin funcionar, contacta con tu proveedor de hosting. Puede haber un problema en el servidor o un firewall bloqueando la conexión.

Error: "No se puede seleccionar la base de datos"

Este error suele indicar que la base de datos no existe o el nombre está mal escrito. Revisa el nombre exacto en tu panel de control.

Error: "La conexión a la base de datos se ha perdido"

Esto puede ocurrir si el servidor de base de datos está sobrecargado o si hay un problema de red. Espera unos minutos y vuelve a intentarlo. Si persiste, contacta a tu hosting.

Preguntas frecuentes (FAQ)

¿Puedo usar MariaDB en lugar de MySQL?

Sí, WordPress es compatible con MariaDB sin problemas. De hecho, muchos hosting lo usan por defecto. El proceso de conexión es idéntico.

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

Puedes cambiarla desde tu panel de control. En cPanel, ve a MySQL Databases y en la sección de usuarios, haz clic en Change Password. Luego actualiza el archivo wp-config.php con la nueva contraseña.

¿Es seguro usar 'localhost' como servidor de base de datos?

Sí, es la opción más común y segura, ya que la base de datos está en el mismo servidor que tu sitio. Si tu hosting te da una dirección externa, úsala solo si es necesario.

¿Puedo conectar WordPress a una base de datos remota?

Sí, pero no es recomendable por temas de velocidad y seguridad. Si lo necesitas, configura el DB_HOST con la IP o dominio del servidor remoto y asegúrate de que los firewalls permitan la conexión.

¿Qué es el prefijo de tabla y debo cambiarlo?

El prefijo (por defecto wp_) se añade al inicio de cada tabla en la base de datos. Cambiarlo (ej: miwp_) puede mejorar la seguridad, pero no es obligatorio. Si ya tienes tablas con otro prefijo, deberás mantenerlo.

¿Cómo verifico que la conexión funciona?

Simplemente visita tu sitio web. Si cargan las páginas y el panel de administración, la conexión es correcta. También puedes instalar un plugin como Health Check & Troubleshooting para verificar el estado.

Conclusión

Conectar una base de datos con WordPress es un proceso sencillo si sigues los pasos adecuados. Ya sea que uses cPanel, Plesk, DirectAdmin o Syspanel (recuerda el puerto 2106), la clave está en tener los datos correctos y configurarlos en el archivo wp-config.php. No temas a los errores; la mayoría se solucionan revisando los nombres y permisos.

Si después de leer esta guía sigues teniendo dudas, no dudes en contactar con el soporte de tu hosting. Ellos pueden darte los datos exactos de conexión y ayudarte con problemas específicos. Recuerda que una base de datos bien configurada es la base de un WordPress rápido y estable.

[INFO] Guarda siempre una copia de seguridad de tu base de datos. Puedes hacerlo desde tu panel de control o usando plugins como UpdraftPlus. Así, si algo sale mal, podrás restaurar tu sitio rápidamente.