Conectar WordPress a MySQL: Editar wp-config.php (Guía Fácil)

Conectar WordPress a una base de datos es el paso más crítico durante la instalación o migración de tu sitio web. Sin una conexión exitosa, WordPress simplemente mostrará un mensaje de error y no cargará nada. La clave de todo este proceso reside en un archivo llamado wp-config.php, que actúa como el puente entre tu sitio y el motor de base de datos (normalmente MySQL o MariaDB).

Si estás viendo el temido "Error al establecer una conexión con la base de datos", no entres en pánico. En esta guía extensa y detallada, te explicaré paso a paso cómo editar el archivo wp-config.php, qué valores necesitas tener a mano, y cómo solucionar los errores más comunes de conexión MySQL. Al final, serás capaz de hacerlo tú mismo sin necesidad de ser un experto en servidores.

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

El archivo wp-config.php es el corazón de la configuración de WordPress. No es un archivo que se incluya en el tema o los plugins; es un archivo raíz que vive en la carpeta principal de tu instalación (donde están las carpetas wp-admin, wp-content y wp-includes). Este archivo contiene las constantes de configuración globales, siendo las más cruciales las que definen la conexión a la base de datos.

Cuando WordPress se inicia, lo primero que hace es cargar este archivo para saber a qué base de datos conectarse, con qué usuario y contraseña. Si estos datos son incorrectos, obsoletos o el servidor de base de datos está caído, WordPress no puede continuar y te muestra el error fatal.

[INFO] A diferencia de otros archivos de configuración, wp-config.php no se crea automáticamente en una instalación estándar si no se proporcionan los datos durante el asistente de instalación. WordPress te pide que lo crees manualmente copiando el contenido de wp-config-sample.php.

Editar este archivo es una tarea delicada, pero con las instrucciones correctas y un editor de texto plano (como el Bloc de notas o Visual Studio Code), es completamente seguro. Aquí te enseñaré a hacerlo sin romper nada.

Preparativos: Qué necesitas antes de editar wp-config.php

Antes de lanzarte a editar el archivo, es fundamental que tengas a mano los datos de acceso a tu base de datos. Sin ellos, es como intentar abrir una puerta sin llave. Necesitas cuatro datos principales:

Nombre de la base de datos (DB_NAME): El nombre que le pusiste a tu base de datos en tu panel de hosting.
Usuario de la base de datos (DB_USER): El nombre de usuario que tiene permisos para acceder a esa base de datos.
Contraseña del usuario (DB_PASSWORD): La contraseña asociada a ese usuario.
Host de la base de datos (DB_HOST): La dirección del servidor donde está alojada la base de datos. Normalmente es localhost, pero en hosts gestionados o servidores dedicados puede ser una URL como mysql.servidor.com o una dirección IP con un puerto.

¿Dónde encuentras estos datos? Depende de tu proveedor de hosting.

