Conectar WordPress a MySQL: Editar wp-config.php

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

Si alguna vez has intentado configurar WordPress desde cero, probablemente te hayas encontrado con un archivo llamado wp-config.php. Este archivo es el corazón técnico de tu instalación: actúa como el puente entre WordPress y tu base de datos MySQL. Sin él, WordPress no sabe dónde guardar tus artículos, usuarios o ajustes, y simplemente no puede funcionar.

Piensa en wp-config.php como la llave de tu casa: sin la configuración correcta, no puedes entrar. En este artículo, te explicaré paso a paso cómo conectar WordPress MySQL de forma manual, qué datos necesitas y qué errores comunes debes evitar. No necesitas ser un experto en programación, solo seguir las instrucciones con calma.

¿Qué necesitas antes de empezar?

Antes de tocar un solo archivo, asegúrate de tener a mano estos 4 datos. Son imprescindibles para configurar WordPress correctamente:

Nombre de la base de datos (por ejemplo, mipagina_db).
Usuario de la base de datos (por ejemplo, admin_wp).
Contraseña del usuario (la que elegiste al crear la base de datos).
Servidor de la base de datos (normalmente localhost, pero a veces es una IP como 127.0.0.1 o un dominio como db.mipagina.com).

Si no tienes estos datos, contacta con tu proveedor de hosting o revisa el panel de control de tu servidor. En muchos casos, si usas un panel como Syspanel (recuerda que se accede por el puerto 2106), puedes crear la base de datos y el usuario desde la sección "Bases de datos" sin necesidad de escribir comandos SQL.

[INFO] En la mayoría de instalaciones locales (como XAMPP o Laragon), el servidor de base de datos es localhost y el usuario suele ser root con contraseña vacía o root. Pero en hosting real, esto casi nunca es así.

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

Este es el método que te da control total. Es el más usado cuando instalas WordPress a mano o cuando migras un sitio desde otro servidor.

Paso 1: Localiza el archivo wp-config.php

En tu instalación de WordPress, el archivo wp-config.php se encuentra en la carpeta raíz (la misma donde están las carpetas wp-admin, wp-content y wp-includes).

Puedes acceder a él de dos formas:

Por FTP (con programas como FileZilla).
Por el administrador de archivos de tu panel de hosting (como cPanel o Syspanel).

Si no ves el archivo, es posible que esté oculto. En FileZilla, activa la opción "Forzar mostrar archivos ocultos" (Servidor > Forzar mostrar archivos ocultos). En Syspanel, busca el botón de "Mostrar archivos ocultos" en la esquina superior derecha del administrador de archivos.

Paso 2: Crea una copia de seguridad

Antes de tocar nada, descarga una copia de wp-config.php a tu ordenador. Si algo sale mal, podrás restaurarlo sin perder datos. Este es un paso que muchos omiten y luego lo lamentan.

Paso 3: Abre el archivo con un editor de texto plano

No uses Word ni Pages. Necesitas un editor de texto plano como:

Notepad++ (Windows).
Sublime Text (Windows/Mac/Linux).
Visual Studio Code (recomendado).
El editor interno de Syspanel o cPanel.

Paso 4: Busca la sección de configuración de MySQL

Dentro del archivo, verás un bloque de código similar a este:

// ** Configuración de la base de datos ** //
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', '' );

Paso 5: Sustituye los valores con tus datos reales

Ahora viene lo importante. Cambia cada línea por los datos que recopilaste antes:

DB_NAME: pon el nombre exacto de tu base de datos.
DB_USER: el usuario que tiene permisos sobre esa base.
DB_PASSWORD: la contraseña de ese usuario.
DB_HOST: normalmente localhost, pero si tu hosting usa un servidor externo, pon el que te hayan indicado.

[WARNING] No cambies las líneas de DB_CHARSET ni DB_COLLATE. Déjalas como están (utf8). Cambiarlas puede provocar problemas con caracteres especiales (ñ, tildes, emojis).

