Conectar WordPress a MySQL: wp-config.php paso a paso

¿Tu WordPress te muestra el temido "Error establishing a database connection" o "Error al conectar con la base de datos"? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene una solución clara y sencilla.

El corazón de WordPress es su base de datos MySQL. Sin ella, tu web no puede funcionar. El archivo que actúa como puente entre WordPress y esa base de datos es el famoso wp-config.php. En esta guía extensa y fácil de seguir, vamos a explicarte exactamente qué es, cómo editarlo sin romper nada y cómo solucionar los errores de conexión más habituales.

Piensa en este artículo como tu manual de cabecera para entender la conexión entre tu web y su "almacén" de contenido.

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

Imagina que tu WordPress es una tienda y la base de datos MySQL es el almacén donde guardas todos los productos (tus artículos, páginas, comentarios y ajustes). El archivo wp-config.php es el empleado que tiene la llave del almacén y la lista de instrucciones para abrirlo.

Técnicamente, es el archivo de configuración principal de WordPress. Contiene ajustes críticos que controlan cómo tu sitio web se comunica con sus cimientos: la base de datos. Sin este archivo, WordPress no sabe a qué almacén ir, qué llave usar o en qué servidor se encuentra.

Se encuentra en la raíz de tu instalación de WordPress, es decir, en la carpeta principal donde están los archivos de tu web (junto a carpetas como wp-content o wp-admin). No es un archivo que se suba por FTP o se edite a la ligera, pero entenderlo es fundamental para cualquier persona que gestione una web.

Los 4 datos clave para conectar WordPress MySQL

Para que WordPress se conecte a tu base de datos, el archivo wp-config.php necesita cuatro datos muy específicos. Son las credenciales que tu empleado (WordPress) usará para abrir el almacén (MySQL).

Estos son los parámetros que verás en el archivo:

DB_NAME: Es el nombre de la base de datos. Es como la etiqueta del almacén. Si no lo escribes bien, WordPress buscará en un sitio equivocado.
DB_USER: Es el usuario de la base de datos. Es la identificación del empleado. Este usuario tiene permisos específicos para entrar y trabajar en el almacén.
DB_PASSWORD: Es la contraseña de ese usuario. Es la llave que verifica que el empleado es quien dice ser.
DB_HOST: Es la dirección del servidor donde se encuentra MySQL. Normalmente es localhost (el mismo servidor que tu web), pero a veces puede ser una dirección IP o un nombre de servidor externo, como mysql.servidor.com.

¿Dónde encuentro estos datos?
Normalmente, tu proveedor de hosting (la empresa que aloja tu web) te los proporciona en el panel de control. Si usas un panel como Syspanel (recuerda que se accede por el puerto 2106), podrás encontrarlos en la sección de "Bases de Datos" o "MySQL". Allí verás el nombre de la BD, el usuario y podrás crear o ver la contraseña.

Paso a paso: Cómo editar `wp-config.php` para conectar WordPress MySQL

Vamos a lo práctico. Necesitas abrir el archivo wp-config.php para revisar o cambiar los datos. Hay dos métodos principales: desde el panel de control (más seguro) o por FTP (más técnico).

Método 1: Desde el panel de control (Recomendado para principiantes)

Este es el método más seguro porque no necesitas programas externos y evitas errores de codificación.