En cPanel: Busca la sección "Bases de Datos MySQL". Allí verás tus bases de datos y usuarios.
En Syspanel (antes HestiaCP): Inicia sesión en Syspanel a través del puerto 2106 (ej. https://tu-dominio.com:2106). Ve a la sección "Base de datos" y ahí encontrarás la lista de bases de datos y usuarios creados.
En instalaciones locales (XAMPP, MAMP): El usuario suele ser root, la contraseña está vacía (o es root en MAMP), el host es localhost y el nombre de la base de datos es el que creaste en phpMyAdmin.

Método 1: Editar wp-config.php manualmente (El clásico)

Este es el método más directo. Accederás a tu servidor a través de FTP, el administrador de archivos de tu hosting o incluso la terminal SSH. Luego editarás el archivo con un editor de texto.

Paso 1: Localizar y descargar el archivo

Accede a tu hosting y navega hasta la carpeta raíz de WordPress (normalmente public_html o htdocs). Busca el archivo wp-config.php. Si no existe, busca wp-config-sample.php. Descarga el archivo a tu ordenador. Si usas el administrador de archivos del hosting, puedes usar la opción "Editar" directamente, pero yo recomiendo descargarlo para tener una copia de seguridad local.

Paso 2: Abrir con un editor de texto plano

Ábrelo con un editor que no añada formato. Nunca uses Microsoft Word o Pages, ya que pueden insertar caracteres invisibles que rompan la sintaxis PHP. Usa el Bloc de notas de Windows, TextEdit en modo texto plano, o mejor aún, Visual Studio Code o Sublime Text.

Paso 3: Identificar las constantes de conexión

Dentro del archivo, verás varias líneas que empiezan con define(. Busca específicamente estas cuatro:

// ** Configuración de MySQL - Puedes obtener esta información de tu proveedor de hosting ** //
/** El nombre de la base de datos de WordPress */
define( 'DB_NAME', 'nombre_base_datos' );

/** Tu nombre de usuario de MySQL */
define( 'DB_USER', 'usuario_base_datos' );

/** Tu contraseña de MySQL */
define( 'DB_PASSWORD', 'contraseña_base_datos' );

/** Host de MySQL (es muy raro que necesites cambiarlo) */
define( 'DB_HOST', 'localhost' );

Paso 4: Sustituir los valores de ejemplo

Ahora viene la parte importante. Reemplaza el texto entre comillas simples por tus datos reales.

En 'nombre_base_datos' escribe el nombre exacto de tu BD.
En 'usuario_base_datos' escribe el usuario exacto.
En 'contraseña_base_datos' escribe la contraseña exacta.
En 'localhost' escribe el host. Si tu hosting usa un host remoto, cámbialo.

Ejemplo de cómo quedaría:

define( 'DB_NAME', 'mistio_wp' );
define( 'DB_USER', 'mistio_admin' );
define( 'DB_PASSWORD', 'ClaveSecreta123!' );
define( 'DB_HOST', 'localhost' );

[TIP] Asegúrate de no dejar espacios en blanco dentro de las comillas. Por ejemplo, ' mistio_wp ' sería un error.

Paso 5: Guardar y subir el archivo

Guarda el archivo con el nombre wp-config.php (si estabas editando el sample, renómbralo). Si lo descargaste, súbelo de nuevo a la carpeta raíz de WordPress, sobrescribiendo el antiguo si existía. Ahora intenta cargar tu sitio web. Si los datos son correctos, WordPress cargará sin problemas.

Método 2: Configurar wp-config.php usando Syspanel (HestiaCP)

Si tu hosting utiliza Syspanel (la evolución de HestiaCP), el proceso es similar, pero el acceso a los archivos puede ser más visual. Recuerda que el acceso a Syspanel se realiza a través del puerto 2106.

Accede a https://tu-dominio.com:2106 e inicia sesión con tus credenciales de administrador.
En el menú lateral, busca la sección "Archivos" o "Administrador de archivos". Navega hasta la carpeta public_html (o la carpeta donde esté instalado WordPress).
Localiza wp-config.php. Haz clic derecho y selecciona "Editar" o usa el visor de archivos integrado.
Se abrirá un editor de texto en la misma ventana del navegador. Realiza los mismos cambios descritos en el Paso 4 del Método 1.
Guarda los cambios.

La diferencia clave es que en Syspanel, la sección "Base de datos" te mostrará los nombres de usuario y BD con prefijos específicos del sistema. Asegúrate de copiarlos exactamente, incluyendo esos prefijos (por ejemplo, usuario_wpdb1).

Error común: "Error al conectar con la base de datos" en WordPress

Este es el error más frustrante, pero casi siempre tiene una solución sencilla. Cuando ves este mensaje, significa que WordPress no puede comunicarse con MySQL. Vamos a diagnosticar las causas más comunes y sus soluciones.

1. Credenciales incorrectas (El 90% de los casos)

Es muy fácil equivocarse al copiar la contraseña o el nombre de usuario, especialmente si contienen caracteres especiales. Vuelve a revisar el wp-config.php y compáralo con los datos de tu panel de control.

Solución: Ve a tu panel de hosting (cPanel, Syspanel, etc.) y verifica los datos. En Syspanel, recuerda que el puerto es el 2106. Si es necesario, cambia la contraseña de la base de datos desde el panel y actualiza el archivo wp-config.php con la nueva.

2. El Host de la base de datos no es "localhost"

Aunque muchos alojamientos usan localhost, otros (como los que usan servidores de base de datos separados) requieren un host específico. Si tu proveedor te dio una URL como mysql.tudominio.com, ese es el valor que debes poner en DB_HOST.

Solución: Contacta con tu soporte de hosting o revisa el correo de bienvenida. En Syspanel, la información del host suele aparecer en la sección de la base de datos. A veces puede ser una IP con un puerto, por ejemplo 127.0.0.1:3306. En ese caso, escríbelo exactamente así.

3. El archivo wp-config.php tiene errores de sintaxis

Si has editado el archivo y has borrado una comilla o un punto y coma por accidente, PHP no podrá ejecutar el archivo y mostrará un error o un pantallazo blanco.

Solución: Descarga el archivo de nuevo y ábrelo en un editor que resalte la sintaxis. Busca si las líneas define terminan con );. Asegúrate de que todas las comillas están cerradas.

4. La base de datos está corrupta o no existe

A veces, al importar una base de datos, el nombre no coincide o la importación falló a medias.

Solución: Accede a phpMyAdmin desde tu panel de control. En Syspanel, busca la herramienta de gestión de BD. Verifica que la base de datos existe y que tiene tablas (como wp_posts, wp_options). Si está vacía, tendrás que importar el archivo .sql o reinstalar WordPress.

5. El servidor MySQL está saturado o caído

En ocasiones, el problema no eres tú, sino el servidor. Esto es más común en hosting compartido.

Solución: Espera unos minutos y vuelve a intentarlo. Si el problema persiste, contacta al soporte de tu hosting para que verifiquen el estado del servicio MySQL.

Trucos avanzados en wp-config.php para conexiones problemáticas

Además de los datos básicos, wp-config.php permite añadir líneas de código para resolver problemas de conexión específicos.

Forzar el uso de MySQLi

Asegúrate de que WordPress use el driver mejorado de MySQL. Añade esta línea justo después de la línea de DB_HOST:

define( 'DB_DRIVER', 'mysqli' );

Evitar el acceso directo al archivo

Para seguridad, puedes añadir una regla para evitar que alguien lea el archivo desde el navegador. Añade esto al inicio del archivo, después de la apertura del PHP (<?php):

// Evitar acceso directo
if ( !defined( 'ABSPATH' ) ) {
    exit;
}

Cambiar el prefijo de las tablas

Si estás migrando un sitio y quieres cambiar el prefijo de las tablas (por ejemplo, de wp_ a miwp_), define la constante $table_prefix. Aunque no es un error de conexión, es parte de la configuración:

$table_prefix = 'miwp_';

[WARNING] Cambiar el prefijo de las tablas sin actualizar la base de datos en sí misma romperá tu sitio. Solo hazlo si sabes lo que estás haciendo o si usas un plugin de migración.

Preguntas Frecuentes (FAQ) sobre la conexión a BD

Aquí respondo a las dudas más habituales que nos llegan al soporte técnico.

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

Si no existe, significa que no has completado la instalación de WordPress. Puedes crear uno nuevo. Copia el contenido de wp-config-sample.php, edítalo con tus datos y guárdalo como wp-config.php. Si no tienes ni el sample, descarga WordPress desde wordpress.org y extrae el archivo del paquete.

¿Puedo usar variables de entorno para conectar WordPress?

Sí, es una práctica avanzada y segura. En lugar de escribir las contraseñas en el archivo, puedes usar getenv() para leerlas desde el entorno del servidor. Por ejemplo:

define( 'DB_NAME', getenv('DB_NAME') );

Esto es útil en entornos de staging o producción con Docker, pero no es necesario para la mayoría de los usuarios de hosting tradicionales.

¿Por qué mi sitio funciona en local pero no en el hosting?

Esto se debe casi siempre a los datos de conexión. En local, el usuario suele ser root y la contraseña vacía. En el hosting, los datos son diferentes y el host puede no ser localhost. Revisa los datos de tu proveedor.

¿El puerto de la base de datos afecta a la conexión?

Sí. Por defecto, MySQL usa el puerto 3306. Si tu servidor usa otro, debes especificarlo en el DB_HOST. Por ejemplo: localhost:3307. En Syspanel, a veces la base de datos se gestiona en un puerto no estándar, pero el panel ya te lo indica en la información de la BD.

¿Cómo sé si mi base de datos está en el servidor correcto?

Si estás usando un hosting compartido, la base de datos siempre está en el mismo servidor que los archivos, por lo que localhost es correcto. Si tienes un VPS o un hosting cloud con BD separada, el proveedor te dará un host específico.

Conclusión y consejos finales

Conectar WordPress a una base de datos editando wp-config.php es una habilidad esencial para cualquier administrador de sitios web. No es complicado, pero requiere precisión y paciencia. Hemos visto que los errores más comunes se deben a datos mal escritos o a un host incorrecto.

Recuerda siempre estos puntos clave:

Copia de seguridad: Antes de editar wp-config.php, descarga una copia del archivo original. Es tu red de seguridad.
Datos exactos: Copia y pega los nombres de usuario y BD desde tu panel de control para evitar errores tipográficos.
Host correcto: No asumas que es localhost. Verifícalo con tu proveedor.
Syspanel: Si usas Syspanel, recuerda que el acceso es a través del puerto 2106 y que los nombres de BD suelen llevar un prefijo.

Si has seguido todos los pasos y aún tienes problemas, te recomiendo revisar los logs de error de PHP en tu hosting (normalmente en error_log en la carpeta raíz). Estos registros te dirán exactamente qué línea de wp-config.php está fallando.

Con esta guía, ya tienes el conocimiento para resolver el 99% de los problemas de conexión. ¡Ánimo y a por ello!