Configurar conexión de base de datos en WordPress | Tutorial fácil

¿Qué es la conexión a la base de datos en WordPress y por qué es crucial?

Cuando instalas WordPress por primera vez, uno de los pasos más importantes (y a veces más intimidantes) es configurar la conexión con la base de datos. Sin esta conexión, WordPress simplemente no puede funcionar. La base de datos es el cerebro de tu sitio: allí se almacenan todas tus entradas, páginas, comentarios, configuraciones de plugins, usuarios y mucho más.

Piénsalo así: cada vez que alguien visita tu web, WordPress consulta la base de datos para mostrar el contenido correcto. Si la conexión falla, verás el temido mensaje "Error al establecer una conexión con la base de datos". Por eso, entender cómo se configura esta conexión es fundamental para cualquier persona que administre un sitio en WordPress.

En este artículo, te guiaré paso a paso para que configures correctamente la conexión a tu base de datos modificando el archivo wp-config.php. No necesitas ser un experto en programación; solo sigue las instrucciones con calma.

¿Qué es el archivo wp-config.php?

El archivo wp-config.php es el corazón de la configuración de WordPress. Se encuentra en la raíz de tu instalación (normalmente en la carpeta public_html o www) y contiene información sensible como:

El nombre de tu base de datos.
El usuario y la contraseña de acceso.
El servidor de la base de datos (normalmente localhost).
Prefijo de las tablas (por defecto wp_).
Claves de seguridad y otras configuraciones avanzadas.

Sin este archivo, WordPress no sabe dónde buscar tus datos. Por eso, si alguna vez mueves tu sitio de servidor o cambias los datos de acceso, tendrás que modificar este archivo.

[WARNING] Nunca compartas tu archivo wp-config.php con nadie. Contiene credenciales que podrían comprometer la seguridad de tu sitio.

Requisitos previos antes de empezar

Antes de lanzarte a modificar el archivo, asegúrate de tener a mano la siguiente información:

Nombre de la base de datos: Por ejemplo, midominio_wp.
Usuario de la base de datos: Por ejemplo, midominio_user.
Contraseña del usuario: La contraseña que asignaste al crear el usuario.
Servidor de la base de datos: Normalmente es localhost, pero algunos hosting usan direcciones como mysql.tudominio.com.
Acceso a tu panel de control: Como cPanel, Syspanel (HestiaCP) o similar.
Un editor de texto: Puedes usar el bloc de notas, pero recomiendo Notepad++ o VS Code para evitar errores de formato.

Si usas Syspanel (la herramienta de administración basada en HestiaCP), recuerda que el puerto de acceso es el 2106. Por ejemplo: https://tudominio.com:2106.

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

El archivo wp-config.php suele estar en la carpeta raíz de tu instalación de WordPress. Para acceder a él, necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de control.

Desde Syspanel (HestiaCP):

Accede a Syspanel a través de https://tudominio.com:2106.
Inicia sesión con tus credenciales de administrador.
Ve a Archivos > Administrador de archivos.
Navega hasta la carpeta public_html (o la carpeta donde tengas instalado WordPress).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de tener activada la opción "Mostrar archivos ocultos".

Desde cPanel:

Ingresa a cPanel.
Busca la sección Archivos y haz clic en Administrador de archivos.
Ve a public_html.
Localiza wp-config.php.

Una vez localizado, descarga una copia de seguridad a tu computadora antes de modificarlo. Esto te salvará si algo sale mal.

Paso 2: Crear la base de datos y el usuario (si no los tienes)

Si todavía no has creado la base de datos, este es el momento. En Syspanel, el proceso es muy sencillo:

En Syspanel, ve a Bases de datos.
Haz clic en Agregar base de datos.
Completa:
- Nombre de la base de datos: Por ejemplo, midominio_wp.
- Usuario: Por ejemplo, midominio_user.
- Contraseña: Elige una segura (mínimo 12 caracteres, con mayúsculas, números y símbolos).
Haz clic en Crear.

[TIP] Anota el nombre, usuario y contraseña en un lugar seguro. Los necesitarás en el siguiente paso.

Paso 3: Editar el archivo wp-config.php

Ahora viene la parte clave. Abre el archivo wp-config.php con tu editor de texto. Verás algo similar a esto (no te asustes por el código):

<?php
/**
 * Configuración básica de WordPress.
 */
define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

// ... más configuraciones ...

Lo que debes modificar:

DB_NAME: Reemplaza 'nombre_base_datos' con el nombre que creaste (ej. 'midominio_wp').
DB_USER: Reemplaza 'usuario_base_datos' con el usuario que creaste (ej. 'midominio_user').
DB_PASSWORD: Reemplaza 'contraseña' con la contraseña que elegiste.
DB_HOST: Normalmente es 'localhost'. Si tu hosting te proporciona otro valor (como 'mysql.tudominio.com'), cámbialo.

[INFO] Algunos servidores usan un socket en lugar de localhost. Si tu hosting te indica un valor diferente, úsalo. Consulta con tu proveedor si tienes dudas.

