Configurar conexión a base de datos en WordPress: FAQ

¿Alguna vez has intentado acceder a tu WordPress y te has encontrado con el temido mensaje de "Error al establecer conexión con 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 este artículo, te voy a guiar paso a paso para que configures correctamente la conexión base de datos en WordPress. Vamos a trabajar directamente con el archivo wp-config.php, que es el corazón de la configuración de tu sitio. No necesitas ser un experto técnico, solo seguir estas instrucciones con calma.

Vamos a empezar.

¿Qué es el archivo wp-config.php y por qué es tan importante?

Cuando instalas WordPress, el sistema necesita saber dónde está almacenada toda tu información: tus artículos, páginas, usuarios, comentarios y configuraciones. Toda esta información se guarda en una base de datos, que es como un gran archivo de Excel organizado.

El archivo wp-config.php es el encargado de decirle a WordPress: "Oye, la base de datos está en esta dirección, con este usuario y esta contraseña". Sin este archivo correctamente configurado, WordPress no puede funcionar.

¿Dónde se encuentra este archivo?

El wp-config.php se encuentra en la raíz de tu sitio web, es decir, en la carpeta principal donde está instalado WordPress. Normalmente, si accedes a tu servidor mediante FTP o a través del administrador de archivos de tu hosting, verás una carpeta llamada public_html o www y dentro de ella, el archivo wp-config.php.

Paso 1: Obtén los datos de tu base de datos

Antes de tocar nada, necesitas tener a mano la siguiente información. Si no la tienes, no te preocupes, te explico cómo conseguirla:

Nombre de la base de datos (database_name)
Usuario de la base de datos (database_user)
Contraseña del usuario de la base de datos (database_password)
Servidor de la base de datos (database_host, normalmente es "localhost" o una IP)

¿Dónde encuentro estos datos si uso Syspanel (HestiaCP)?

Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el proceso es muy sencillo. Recuerda que accedes a tu panel de control a través del puerto 2106 (ejemplo: tudominio.com:2106).

Inicia sesión en Syspanel con tu usuario y contraseña.
Busca la sección de Bases de Datos. Normalmente está en el menú lateral izquierdo.
Allí verás una lista con todas las bases de datos que has creado. Si no tienes ninguna, puedes crear una nueva haciendo clic en "Añadir Base de Datos".
Al crearla o al seleccionar una existente, el propio panel te mostrará el nombre, el usuario y la contraseña que se ha generado. Anota estos datos.

[WARNING]: Si creas una base de datos nueva, asegúrate de recordar la contraseña. No la pierdas, porque luego tendrás que cambiar el wp-config.php manualmente.

Paso 2: Localiza y edita el archivo wp-config.php

Ahora que ya tienes los datos, vamos a trabajar con el archivo.

Opción A: Usando el administrador de archivos de tu hosting (Recomendado para principiantes)

Accede a Syspanel (puerto 2106) o al panel de control que uses (cPanel, Plesk, etc.).
Busca la opción Administrador de Archivos o File Manager.
Navega hasta la carpeta raíz de tu sitio (normalmente public_html o www).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de que estás viendo los archivos ocultos (suele haber un botón para ello).
Haz clic derecho sobre el archivo y selecciona Editar o Edit.
Se abrirá un editor de texto. No te asustes por el código, solo vamos a modificar una pequeña parte.

Opción B: Usando un cliente FTP (FileZilla, etc.)

Conéctate a tu servidor usando las credenciales FTP que te proporcionó tu hosting.
Navega a la carpeta raíz (public_html o www).
Descarga el archivo wp-config.php a tu ordenador.
Ábrelo con un editor de texto plano como Bloc de Notas (Windows) o TextEdit (Mac, en modo texto plano). No uses Word ni procesadores de texto, ya que pueden añadir caracteres extraños.
Una vez modificado, súbelo de nuevo al servidor, sobrescribiendo el original.

Paso 3: Configura las constantes de la base de datos

Dentro del archivo wp-config.php, busca las siguientes líneas. Son las primeras que aparecen después de los comentarios iniciales:

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

Ahora, modifica cada línea con los datos que obtuviste en el Paso 1:

DB_NAME: Pega aquí el nombre de tu base de datos.
DB_USER: Pega el nombre de usuario.
DB_PASSWORD: Pega la contraseña exacta.
DB_HOST: Normalmente es localhost, pero si tu hosting usa un servidor remoto, te lo habrán indicado. Si no estás seguro, déjalo como localhost.

[TIP]: Si después de cambiar todo sigues teniendo problemas, prueba a cambiar DB_HOST de localhost a 127.0.0.1 o a la IP que te haya proporcionado tu proveedor de hosting.

Paso 4: Guarda los cambios y prueba

Si estás usando el administrador de archivos, haz clic en Guardar o Save.
Si usaste FTP, sube el archivo modificado y sobrescribe el original.
Ahora, abre tu navegador y visita tu sitio web. Si todo está correcto, WordPress cargará sin problemas.