Paso 6: Guarda el archivo y súbelo de nuevo

Guarda los cambios en tu editor y sube el archivo por FTP o por el administrador de archivos, reemplazando el original. Asegúrate de que el nombre siga siendo wp-config.php (sin copias ni renombres).

Paso 7: Prueba tu sitio

Abre tu dominio en el navegador. Si todo está bien, verás tu página principal de WordPress. Si no, pasa al apartado de "Errores comunes" más abajo.

Método 2: Usar el instalador de WordPress (si aún no lo has instalado)

Si estás en las primeras fases y WordPress aún no está instalado, el propio instalador te pedirá los datos de la base de datos. Este método crea automáticamente el archivo wp-config.php por ti.

Descarga WordPress desde wordpress.org.
Sube los archivos a tu servidor.
Abre tu dominio en el navegador. Verás la pantalla de instalación.
Elige tu idioma y haz clic en "Continuar".
WordPress te pedirá la información de la base de datos. Introduce los mismos 4 datos que mencionamos antes.
Haz clic en "Enviar". Si los datos son correctos, WordPress creará el wp-config.php automáticamente y podrás continuar con la instalación.

[INFO] Este método es el más seguro para principiantes, ya que evita errores de sintaxis. Pero si ya tienes un WordPress instalado y solo quieres cambiar la base de datos, tendrás que usar el Método 1.

Método 3: Configurar la conexión con Syspanel (panel de hosting)

Si tu hosting utiliza Syspanel (recuerda: el acceso es por el puerto 2106), el proceso es aún más visual. No necesitas tocar el archivo manualmente si el panel tiene un asistente de "Instalación de WordPress" integrado.

Entra en Syspanel usando http://tudominio.com:2106 (o la IP de tu servidor).
Busca la sección "WordPress" o "Instalador de aplicaciones".
Elige el dominio donde quieres instalar WordPress.
El panel te pedirá que crees una base de datos o que uses una existente. Si no tienes una, créala ahí mismo con un clic.
El asistente rellenará automáticamente el wp-config.php y te dará las credenciales de acceso.

[TIP] Aunque Syspanel haga el trabajo por ti, es buena idea que después revises el wp-config.php para saber qué datos se han usado. Te servirá para futuras migraciones o copias de seguridad.

Errores comunes al conectar WordPress a MySQL (y cómo solucionarlos)

Es muy probable que en el primer intento algo falle. No te preocupes, es parte del proceso. Estos son los errores más típicos:

"Error al establecer conexión con la base de datos"

Este es el error más común. Significa que WordPress no puede comunicarse con MySQL. Las causas suelen ser:

Contraseña incorrecta: Revísala letra por letra, incluyendo mayúsculas y caracteres especiales.
Usuario sin permisos: El usuario debe tener privilegios sobre la base de datos. En Syspanel, asegúrate de haber vinculado el usuario a la base de datos.
Servidor de base de datos incorrecto: Si tu hosting usa un servidor remoto (por ejemplo, mysql.tudominio.com), no uses localhost.

"No se pudo seleccionar la base de datos"

Este error aparece cuando el nombre de la base de datos es incorrecto o no existe. Verifica que el nombre esté escrito exactamente igual (es sensible a mayúsculas y minúsculas en algunos servidores).

Pantalla en blanco

Si ves una pantalla completamente blanca, puede ser un error de PHP en el archivo wp-config.php. Revisa que no haya espacios en blanco antes de <?php al inicio del archivo. También verifica que no falten comillas o puntos y comas en las líneas de configuración.

"El servidor no puede procesar la solicitud"

Este error suele estar relacionado con permisos de archivos. El archivo wp-config.php debe tener permisos de lectura (normalmente 644 o 640). No lo pongas a 777, ya que es un riesgo de seguridad.