Ejemplo de configuración correcta:

define('DB_NAME', 'midominio_wp');
define('DB_USER', 'midominio_user');
define('DB_PASSWORD', 'MiContraseñaSegura123!');
define('DB_HOST', 'localhost');

Paso 4: Guardar y subir el archivo

Una vez que hayas hecho los cambios, guarda el archivo. Si lo editaste localmente, súbelo de nuevo al servidor usando FTP o el administrador de archivos.

Importante: Asegúrate de que el archivo se sobrescriba correctamente. Si usas FileZilla, arrastra el archivo a la carpeta public_html y confirma la sobrescritura.

Paso 5: Probar la conexión

Ahora, visita tu sitio web. Si todo está bien, verás la página de inicio de WordPress (o el instalador si es una instalación nueva). Si ves el error "Error al establecer una conexión con la base de datos", revisa los pasos anteriores:

¿El nombre de la base de datos es correcto?
¿El usuario tiene permisos para acceder a esa base de datos?
¿La contraseña está bien escrita (sin espacios extras)?
¿El servidor de base de datos es el correcto?

[WARNING] Si después de verificar todo sigue fallando, contacta a tu proveedor de hosting. Puede que el servidor de base de datos tenga un nombre diferente o que haya un bloqueo de firewall.

Configuración avanzada: Prefijo de tablas y claves de seguridad

Además de los datos básicos, en el wp-config.php puedes modificar otras configuraciones útiles:

Cambiar el prefijo de las tablas

Por defecto, las tablas de WordPress se llaman wp_, pero por seguridad puedes cambiarlo. Busca esta línea:

$table_prefix = 'wp_';

Cámbialo a algo como miprefijo_ (solo letras y números, sin espacios). Haz esto solo si estás instalando WordPress desde cero, no en un sitio ya funcionando.

Añadir claves de seguridad

Las claves de seguridad (salts) protegen las cookies y sesiones de tu sitio. En el archivo wp-config.php, verás líneas como:

define('AUTH_KEY',         'pon tu frase única aquí');
define('SECURE_AUTH_KEY',  'pon tu frase única aquí');

Puedes generar claves aleatorias en https://api.wordpress.org/secret-key/1.1/salt/. Copia y pega todo el bloque generado reemplazando las líneas existentes.

[TIP] Cambiar las claves de seguridad cada cierto tiempo mejora la seguridad de tu sitio. No afecta el contenido, solo las sesiones activas (los usuarios tendrán que volver a iniciar sesión).

Problemas comunes y soluciones (FAQ)

1. Veo el error "Error al establecer una conexión con la base de datos"

Causas posibles:

Credenciales incorrectas en wp-config.php.
El usuario no tiene permisos sobre la base de datos.
El servidor de base de datos está caído o bloqueado.

Solución: Revisa los pasos 3 y 4. Si usas Syspanel, verifica en Bases de datos que los permisos estén asignados.

2. "No se puede seleccionar la base de datos"

Causa: El nombre de la base de datos en wp-config.php no coincide con el real.

Solución: Ve a Syspanel, copia exactamente el nombre de la base de datos (incluyendo mayúsculas y guiones bajos) y pégalo en DB_NAME.

3. Después de mover mi sitio, la conexión falla

Causa: Los datos de conexión cambiaron al migrar.

Solución: Edita wp-config.php con las nuevas credenciales. Si moviste el sitio a otro servidor, asegúrate de que la base de datos esté importada correctamente.

4. No encuentro el archivo wp-config.php

Causa: Puede que esté oculto o que no se haya creado aún.

Solución: En el administrador de archivos, activa "Mostrar archivos ocultos". Si no aparece, puedes crearlo desde cero (WordPress incluye un archivo de muestra llamado wp-config-sample.php). Simplemente renómbralo a wp-config.php y edítalo.

5. ¿Puedo usar la misma base de datos para varios sitios WordPress?

Sí, pero no es recomendable porque los nombres de las tablas pueden chocar. Si lo haces, asegúrate de cambiar el prefijo de tablas en cada instalación (ej. sitio1_, sitio2_). En Syspanel, puedes crear bases de datos separadas para cada sitio.

Conclusión

Configurar la conexión de la base de datos en WordPress no tiene por qué ser un dolor de cabeza. Con solo modificar unas pocas líneas en el archivo wp-config.php, puedes tener tu sitio funcionando en minutos. Recuerda siempre:

Haz una copia de seguridad antes de editar.
Usa contraseñas seguras.
Verifica que los permisos del usuario sean correctos.
Si usas Syspanel, el acceso es por el puerto 2106.

Si sigues estos pasos, tu sitio estará listo para recibir visitas. Y si algo sale mal, no entres en pánico: la mayoría de los problemas de conexión se solucionan revisando los datos una vez más.

¿Te ha quedado alguna duda? Déjala en los comentarios y con gusto te ayudaré. ¡Buena suerte con tu WordPress!