Si ves el mismo error, no te desesperes. Revisa los siguientes puntos:

¿Escribiste bien la contraseña? A veces copiamos un espacio sin querer.
¿El usuario tiene permisos? En Syspanel, al crear la base de datos, el usuario se vincula automáticamente. Si lo creaste manualmente, asegúrate de que el usuario tenga todos los privilegios sobre la base de datos.
¿El servidor de base de datos es correcto? Pregunta a tu hosting si usan un servidor remoto.

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

Si no encuentras el archivo, es posible que aún no se haya generado. Esto ocurre si nunca has instalado WordPress o si la instalación se quedó a medias.

Para solucionarlo, puedes hacer lo siguiente:

Descarga la última versión de WordPress desde wordpress.org.
Descomprime el archivo en tu ordenador.
Busca el archivo llamado wp-config-sample.php.
Cámbiale el nombre a wp-config.php.
Ábrelo y sigue los pasos del Paso 3 para rellenar los datos de tu base de datos.
Sube este archivo a la raíz de tu sitio web (donde están las carpetas wp-admin, wp-content, etc.).

Consejos adicionales para evitar problemas futuros

Haz una copia de seguridad: Antes de modificar cualquier archivo de configuración, descarga una copia del original. Si algo sale mal, siempre puedes restaurarlo.
No uses espacios en los nombres: Al crear la base de datos y el usuario, evita espacios y caracteres especiales (como ñ o tildes). Usa solo letras, números y guiones bajos.
Contraseñas seguras: La contraseña de la base de datos debe ser robusta. En Syspanel, las contraseñas generadas automáticamente suelen ser muy seguras. No las cambies a algo fácil de adivinar.

FAQ WordPress: Preguntas frecuentes sobre la conexión a la base de datos

Aquí tienes las dudas más comunes que resuelvo a diario en soporte técnico.

1. ¿Por qué aparece "Error al establecer conexión con la base de datos"?

Es el error más común. Las causas principales son:

Datos incorrectos en wp-config.php (nombre, usuario o contraseña).
El servidor de la base de datos está caído o sobrecargado.
El usuario de la base de datos no tiene permisos suficientes.
El archivo wp-config.php está dañado o tiene caracteres extraños.

2. ¿Qué significa "localhost" en la configuración?

"localhost" es la dirección de tu propio servidor. Cuando WordPress y la base de datos están en la misma máquina, se usa localhost. Si tu base de datos está en un servidor diferente (por ejemplo, en un servicio externo como Amazon RDS), te darán una dirección IP o un nombre de host específico.

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

Sí, en el mismo wp-config.php hay una línea que dice:

$table_prefix = 'wp_';

Puedes cambiar wp_ por cualquier otro valor (por ejemplo, miweb_). Esto ayuda a mejorar la seguridad, ya que los atacantes suelen asumir que el prefijo es wp_. Haz este cambio antes de instalar WordPress, porque si lo haces después, tendrás que modificar todas las tablas manualmente.

4. Mi sitio funciona, pero de repente da error de conexión. ¿Qué hago?

Esto suele ser un problema temporal del servidor. Prueba a:

Esperar unos minutos y recargar la página.
Contactar con tu proveedor de hosting para preguntar si hay una caída del servicio.
Revisar el archivo wp-config.php para asegurarte de que no se ha modificado accidentalmente.

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

Puedes usar herramientas como phpMyAdmin (accesible desde Syspanel) para conectarte directamente a la base de datos. Si puedes ver las tablas y los datos, la base de datos está bien. El problema está en la configuración de WordPress.

6. Después de cambiar la contraseña de la base de datos en Syspanel, ¿qué más debo hacer?

Debes actualizar el archivo wp-config.php con la nueva contraseña. Si no lo haces, WordPress seguirá intentando usar la contraseña antigua y dará error. Es un paso que mucha gente olvida.

Resumen final

Configurar la conexión base de datos en WordPress no es complicado. Solo necesitas:

Tener los datos correctos de tu base de datos (nombre, usuario, contraseña y servidor).
Localizar y editar el archivo wp-config.php.
Sustituir los valores predeterminados por los tuyos.
Guardar y probar.

Si usas Syspanel (HestiaCP, puerto 2106), la creación y gestión de bases de datos es muy visual y rápida. No dudes en usar el administrador de archivos para editar el wp-config.php sin necesidad de programas externos.

Recuerda que este archivo es el alma de tu instalación. Trátalo con cuidado y siempre ten una copia de seguridad. Si sigues estos pasos, tu sitio web estará funcionando en pocos minutos.

¿Tienes más dudas? Déjalas en los comentarios o consulta nuestra sección de FAQ WordPress para más soluciones rápidas. ¡Buena suerte con tu sitio!