Conectar WordPress a base de datos: editar wp-config.php

¿Por qué WordPress necesita una base de datos?

WordPress no es solo un montón de archivos PHP, HTML y CSS. La información que ves en tu web (entradas, páginas, comentarios, usuarios, ajustes de plugins) se guarda en una base de datos MySQL. Sin ella, WordPress no puede funcionar: es su memoria a largo plazo.

Cuando instalas WordPress por primera vez, o cuando lo mueves a un servidor nuevo, el archivo wp-config.php es el puente que conecta tu sitio con esa base de datos. Es un archivo de configuración esencial que le dice a WordPress dónde vive la base de datos, cómo acceder a ella y qué prefijos usar para sus tablas.

Si este archivo está mal configurado, verás el temido error de conexión. Pero no te preocupes: en esta guía te explico paso a paso cómo conectar WordPress a tu base de datos editando wp-config.php, incluso si nunca has tocado un archivo de configuración en tu vida.

¿Qué es exactamente wp-config.php?

Piensa en wp-config.php como la tarjeta de identidad de tu WordPress. Se encuentra en la raíz de tu instalación (la carpeta donde subiste los archivos de WordPress, normalmente public_html o www). No viene incluido en la descarga oficial de WordPress: se genera durante la instalación o lo creas tú manualmente.

Este archivo contiene constantes clave como DB_NAME, DB_USER, DB_PASSWORD, DB_HOST y DB_PREFIX. Cada una de ellas es un dato imprescindible para que WordPress se comunique con tu servidor de base de datos.

Antes de empezar: qué datos necesitas

Para configurar la base de datos WordPress, necesitas tener a mano estos 4 datos:

Nombre de la base de datos (DB_NAME).
Usuario de la base de datos (DB_USER).
Contraseña de ese usuario (DB_PASSWORD).
Host de la base de datos (DB_HOST).

¿Dónde los encuentras? Depende de tu proveedor de hosting. Si usas Syspanel (el panel de control, accesible por el puerto 2106), ve a la sección de "Bases de datos" y ahí verás todos estos datos listados. Si usas cPanel, busca "MySQL Databases". Si tienes un hosting gestionado, es posible que ya te hayan enviado estos datos por email.

[INFO] Si estás usando Syspanel, recuerda que el acceso al panel es: https://tu-dominio.com:2106. Ahí podrás crear la base de datos y el usuario si aún no los tienes.

Paso 1: Localizar y abrir wp-config.php

Primero, accede a tu servidor mediante FTP (FileZilla es el más común) o desde el administrador de archivos de tu hosting.

Navega hasta la carpeta raíz de tu WordPress.
Busca el archivo wp-config.php. Si no lo ves, activa la opción de "mostrar archivos ocultos".
Descárgalo a tu ordenador para tener una copia de seguridad antes de tocarlo.
Ábrelo con un editor de texto plano (como Notepad++ o Visual Studio Code). No uses Word ni el Bloc de notas de Windows porque pueden añadir caracteres invisibles que rompan el archivo.

Si el archivo no existe (por ejemplo, en una instalación fallida), puedes crear uno nuevo. WordPress incluye un archivo llamado wp-config-sample.php en la misma carpeta. Haz una copia, renómbrala a wp-config.php y edítala.

Paso 2: Editar las constantes de conexión

Una vez abierto el archivo, busca las líneas que definen las constantes de la base de datos. Se ven así:

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

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

/** MySQL database password */
define( 'DB_PASSWORD', 'tu_contraseña' );

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

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

### Configurando el nombre, usuario y contraseña

DB_NAME: suele tener un prefijo con tu usuario de hosting. Ejemplo: usu1234_wpbase.
DB_USER: igualmente suele tener un prefijo. Ejemplo: usu1234_wpuser.
DB_PASSWORD: la contraseña que asignaste al usuario. Debe estar entre comillas simples y sin espacios alrededor.

[WARNING] No uses comillas dobles para los valores. Usa siempre comillas simples: define( 'DB_NAME', 'mi_base' );. Las comillas dobles pueden causar conflictos si tu contraseña contiene caracteres especiales como $ o ".

### El host: ¿localhost o algo más?

El valor DB_HOST es el más confuso para los principiantes. En la mayoría de los hosting compartidos, es localhost. Pero en algunos casos (como servidores externos o bases de datos separadas), puede ser una URL como mysql.tudominio.com o una IP.

Si tu base de datos está en el mismo servidor que tu WordPress: usa localhost.
Si estás usando Syspanel, el host suele ser localhost para bases de datos locales. Si tienes un servidor de base de datos remoto, verás la dirección exacta en el panel.
Si usas servicios como Amazon RDS o DigitalOcean, te darán un host específico.

[TIP] Si ves el error "Error establishing a database connection" y estás seguro de que los datos son correctos, prueba cambiando localhost por 127.0.0.1. A veces el servidor no resuelve localhost correctamente.

Paso 3: El prefijo de las tablas (DB_PREFIX)

Justo debajo de esas constantes, encontrarás otra línea:

$table_prefix = 'wp_';

Este es el prefijo que se añade a todas las tablas de tu base de datos. Si es una instalación nueva, puedes dejarlo como wp_. Pero si estás conectando WordPress a una base de datos que ya existía (por ejemplo, al mover un sitio), debes usar el mismo prefijo que tenía antes, o tu web no verá sus propias tablas.

