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

¿Tienes problemas para acceder a tu sitio web de WordPress y ves un mensaje de error de conexión a la base de datos? No te preocupes, es una de las incidencias más comunes y, por suerte, una de las más fáciles de solucionar si sabes dónde mirar. En esta guía rápida y completa, te explicaré paso a paso cómo conectar base de datos WordPress de forma manual, ya sea que estés migrando tu sitio, reinstalando WordPress o corrigiendo un error tras un cambio de servidor. Te garantizo que, al final de este artículo, podrás resolverlo tú mismo sin necesidad de ser un experto en programación. Vamos a ello.

¿Qué significa realmente "conectar una base de datos a WordPress"?

Para que tu web funcione, WordPress necesita dos cosas esenciales: los archivos del programa (el núcleo, temas y plugins) y una base de datos donde se almacena todo tu contenido: artículos, páginas, comentarios, configuraciones de usuarios, etc. La conexión entre ambos se realiza a través de un archivo llamado wp-config.php. Si este archivo no tiene los datos correctos (nombre de la base de datos, usuario, contraseña y servidor), WordPress no podrá acceder a tu contenido y mostrará un error como "Error al establecer una conexión a la base de datos".

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

Para conectar base de datos WordPress, necesitarás cuatro datos clave. Si no los tienes, deberás obtenerlos desde el panel de control de tu hosting (cPanel, Syspanel, Plesk, etc.).

Nombre de la base de datos: Por ejemplo, miusuario_wpdb.
Nombre de usuario de la base de datos: Por ejemplo, miusuario_wpuser.
Contraseña de la base de datos: La que creaste al generar el usuario.
Host de la base de datos: Normalmente es localhost, pero en algunos servidores puede ser una dirección IP o un nombre como mysql.tudominio.com.

[TIP] Si aún no tienes una base de datos creada, accede a tu panel de hosting (cPanel, Syspanel, etc.) y busca la sección "Bases de Datos MySQL". Allí podrás crear una nueva base de datos, un usuario y asignarle todos los privilegios. ¡No olvides anotar la contraseña!

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

Este es el archivo clave. Se encuentra en la raíz de tu instalación de WordPress, normalmente en la carpeta public_html (o www). Puedes acceder a él de dos formas:

Opción A: A través de cPanel (o Syspanel) – File Manager

Esta es la opción más segura y recomendada si no tienes experiencia con FTP.

Inicia sesión en tu panel de control. Si usas Syspanel, recuerda que el puerto de acceso es el 2106 (ejemplo: https://tudominio.com:2106).
Busca la herramienta Administrador de archivos (File Manager).
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o tu-dominio.com).
Localiza el archivo wp-config.php. Si no lo ves, asegúrate de tener activada la opción "Mostrar archivos ocultos".
Haz clic derecho sobre el archivo y selecciona Editar (o Code Editor). Se abrirá un editor de texto.

Opción B: A través de FTP (FileZilla, Cyberduck, etc.)

Si prefieres usar un cliente FTP, conecta a tu servidor y navega hasta la carpeta raíz de WordPress. Descarga el archivo wp-config.php, ábrelo con un editor de texto plano (como Bloc de notas o Sublime Text) y luego súbelo de nuevo reemplazando el original.

[WARNING] ¡Cuidado! Siempre haz una copia de seguridad del archivo wp-config.php antes de modificarlo. Un error podría dejar tu web inaccesible. Si no tienes copia, puedes descargar una copia local antes de editarlo.

Paso 2: Identificar y modificar las líneas de conexión

Dentro del archivo wp-config.php, busca un bloque de código similar a este (normalmente al principio del archivo):

// ** Configuración de la base de datos de WordPress – Puedes obtenerla de tu hosting ** //
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'nombre_de_tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Aquí es donde debes introducir los datos que recopilaste al principio. Reemplaza cada valor:

DB_NAME: Pon el nombre exacto de tu base de datos.
DB_USER: El nombre del usuario que tiene permisos sobre esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Normalmente es localhost. Si tu proveedor te ha proporcionado un host diferente (por ejemplo, mysql.tudominio.com o una IP), escríbelo exactamente como te lo dieron.

Ejemplo práctico:

Si tu base de datos se llama misitio_wp, tu usuario es admin_wp y la contraseña es ClaveSegura2023!, el bloque quedaría así:

define( 'DB_NAME', 'misitio_wp' );
define( 'DB_USER', 'admin_wp' );
define( 'DB_PASSWORD', 'ClaveSegura2023!' );
define( 'DB_HOST', 'localhost' );

Paso 3: Guardar los cambios y comprobar la conexión

Una vez que hayas modificado los datos:

Guarda el archivo (si estás en el editor online, haz clic en "Guardar cambios" o "Save Changes").
Cierra el editor.
Abre tu sitio web en el navegador. Si todo está correcto, tu web debería cargar normalmente. Si ves el error de conexión, repasa que no hayas escrito mal algún nombre o contraseña.