Accede a tu panel de control (como cPanel o Syspanel en el puerto 2106).
Busca la sección "Administrador de archivos" (File Manager).
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o htdocs).
Busca el archivo wp-config.php y haz clic derecho sobre él. Selecciona "Editar" o "Edit".
Se abrirá un editor de texto. Busca las líneas que empiezan con define('DB_NAME', define('DB_USER', etc.
Modifica los valores entre las comillas simples. Por ejemplo: define('DB_NAME', 'mi_base_de_datos');.
Guarda los cambios (Ctrl+S o el botón de guardar) y cierra el editor.

Método 2: Por FTP (Para usuarios con más experiencia)

Si prefieres usar un cliente FTP como FileZilla:

Conéctate a tu servidor con tus credenciales FTP.
Navega a la raíz de tu instalación de WordPress.
Descarga el archivo wp-config.php a tu ordenador.
Ábrelo con un editor de texto plano como Notepad++ o Sublime Text. No uses el Bloc de notas de Windows, ya que puede introducir caracteres extraños.
Realiza los mismos cambios en las líneas de define.
Guarda el archivo y súbelo de nuevo a tu servidor, sobrescribiendo el archivo antiguo.

[WARNING] Haz una copia de seguridad del archivo wp-config.php antes de editarlo. Si algo sale mal, puedes restaurarlo fácilmente. En el File Manager, puedes copiarlo y renombrarlo como wp-config-backup.php.

Solucionando el temido "Error de conexión a la base de datos"

Este es el error más común y el motivo principal por el que estás leyendo esto. Vamos a desglosar las causas más probables y sus soluciones, paso a paso.

Causa 1: Credenciales Incorrectas (El error más frecuente)

Es la causa más simple y, a la vez, la más común. Es posible que el nombre de usuario o la contraseña estén mal escritos, o que hayan sido cambiados recientemente.

Solución: Vuelve a tu panel de control (Syspanel, cPanel, etc.) y verifica los datos exactos de tu base de datos. Copia y pega el nombre de la BD, el usuario y la contraseña directamente en el wp-config.php. Presta atención a las mayúsculas y minúsculas.

Causa 2: El Host de la Base de Datos es Incorrecto

Muchas veces asumimos que el host es localhost, pero en hosts gestionados o en servidores con configuraciones especiales, puede ser diferente.

Solución: Revisa la documentación de tu proveedor de hosting. A menudo, el host es algo como localhost, pero en otros casos puede ser mysql.tudominio.com o una IP con un puerto específico (ej. localhost:3307). Si usas Syspanel, la información del host suele aparecer en los detalles de la base de datos.

Causa 3: El Usuario no tiene permisos sobre la Base de Datos

A veces, el usuario existe y la contraseña es correcta, pero el usuario no tiene "permiso" para acceder a esa base de datos específica. Esto es como si tu empleado tuviera la llave del almacén, pero su tarjeta de acceso no estuviera activada para esa puerta.

Solución: En tu panel de control, ve a la sección de "Bases de Datos MySQL". Busca la opción de "Añadir usuario a la base de datos" o "Privilegios". Asegúrate de que el usuario que intentas usar esté asociado a la base de datos correcta y tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). A menudo, basta con marcar la casilla "ALL PRIVILEGES".

Causa 4: El Servidor de Base de Datos está Caído

Puede que el problema no sea tuyo, sino del servidor. Ocasionalmente, el servicio de MySQL se detiene o se sobrecarga.

Solución: Revisa el estado de tu servidor en el panel de control. En Syspanel, puedes buscar la sección de "Servicios" o "Estado del servidor" para ver si MySQL está activo. Si está apagado, intenta reiniciarlo. Si no puedes, contacta con tu proveedor de hosting.

Causa 5: Corrupción del Archivo `wp-config.php`

Si el archivo se ha editado mal, se ha subido con errores de codificación o está incompleto, WordPress no podrá leerlo correctamente.

Solución: Reemplaza el archivo con una copia limpia. Puedes descargar un WordPress nuevo desde wordpress.org, extraer el archivo wp-config-sample.php de la carpeta, renombrarlo a wp-config.php y rellenar los datos manualmente. Es la forma más segura de asegurarte de que el formato es correcto.

Más allá de lo básico: Ajustes útiles en `wp-config.php`

El archivo wp-config.php no solo sirve para la conexión. Contiene ajustes que pueden mejorar el rendimiento y la seguridad de tu web.

Añadir prefijo de tabla personalizado

Por defecto, las tablas de WordPress se llaman wp_. Cambiar este prefijo (por ejemplo, a miweb_) puede dificultar los ataques de inyección SQL, ya que los atacantes asumen el prefijo wp_.

Para cambiarlo, busca la línea:

$table_prefix = 'wp_';

Y cámbiala por:

$table_prefix = 'miweb_';

[INFO] CUIDADO: Cambiar el prefijo de tabla no es un cambio trivial. Si ya tienes contenido, tendrás que renombrar todas las tablas de tu base de datos manualmente o usar un plugin. No lo hagas si no sabes lo que estás haciendo, ya que puedes romper tu web.

Activar el modo depuración (WP_DEBUG)

Si estás teniendo problemas y necesitas ver los errores en pantalla, puedes activar el modo depuración. Esto es muy útil para encontrar el origen de un problema.

Añade o modifica estas líneas:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Con esto, los errores se guardarán en un archivo llamado debug.log dentro de la carpeta wp-content. Así no muestras errores a tus visitantes, pero tú puedes verlos.

[WARNING] Desactiva el modo depuración (ponlo en false) cuando hayas terminado. Dejarlo activo en un sitio en producción puede exponer información sensible y ralentizar tu web.

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

Para terminar, resolvemos las dudas más habituales que nos llegan al soporte.

¿Puedo cambiar la contraseña de mi base de datos MySQL?

Sí, puedes hacerlo desde tu panel de control. Sin embargo, deberás actualizar el archivo wp-config.php con la nueva contraseña inmediatamente después. Si no lo haces, tu web se quedará sin conexión.

¿Qué hago si veo el error "Error establishing a database connection" en mi móvil pero no en mi PC?

Esto suele indicar que el problema es temporal o de caché. Prueba a borrar la caché de tu navegador móvil o a usar una red de datos diferente. Si el problema persiste, es más probable que sea un problema del servidor.

¿Es seguro editar el archivo `wp-config.php`?

Es seguro si sigues las instrucciones y haces una copia de seguridad. Es un archivo de texto plano, así que no hay riesgo de "romper" el código si cambias solo los valores. El riesgo está en borrar una línea completa o añadir caracteres extraños.

¿Qué significa el puerto en `DB_HOST`?

El puerto es la "puerta" específica por la que se accede al servicio de MySQL. Normalmente es el 3306. Si tu proveedor usa uno diferente, te lo indicará. En el campo DB_HOST, se escribiría así: localhost:3307.

Conclusión: Tú puedes controlar la conexión

Entender el archivo wp-config.php es un gran paso para convertirte en un administrador de WordPress más competente. Ya no tienes que entrar en pánico cuando veas un error de conexión; ahora sabes exactamente qué revisar: las credenciales, el host y los permisos.

Recuerda que la clave está en la precisión. Un simple espacio extra o una letra mal escrita en la contraseña puede provocar un error. Tómate tu tiempo, verifica los datos dos veces y, sobre todo, haz siempre una copia de seguridad.

Con esta guía, la conexión entre tu WordPress y su base de datos MySQL ya no es un misterio. Es un proceso claro, lógico y solucionable. Si has seguido todos los pasos y aún tienes problemas, no dudes en contactar con el soporte técnico de tu hosting, con esta guía ya tendrás el vocabulario y el conocimiento para explicarles exactamente qué has probado. ¡Buena suerte!

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