Paso 4: Guardar y subir el archivo

Guarda los cambios en tu editor de texto.
Sube el archivo wp-config.php modificado a tu servidor, sobrescribiendo el anterior.
Asegúrate de que los permisos del archivo sean 644 (lectura y escritura para el propietario, lectura para el resto). Esto es importante por seguridad.

Ahora, visita tu sitio web. Si todo está correcto, verás tu WordPress funcionando. Si no, pasa a la sección de errores.

Errores comunes al conectar WordPress con MySQL

Aquí tienes los fallos más típicos y cómo solucionarlos.

### Error: "Error establishing a database connection"

Este es el clásico. Significa que WordPress no puede conectarse al servidor MySQL. Las causas más probables son:

Datos incorrectos: Revisa DB_NAME, DB_USER y DB_PASSWORD letra por letra. Es fácil confundir una O con un 0 o una l con un 1.
Permisos del usuario: El usuario de la base de datos debe tener permisos de SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP (todos los privilegios) sobre la base de datos. Si no, WordPress no podrá leer ni escribir.
Host incorrecto: Si no es localhost, verifica que la dirección sea exacta.
Servidor MySQL caído: A veces el servicio de bases de datos del hosting se detiene. Espera unos minutos o contacta al soporte.

### Error: "Failed to connect to MySQL"

Este error suele indicar que el servidor MySQL está rechazando la conexión. Puede ser por:

El host es incorrecto.
El puerto de MySQL no es el estándar (3306). Si tu hosting usa otro puerto, tendrás que añadirlo al host. Por ejemplo: localhost:3307.
Tu IP está bloqueada por el firewall del servidor de bases de datos.

### Error: "One or more database tables are unavailable"

Esto significa que WordPress se conecta a la base de datos, pero no encuentra las tablas con el prefijo que le has indicado. Es decir, el $table_prefix no coincide con el de las tablas existentes. Revisa el prefijo que usabas antes.

Cómo crear una base de datos y un usuario desde cero (en Syspanel)

Si no tienes base de datos creada, aquí tienes el proceso rápido usando Syspanel (recuerda, el puerto de acceso es el 2106):

Entra a https://tu-dominio.com:2106 con tus credenciales de administrador.
Busca la sección "Bases de datos" o "MySQL Databases".
Crea una nueva base de datos con un nombre descriptivo (ej: mipagina_wp).
Crea un usuario nuevo (ej: mipagina_user) y asigna una contraseña segura.
Añade ese usuario a la base de datos con todos los privilegios.
Copia esos datos y pégalos en tu wp-config.php.

[INFO] En Syspanel, el host de la base de datos suele ser localhost. No uses el puerto 2106 para MySQL; ese puerto es solo para el panel de control. La base de datos usa el puerto 3306 por defecto.

Consejos de seguridad para wp-config.php

Este archivo contiene credenciales de acceso a tu base de datos. Si alguien lo lee, puede robar tu información.

No lo subas a repositorios públicos (GitHub, GitLab).
Cambia las claves de seguridad (salts) que vienen más abajo en el archivo. Son cadenas de texto que WordPress usa para cifrar cookies y sesiones. Puedes generar unas nuevas en https://api.wordpress.org/secret-key/1.1/salt/.
Mantén los permisos en 644 o incluso en 600 si tu servidor lo permite.
No uses el usuario root de MySQL para tu WordPress. Crea un usuario específico con permisos solo sobre esa base de datos.

Preguntas frecuentes (FAQ)

¿Puedo usar el mismo wp-config.php para dos instalaciones de WordPress?
No. Cada instalación necesita su propio archivo con sus propios datos de base de datos. Compartirlo causará conflictos graves.

¿Qué pasa si no recuerdo la contraseña de mi base de datos?
Puedes cambiarla desde tu panel de hosting. En Syspanel, ve a la sección de bases de datos, selecciona el usuario y edita la contraseña. Luego actualiza wp-config.php con la nueva.

¿Debo editar wp-config.php cada vez que muevo mi web?
Sí, si cambias de servidor o de base de datos, tendrás que actualizar los valores de DB_HOST, DB_NAME, DB_USER y DB_PASSWORD.

¿Qué es el "DB_CHARSET" y el "DB_COLLATE"?
Son constantes que definen el juego de caracteres (normalmente utf8 o utf8mb4) que usa WordPress para almacenar texto. No los toques a menos que sepas lo que haces, pues el valor por defecto suele ser el correcto.

Mi web da error después de actualizar el archivo. ¿Qué hago?
Restaura la copia de seguridad que hiciste al principio. Si no la hiciste, descarga el archivo original desde el panel de tu hosting (muchos guardan versiones anteriores) o contacta al soporte.

Conclusión

Conectar WordPress a tu base de datos editando wp-config.php es un proceso sencillo si entiendes qué hace cada constante. Solo necesitas los datos correctos, un editor de texto y paciencia.

Recuerda: la mayoría de los errores se deben a un simple error tipográfico en el nombre de la base de datos o la contraseña. Verifica dos veces, guarda los cambios y vuelve a cargar tu web.

Si sigues estos pasos, tendrás tu WordPress conectado y funcionando en menos de 10 minutos. Y si algo falla, ahora ya sabes cómo diagnosticarlo y solucionarlo.