[WARNING] Nunca dejes el wp-config.php con permisos 777. Cualquier usuario podría leer tus contraseñas. Usa 644 o 600 si tu servidor lo permite.

Consejos de seguridad para tu wp-config.php

Una vez que hayas logrado conectar WordPress MySQL, es crucial proteger ese archivo. Aquí tienes algunas prácticas recomendadas:

No compartas tus credenciales: Ni por correo, ni por chat, ni en capturas de pantalla.
Cambia el prefijo de las tablas: Si aún estás instalando, usa un prefijo como wp_ por defecto, pero si puedes cambiarlo a algo como miwp_, mejor.
Añade claves de seguridad (salts): WordPress incluye líneas con AUTH_KEY, SECURE_AUTH_KEY, etc. Si no las tienes, puedes generarlas en https://api.wordpress.org/secret-key/1.1/salt/. Esto hace tu sitio más resistente a ataques.
Mueve el archivo fuera de la carpeta raíz: WordPress permite colocar wp-config.php un nivel por encima de la carpeta pública. Esto es avanzado, pero es una gran medida de seguridad.

[TIP] Si usas Syspanel, busca la opción de "Proteger archivos sensibles". Algunos paneles ya bloquean el acceso directo a wp-config.php desde el navegador.

Preguntas frecuentes (FAQ)

¿Puedo usar el mismo wp-config.php para varias bases de datos?

No. Cada instalación de WordPress necesita su propio wp-config.php con los datos de su base de datos. Si intentas usar el mismo archivo en dos sitios, uno de ellos fallará.

¿Qué pasa si cambio el nombre de la base de datos después de instalar?

Tendrás que editar el wp-config.php con el nuevo nombre. No hay otra forma. Haz una copia de seguridad de la base de datos antes de cambiarla.

¿Cómo sé si mi servidor usa `localhost` u otro host?

En la mayoría de los hosting compartidos, el host es localhost. Pero si tienes dudas, revisa la documentación de tu proveedor o el correo de bienvenida que te enviaron al contratar. En Syspanel, la información de la base de datos suele aparecer en la sección "Bases de datos" del panel.

¿Puedo editar wp-config.php desde el escritorio de WordPress?

No directamente. WordPress no tiene un editor visual para este archivo. Debes hacerlo por FTP o por el administrador de archivos de tu panel. Algunos plugins de seguridad te permiten editarlo, pero no es recomendable.

¿Qué hago si pierdo la contraseña de la base de datos?

Puedes cambiarla desde el panel de control de tu hosting. En Syspanel, ve a "Bases de datos", selecciona la base y elige "Cambiar contraseña". Después, actualiza el wp-config.php con la nueva contraseña.

Conclusión y resumen

Conectar WordPress a MySQL no es un proceso mágico, pero tampoco es complicado si entiendes qué hace cada campo. El archivo wp-config.php es tu llave maestra para que WordPress y MySQL trabajen juntos.

Resumen rápido de lo que has aprendido:

Necesitas 4 datos: nombre de base, usuario, contraseña y host.
Puedes editar el archivo manualmente o usar un instalador automático.
Los errores más comunes son por datos mal escritos o permisos incorrectos.
Protege tu archivo con claves de seguridad y permisos adecuados.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y que puedes gestionar todo desde su interfaz.

Ahora que ya sabes cómo funciona, te animo a que lo pruebes en un entorno de pruebas (como un WordPress local) antes de hacerlo en tu sitio en producción. Así ganarás confianza sin miedo a romper nada.

[INFO] Si después de seguir todos los pasos sigues teniendo problemas, no dudes en contactar con el soporte de tu hosting. Los técnicos pueden verificar si el servidor MySQL está activo y si los permisos del usuario son correctos. Es su trabajo ayudarte.

Y recuerda: la práctica hace al maestro. Cada vez que migres un sitio o cambies de hosting, este proceso te resultará más natural. ¡Mucho éxito con tu WordPress!