Conectar WordPress a MySQL: Editar wp-config.php (Guía 2025)

Conectar WordPress a una base de datos MySQL es el paso fundamental para que tu sitio web funcione. Sin una conexión correcta, WordPress no puede guardar tus entradas, páginas, usuarios o comentarios. Si alguna vez has visto el temido mensaje "Error al establecer una conexión con la base de datos", sabes exactamente de lo que hablamos.

Este proceso se realiza editando un archivo clave llamado wp-config.php. Aunque suene técnico, es más sencillo de lo que parece. En esta guía te explicaré, paso a paso y sin tecnicismos innecesarios, cómo configurar este archivo, qué datos necesitas, cómo solucionar los errores más comunes y cómo cambiar tu base de datos si es necesario. Al final, serás capaz de hacerlo por ti mismo, como todo un profesional.

¿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 tu WordPress. Es un archivo de texto plano que se encuentra en la raíz de tu instalación (normalmente en la carpeta public_html o www). Este archivo contiene información esencial para que WordPress se comunique con tu servidor.

Piensa en él como la llave que abre la puerta de tu almacén de datos. Sin esta llave (o con una llave equivocada), WordPress no puede acceder a tu contenido. En este archivo se definen, entre otras cosas:

El nombre de tu base de datos.
El usuario de la base de datos.
La contraseña de ese usuario.
El servidor de la base de datos (normalmente localhost).
Las claves de seguridad (salts) que cifran la información.

Conectar WordPress a MySQL es posible gracias a estos cuatro datos principales. Si alguno de ellos es incorrecto, tu web fallará.

Requisitos previos antes de empezar

Antes de lanzarnos a editar archivos, necesitas tener a mano la información de tu base de datos. Si no la tienes, no podrás completar la configuración.

1. Datos de acceso a tu panel de control (cPanel, Syspanel, etc.)

Para crear o encontrar tu base de datos, necesitas acceder a tu panel de control de hosting. Normalmente, tienes uno. Si tu hosting usa Syspanel (recuerda que el puerto de acceso es el 2106, por ejemplo https://tu-dominio.com:2106), inicia sesión con tus credenciales.

2. Identifica o crea tu base de datos MySQL

Dentro de tu panel, busca la sección de "Bases de Datos MySQL". Aquí podrás:

Crear una nueva base de datos: Dale un nombre descriptivo. A menudo, el sistema añade un prefijo (ej. tuusuario_).
Crear un usuario: Necesitarás un usuario con una contraseña segura.
Asignar privilegios: Asegúrate de darle a ese usuario todos los privilegios sobre la base de datos. Si no, WordPress no podrá crear tablas.

[WARNING] IMPORTANTE: Anota estos datos en un lugar seguro. Los necesitarás en el siguiente paso. No los compartas con nadie.

Guía paso a paso: cómo editar wp-config.php y conectar WordPress a MySQL

Ahora viene la parte práctica. Vamos a configurar el archivo wp-config.php. Tienes dos métodos principales: usar el instalador de WordPress o editar el archivo manualmente. Te explico ambos.

Método A: Usar el instalador de WordPress (Recomendado para instalaciones nuevas)

Si estás instalando WordPress desde cero, el propio instalador te guiará. Es la forma más fácil y segura.

Sube los archivos de WordPress a tu servidor.
Ve a tu dominio (ej. tudominio.com).
WordPress detectará que no hay un wp-config.php y te mostrará la pantalla de configuración de la base de datos.
Introduce los datos que has anotado:
- Nombre de la base de datos: El que creaste.
- Usuario de la base de datos: El usuario que creaste.
- Contraseña: La contraseña de ese usuario.
- Servidor de la base de datos: Normalmente localhost. Si tu hosting usa un servidor externo, te lo indicarán en el panel.
Haz clic en "Enviar".
Si todo es correcto, WordPress te preguntará si quieres instalar. Si no, te mostrará un error. Continúa con la instalación.

WordPress creará automáticamente el archivo wp-config.php con los datos que le diste. No tendrás que hacer nada más.

Método B: Editar el archivo manualmente (Para sitios ya existentes o solucionar errores)

Si tu sitio ya está creado pero necesitas cambiar la base de datos de WordPress o solucionar un error de conexión, tendrás que editar el archivo a mano. No te preocupes, es un proceso muy seguro si sigues estos pasos.

Paso 1: Localiza el archivo wp-config.php

Accede a tu hosting a través de un Administrador de Archivos (en cPanel o Syspanel) o mediante un cliente FTP como FileZilla. Navega hasta la carpeta raíz de tu instalación de WordPress (normalmente public_html). Busca el archivo wp-config.php.

[TIP] Si no lo ves, activa la opción de "Mostrar archivos ocultos" en tu administrador de archivos.

Paso 2: Haz una copia de seguridad (¡Crítico!)

Antes de tocar nada, descarga una copia de seguridad del archivo original a tu ordenador. Así, si algo sale mal, puedes restaurarlo fácilmente. Este es el paso más importante para evitar desastres.

Paso 3: Abre el archivo con un editor de texto

Haz clic derecho sobre el archivo y selecciona "Editar" o "Edit". Se abrirá un editor de texto en tu navegador. Nunca uses un procesador de texto como Word, ya que puede añadir caracteres extraños.

Paso 4: Encuentra las líneas de conexión a la base de datos

Busca las siguientes líneas en el archivo. Suelen estar al principio:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'nombre_base_de_datos' );