[INFO] Si después de cambiar los datos sigues viendo el error, es posible que el problema no sea el archivo wp-config.php, sino que la base de datos esté corrupta o que el servidor de bases de datos esté caído. En ese caso, contacta con tu soporte de hosting.

¿Qué hacer si no encuentras el archivo wp-config.php?

Esto puede ocurrir si estás instalando WordPress por primera vez o si el archivo se ha borrado accidentalmente. No te preocupes, puedes crearlo desde cero.

Descarga una copia nueva de WordPress desde wordpress.org.
Descomprime el archivo y busca el archivo llamado wp-config-sample.php.
Cámbiale el nombre a wp-config.php.
Ábrelo con un editor de texto y completa los datos de conexión siguiendo los pasos anteriores (encontrarás las mismas líneas define).
Además, deberás añadir las claves de seguridad (Salts). En el mismo archivo wp-config-sample.php verás un bloque con líneas como define('AUTH_KEY', ...) con texto genérico. Para mayor seguridad, ve a https://api.wordpress.org/secret-key/1.1/salt/, copia todo el bloque que te genere y pégalo reemplazando el original.
Sube el archivo wp-config.php a la raíz de tu WordPress (normalmente public_html).

Errores comunes y cómo solucionarlos

Incluso siguiendo los pasos, pueden surgir problemas. Aquí tienes los más frecuentes:

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

Causa más común: Datos incorrectos en wp-config.php. Revisa que el nombre, usuario y contraseña sean exactamente los que tienes en tu panel de hosting. A veces el hosting añade un prefijo al nombre de la base de datos (ej: tuusuario_nombrebasedatos).
Solución: Vuelve a los pasos 1 y 2, verifica cada carácter y prueba de nuevo.

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

Causa: La base de datos no existe o el usuario no tiene permisos para acceder a ella.
Solución: Accede a tu panel de control (cPanel, Syspanel, etc.), busca la sección de bases de datos MySQL y asegúrate de que el usuario esté asignado a la base de datos con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, asígnalos.

Error: "La conexión a la base de datos se ha perdido" (aparece de repente)

Causa: Puede ser un problema temporal del servidor, un plugin conflictivo o un límite de memoria excedido.
Solución temporal: Desactiva todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_old a través de FTP o File Manager. Si la web funciona, reactiva los plugins uno por uno para encontrar el culpable. También puedes aumentar el límite de memoria de WordPress añadiendo esta línea en wp-config.php (antes del comentario final /* That's all, stop editing! */):
```
define('WP_MEMORY_LIMIT', '256M');
```

Preguntas frecuentes (FAQ) sobre conexión a base de datos en WordPress

¿Puedo cambiar el prefijo de las tablas de la base de datos?

Sí, pero no es recomendable hacerlo manualmente a menos que seas un experto. Si lo haces, deberás modificar la línea $table_prefix = 'wp_'; en wp-config.php. Cambia wp_ por otro valor (ej: miweb_). Importante: Esto solo debe hacerse en una instalación nueva, ya que si ya tienes datos, las tablas existentes no se renombrarán automáticamente y tu web se romperá.

¿Qué pasa si cambio de hosting? ¿Tengo que modificar wp-config.php?

Sí, casi siempre. Al migrar tu web a un nuevo hosting, los datos de conexión (nombre de BD, usuario, contraseña y host) suelen ser diferentes. Deberás editar el archivo wp-config.php con los nuevos datos. Además, es posible que necesites cambiar la URL del sitio, lo cual se hace desde la base de datos o usando un plugin como "Better Search Replace".

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

Sí, en la mayoría de los casos. localhost es el nombre de host que se resuelve a 127.0.0.1. Si tu hosting te pide específicamente una IP, usa la que te proporcionen. Si no estás seguro, prueba con localhost primero.

¿Cómo sé si mi base de datos está funcionando correctamente?

Puedes hacer una prueba rápida desde el panel de control de tu hosting. Busca la herramienta phpMyAdmin (suele estar en cPanel o Syspanel). Si puedes acceder y ver las tablas de tu WordPress, la base de datos está bien. Si no puedes, contacta con soporte.

Conclusión: Ya sabes cómo conectar una base de datos a WordPress

Como has visto, conectar base de datos WordPress no es un proceso mágico ni complicado. Solo necesitas el archivo wp-config.php y los datos correctos de tu base de datos. Recuerda que la clave está en la precisión: un carácter mal escrito puede provocar que tu web no cargue. Siempre verifica dos veces antes de guardar.

Si has seguido todos los pasos de esta guía y tu sitio sigue sin funcionar, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo a los servidores y pueden ayudarte a diagnosticar problemas más profundos, como cortafuegos o configuraciones de red.

Espero que esta guía rápida te haya sido de gran ayuda. ¡Ahora ya puedes gestionar la conexión de tu WordPress como todo un profesional!