Conectar base de datos en WordPress: Editar wp-config.php

¿Alguna vez te has encontrado con el temido mensaje "Error establishing a database connection" en tu sitio web? No te preocupes, es uno de los problemas más comunes y, por suerte, uno de los más fáciles de solucionar si sabes dónde mirar. La clave está en un pequeño pero poderoso archivo llamado wp-config.php. En esta guía, te voy a explicar paso a paso cómo conectar una base de datos en WordPress modificando este archivo, ya sea que uses cPanel, Plesk o cualquier otro panel de control como Syspanel (el antiguo HestiaCP). Al final, serás capaz de hacerlo tú mismo sin necesidad de ser un experto en programación.

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

El archivo wp-config.php es el corazón de la configuración de WordPress. Es el encargado de decirle a tu sitio web cómo conectarse a la base de datos, qué prefijo usar para las tablas y otras opciones fundamentales. Sin este archivo correctamente configurado, WordPress no puede funcionar.

Piénsalo como la llave que abre la puerta de tu almacén de contenido. Si la llave no encaja o está mal hecha, no podrás entrar. Por eso, entender cómo editarlo es esencial para cualquier persona que administre un sitio en WordPress.

¿Qué necesitas antes de empezar?

Antes de meterte en la configuración, asegúrate de tener a mano los siguientes datos. Te van a hacer falta:

Nombre de la base de datos (database name).
Usuario de la base de datos (database username).
Contraseña del usuario (database password).
Servidor de la base de datos (database host, normalmente es localhost).

Estos datos los obtienes desde el panel de control de tu hosting. No te preocupes, más adelante te explico cómo encontrarlos en cPanel, Plesk o Syspanel.

[TIP] Si no tienes creada una base de datos todavía, primero debes crearla desde tu panel de control. En la mayoría de los paneles, esto se hace desde la sección "Bases de Datos" o "MySQL Databases".

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

El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress, dentro de la carpeta donde tienes alojado tu sitio web. Puedes acceder a él de dos formas:

Opción A: Usando un gestor de archivos (más fácil para principiantes)

Entra a tu panel de control (cPanel, Plesk o Syspanel).
Busca la opción "Administrador de archivos" o "File Manager".
Navega hasta la carpeta donde está instalado WordPress (normalmente es public_html o htdocs).
Busca el archivo llamado wp-config.php. Si no lo ves, puede que esté oculto. Activa la opción "Mostrar archivos ocultos" en la configuración del gestor.
Haz clic derecho sobre el archivo y selecciona "Editar" o "Edit". Se abrirá un editor de texto simple.

Opción B: Usando FTP (si te sientes más cómodo)

Conéctate a tu servidor usando un cliente FTP como FileZilla.
Navega hasta la carpeta raíz de tu sitio.
Descarga el archivo wp-config.php a tu computadora.
Ábrelo con un editor de texto plano como Notepad++ o Sublime Text (nunca uses Word o Pages, porque pueden añadir formato extraño).

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

Una vez que tengas el archivo abierto, busca las siguientes líneas. Son las que contienen los datos de conexión a la base de datos MySQL:

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

Normalmente están al principio del archivo, justo después de los comentarios iniciales. Si no las ves, puede que tu archivo esté vacío o dañado. En ese caso, puedes descargar una copia nueva desde el instalador de WordPress.

[WARNING] Nunca edites otras partes del archivo a menos que sepas exactamente lo que haces. Un error en una línea puede romper tu sitio.

Paso 3: Rellenar los datos correctamente

Ahora viene la parte más importante. Debes reemplazar los valores de ejemplo con los datos reales de tu base de datos.

¿Cómo obtener los datos desde cPanel?

Inicia sesión en tu cPanel.
Busca la sección "Bases de Datos" y haz clic en "MySQL Databases".
Allí verás una lista de las bases de datos existentes. Si no tienes ninguna, créala primero (normalmente se llaman tuusuario_nombrebd).
Anota el nombre exacto de la base de datos, el usuario y la contraseña que usaste al crearla.
El DB_HOST casi siempre es localhost, a menos que tu hosting te indique lo contrario. Algunos proveedores usan direcciones como mysql.tudominio.com.

¿Cómo obtener los datos desde Plesk?

Accede a tu panel Plesk.
Ve a "Sitios web y dominios" y selecciona tu dominio.
Busca la sección "Bases de datos" o "Databases".
Haz clic en el nombre de la base de datos que quieras conectar. Allí verás el nombre, el usuario y la opción de mostrar la contraseña.
El DB_HOST en Plesk suele ser localhost también, pero a veces puede ser 127.0.0.1. Si tienes dudas, consulta con tu soporte técnico.