/** MySQL database username */
define( 'DB_USER', 'usuario_base_de_datos' );

/** MySQL database password */
define( 'DB_PASSWORD', 'contraseña_base_de_datos' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

Paso 5: Modifica los datos

Ahora, reemplaza los valores entre comillas simples con los datos correctos de tu nueva base de datos.

DB_NAME: Pon el nombre exacto de tu base de datos.
DB_USER: Pon el nombre exacto de tu usuario.
DB_PASSWORD: Pon la contraseña exacta de ese usuario.
DB_HOST: Normalmente es localhost, pero algunos hosts usan una URL como mysql.tudominio.com. Consulta la documentación de tu hosting si no estás seguro.

Paso 6: Guarda los cambios

Una vez hayas modificado los datos, guarda el archivo. Asegúrate de que el editor lo guarda con la codificación UTF-8 (sin BOM) para evitar problemas.

Paso 7: Sube el archivo de vuelta (si usas FTP)

Si editaste el archivo en tu ordenador con un editor como Notepad++, súbelo de nuevo al servidor, sobrescribiendo el antiguo.

¡Ya has configurado la conexión! Ahora, recarga tu sitio web. Debería funcionar correctamente.

Solución de problemas: El error "Error al establecer una conexión con la base de datos"

Este es uno de los errores más comunes y frustrantes. Pero no te preocupes, en el 90% de los casos se resuelve fácilmente. Vamos a diagnosticarlo.

¿Por qué ocurre este error?

Datos incorrectos en wp-config.php: Es la causa más común. Verifica que el nombre de usuario, contraseña y nombre de la base de datos sean exactamente los que creaste.
El servidor de la base de datos está caído: A veces, el problema no eres tú, sino tu proveedor de hosting. Revisa si otros sitios en el mismo servidor también están caídos.
El usuario no tiene permisos: Asegúrate de que el usuario tiene todos los privilegios sobre la base de datos. Ve a tu panel de control y verifica los permisos.
El prefijo de la tabla es incorrecto: Si estás importando una web desde otro hosting, el prefijo de las tablas (ej. wp_) debe coincidir. Revisa la línea $table_prefix = 'wp_'; en tu archivo.

Pasos para diagnosticar y solucionar el error

Revisa la ortografía: Comprueba que no haya espacios o caracteres extraños en los nombres de la base de datos, usuario o contraseña.
Verifica el DB_HOST: Si tu hosting usa un servidor de base de datos externo, localhost no funcionará. Consulta la documentación de tu proveedor.
Comprueba los permisos del usuario: Entra en tu panel de control, ve a "Bases de Datos MySQL" y asegúrate de que tu usuario tiene TODOS los privilegios sobre la base de datos.
Prueba con otro usuario: Si tienes dudas, crea un nuevo usuario y asígnale todos los privilegios sobre la base de datos. Actualiza el wp-config.php con estos nuevos datos.

[TIP] Si el error persiste, contacta con el soporte de tu hosting. Ellos pueden verificar si el servidor de bases de datos está funcionando correctamente.

Cómo cambiar la base de datos de WordPress (Migración o cambio de hosting)

¿Necesitas cambiar la base de datos de WordPress? Ya sea porque te mudas de hosting o porque quieres empezar desde cero, el proceso es el mismo que hemos visto en el Método B.

Crea una nueva base de datos en tu nuevo hosting (o en el mismo).
Exporta tu base de datos antigua desde el panel de control de tu hosting antiguo (normalmente con phpMyAdmin).
Importa esa base de datos a tu nueva base de datos (usando phpMyAdmin en el nuevo hosting).
Edita el wp-config.php de tu instalación de WordPress con los datos de la nueva base de datos.

Este proceso es idéntico al que ya hemos descrito. Solo tienes que asegurarte de que los datos en el archivo apunten a la nueva ubicación.

Preguntas frecuentes (FAQ) sobre la conexión de WordPress y MySQL

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

Asegúrate de que estás en la carpeta raíz de tu instalación. Activa la opción de "Mostrar archivos ocultos" en tu administrador de archivos o cliente FTP.

¿Puedo usar el mismo wp-config.php para dos instalaciones de WordPress en el mismo hosting?

No, no es recomendable. Cada instalación de WordPress debe tener su propia base de datos y su propio archivo wp-config.php. Usar el mismo archivo causará conflictos y errores.

¿Qué significa "DB_HOST" en wp-config.php?

Es la dirección del servidor donde se encuentra tu base de datos MySQL. En la mayoría de los hosts compartidos, es localhost. En otros, puede ser una URL como mysql.tudominio.com. Si no estás seguro, consulta la documentación de tu proveedor.

¿Es seguro editar wp-config.php manualmente?

Sí, siempre que sigas las instrucciones y hagas una copia de seguridad antes de empezar. Es un archivo de texto plano y no tiene ningún peligro si lo editas con un editor de texto adecuado.

¿Qué son las claves de seguridad (salts) en wp-config.php?

Son cadenas de texto aleatorias que se utilizan para cifrar las cookies y contraseñas de tu sitio. No afectan a la conexión con la base de datos, pero es recomendable tenerlas configuradas. Si ves una sección con define('AUTH_KEY', ...), etc., déjala como está o genéralas nuevas desde el generador oficial de WordPress.

Mi web funciona, pero quiero cambiar la contraseña de la base de datos. ¿Qué hago?

Cambia la contraseña del usuario en tu panel de control (cPanel o Syspanel).
Inmediatamente después, edita tu wp-config.php y actualiza la contraseña en la línea define('DB_PASSWORD', 'nueva_contraseña');.
Guarda el archivo.

Si no actualizas el archivo, tu web dejará de funcionar.

Conclusión: Domina tu WordPress

Conectar WordPress a MySQL es una habilidad fundamental para cualquier persona que gestione un sitio web. Aunque pueda parecer intimidante al principio, con esta guía tienes todo lo necesario para hacerlo con confianza. Recuerda: la clave está en tener los datos correctos, editar el archivo con cuidado y siempre hacer una copia de seguridad antes de modificar nada.

Ya no tendrás que entrar en pánico cuando veas un error de conexión. Ahora sabes exactamente qué hacer: revisar tu wp-config.php, verificar los datos y, si es necesario, cambiarlos. Con un poco de práctica, este proceso se convertirá en algo rutinario y rápido.

Si te ha quedado alguna duda, no dudes en consultar la documentación de tu hosting o buscar ayuda en los foros de WordPress. ¡Buena suerte con tu sitio web!