¿Cómo obtener los datos desde Syspanel (HestiaCP)?

Si tu hosting usa Syspanel (el antiguo HestiaCP), el proceso es igual de sencillo:

Ingresa a tu panel Syspanel (recuerda que el puerto de acceso es el 2106, por ejemplo: https://tudominio.com:2106).
Ve a la sección "Bases de Datos" o "Databases".
Allí verás una lista de tus bases de datos. Cada una tiene un nombre, un usuario y un campo para la contraseña (puedes copiarla o generarla de nuevo).
El DB_HOST en Syspanel casi siempre es localhost. Si no funciona, prueba con 127.0.0.1.

[INFO] Si cambias la contraseña desde el panel, asegúrate de actualizarla también en el archivo wp-config.php, o tu sitio dejará de funcionar.

Paso 4: Guardar los cambios y probar la conexión

Una vez que hayas reemplazado los datos, guarda el archivo. Si lo estabas editando desde el gestor de archivos, solo dale clic en "Guardar cambios". Si lo descargaste por FTP, súbelo de nuevo al servidor, reemplazando el archivo antiguo.

Ahora, abre tu navegador y visita tu sitio web. Si todo está bien, deberías ver tu página funcionando sin errores.

[WARNING] Si ves un error blanco o un mensaje de "Error establishing a database connection", revisa que los datos sean exactamente los mismos que tienes en el panel. Un error común es escribir mal el nombre de la base de datos o confundir mayúsculas y minúsculas.

Solución de problemas comunes (FAQ)

1. "Error establishing a database connection"

Esto significa que WordPress no puede comunicarse con la base de datos. Las causas más comunes son:

Datos incorrectos en wp-config.php.
El servidor de base de datos está caído (poco común, pero puede pasar).
El usuario de la base de datos no tiene permisos suficientes.

Solución: Revisa cada línea del archivo. Asegúrate de que el nombre, usuario y contraseña sean correctos. Si usas cPanel, verifica que el usuario esté asignado a la base de datos (a veces hay que hacer clic en "Add User to Database").

2. "Table prefix" cambiado

Si ves errores relacionados con tablas que no existen, puede que el prefijo de las tablas en tu base de datos no coincida con el que está en wp-config.php. Busca la línea:

$table_prefix = 'wp_';

Asegúrate de que sea el mismo que usaste al instalar WordPress (por defecto es wp_). Si lo cambiaste antes, pon el mismo valor.

3. No encuentro el archivo wp-config.php

A veces, WordPress no lo genera automáticamente durante la instalación. En ese caso, puedes crearlo manualmente. Descarga el archivo wp-config-sample.php desde el paquete oficial de WordPress, renómbralo a wp-config.php y completa los datos. Luego súbelo a la raíz de tu sitio.

4. El puerto de la base de datos no es el estándar

Aunque el DB_HOST suele ser localhost, algunos hosts usan un puerto específico, como localhost:3307. Si tu proveedor te lo indica, escríbelo exactamente como te lo dan, incluyendo los dos puntos y el número de puerto.

Consejos finales para mantener tu conexión segura

No compartas tu archivo wp-config.php. Contiene información sensible como la contraseña de la base de datos. Si alguien lo obtiene, podría acceder a tu sitio.
Usa contraseñas fuertes para el usuario de la base de datos. Evita cosas como "123456" o "admin".
Haz copias de seguridad de tu base de datos regularmente. Así, si algo sale mal, puedes restaurarla sin perder contenido.
Actualiza WordPress y los plugins con frecuencia. Las versiones antiguas pueden tener vulnerabilidades que comprometan tu base de datos.

Conclusión

Conectar una base de datos en WordPress editando el archivo wp-config.php es una tarea sencilla una vez que entiendes los pasos. Ya sea que uses cPanel, Plesk o Syspanel (HestiaCP), el proceso es prácticamente el mismo: obtener los datos correctos, editarlos en el archivo y guardar los cambios. Recuerda que la clave está en la precisión: un error de escritura puede causar dolores de cabeza, pero con esta guía tienes todo lo necesario para hacerlo bien.

Si después de seguir todos los pasos sigues teniendo problemas, no dudes en contactar al soporte técnico de tu hosting. Ellos pueden verificar que la base de datos esté activa y que los datos de conexión sean los correctos. ¡Buena suerte y a seguir construyendo tu sitio web!