Configurar wp-config.php para conectar WordPress a MySQL

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

Si alguna vez has instalado WordPress, seguro que has oído hablar de este archivo. wp-config.php es el archivo de configuración principal de WordPress. Es el "cerebro" que le dice a tu sitio cómo conectarse a la base de datos, qué prefijo usar para las tablas, cómo gestionar la memoria, las claves de seguridad, entre otras cosas.

Sin una configuración correcta de este archivo, WordPress no puede funcionar. De hecho, si intentas instalar WordPress sin una base de datos MySQL correctamente configurada, verás un mensaje de error muy claro: "Error al conectar con la base de datos".

En este artículo, vamos a explicarte paso a paso cómo conectar WordPress a una base de datos MySQL editando el archivo wp-config.php. No necesitas ser un experto en programación; aquí te lo contamos todo de forma sencilla y visual.

¿Qué es MySQL y para qué lo usa WordPress?

Antes de meternos de lleno en el archivo de configuración, es importante que entiendas qué es MySQL.

MySQL es un sistema de gestión de bases de datos relacional. Es decir, es el programa que almacena toda la información de tu sitio web: entradas, páginas, comentarios, usuarios, ajustes, etc.

WordPress no guarda los contenidos en archivos individuales (como hacían las webs antiguas), sino que los organiza en tablas dentro de una base de datos. Cuando visitas una página, WordPress consulta MySQL para obtener el contenido y mostrártelo en tu navegador.

Por tanto, la conexión entre WordPress y MySQL es fundamental. Si esa conexión falla, tu sitio no carga.

¿Qué necesitas antes de empezar?

Para conectar WordPress a MySQL necesitas tener a mano los siguientes datos:

Nombre de la base de datos (por ejemplo: mipagina_wp).
Usuario de la base de datos (por ejemplo: admin_wp).
Contraseña del usuario de la base de datos.
Host de la base de datos (normalmente localhost, aunque a veces puede ser una IP o un dominio como db.mipagina.com).
Puerto (opcional, por defecto es el 3306 para MySQL).

Si estás usando un panel de control como Syspanel (accesible por el puerto 2106), podrás encontrar estos datos fácilmente. En Syspanel, ve a la sección de bases de datos y crea una nueva base de datos y un usuario asociado. El panel te mostrará el nombre de la base, el usuario y te permitirá asignar una contraseña.

Paso a paso: cómo configurar wp-config.php

1. Localiza el archivo wp-config.php

Si ya tienes WordPress instalado, el archivo wp-config.php se encuentra en la carpeta raíz de tu instalación. Por ejemplo:

Si usas cPanel o Syspanel, en la carpeta public_html.
Si lo tienes en un subdirectorio, como public_html/blog, estará ahí.

Si aún no has instalado WordPress, en el paquete de descarga oficial encontrarás un archivo llamado wp-config-sample.php. Ese es un modelo que deberás renombrar a wp-config.php y luego editarlo.

2. Abre el archivo con un editor de texto

Puedes usar el editor de archivos de tu panel de hosting (por ejemplo, en Syspanel, el administrador de archivos) o descargarlo y editarlo con un programa como Notepad++ o Sublime Text.

Importante: No uses el Bloc de notas de Windows para editar archivos con código, ya que puede introducir caracteres extraños. Mejor usa un editor específico.

3. Encuentra las líneas de configuración de la base de datos

Dentro del archivo, busca 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', '' );

Estas líneas son las que definen la conexión. Deberás sustituir los valores entre comillas por los datos reales de tu base de datos.

4. Rellena los datos correctamente

Vamos a ver cada campo:

DB_NAME: Aquí va el nombre exacto de tu base de datos. En Syspanel, suele tener un prefijo con tu usuario, por ejemplo: usuario_wp1.
DB_USER: El usuario de la base de datos. Puede ser el mismo que el de la base o uno específico. En Syspanel, se crea junto con la base.
DB_PASSWORD: La contraseña que asignaste a ese usuario. Ten cuidado con las mayúsculas, minúsculas y caracteres especiales.
DB_HOST: Normalmente es localhost. Pero si tu base de datos está en un servidor distinto al de WordPress, aquí deberás poner la IP o el dominio del servidor de bases de datos. En Syspanel, si todo está en el mismo servidor, usa localhost.
DB_CHARSET: Lo más recomendable es dejarlo como utf8 o utf8mb4. Esto define la codificación de caracteres.
DB_COLLATE: Déjalo vacío (''). WordPress se encarga de asignarlo si es necesario.

5. Guarda el archivo y súbelo si es necesario

Si editaste el archivo localmente, súbelo a tu servidor mediante FTP o el administrador de archivos de Syspanel. Si lo editaste directamente en el panel, simplemente guarda los cambios.

¿Qué pasa si no tienes WordPress instalado todavía?

Si estás en plena instalación, el proceso es ligeramente distinto. En lugar de crear el archivo manualmente, puedes usar el instalador de WordPress.

Descarga WordPress y súbelo a tu servidor.
Abre tu dominio en el navegador.
WordPress te pedirá que selecciones el idioma.
En la pantalla de configuración de la base de datos, introduce los datos que tienes de MySQL.
Si todo es correcto, WordPress creará automáticamente el archivo wp-config.php con los datos que has introducido.

Pero si quieres hacerlo manualmente, el proceso es el mismo que hemos descrito: renombra el archivo de muestra y edítalo.

Errores comunes al conectar WordPress a MySQL

Aunque parezca sencillo, es fácil equivocarse. Estos son los errores más habituales:

Error: "Error al conectar con la base de datos"

Este es el más común. Las causas suelen ser:

Nombre de la base de datos incorrecto: Revisa que no haya espacios ni caracteres raros.
Usuario o contraseña mal escritos: A veces se copian espacios sin querer.
Host incorrecto: Si tu base de datos no está en localhost, este será el problema.

Error: "No se pudo seleccionar la base de datos"

Esto significa que WordPress se conectó al servidor MySQL, pero no encontró la base de datos con ese nombre. Revisa que el nombre esté bien escrito y que la base exista realmente.

Error: "No se encuentra el archivo wp-config.php"

Si ves este mensaje, significa que WordPress no encuentra el archivo de configuración. Asegúrate de que está en la carpeta raíz y que se llama exactamente wp-config.php (sin espacios ni caracteres extraños).

Consejos extra para una configuración segura

Además de conectar correctamente, te recomendamos estos ajustes en wp-config.php:

Claves de seguridad (Salt Keys)

En el mismo archivo encontrarás un bloque llamado Authentication Unique Keys and Salts. Estas claves se usan para encriptar las sesiones y contraseñas de los usuarios. No deberías dejarlas con los valores por defecto.

Puedes generar claves aleatorias en la página oficial de WordPress: https://api.wordpress.org/secret-key/1.1/salt/

Copia el bloque completo y pégalo en tu archivo, sustituyendo al existente.

Prefijo de tablas

Por defecto, las tablas de WordPress usan el prefijo wp_. Para mayor seguridad, puedes cambiarlo a algo como miwp_ o seguro_. En el archivo, busca:

$table_prefix = 'wp_';

Y cámbialo por el prefijo que prefieras. Eso hará más difícil un ataque de inyección SQL.

Deshabilitar la edición de archivos desde el panel

Para evitar que alguien con acceso al panel de administración modifique los archivos del tema o plugins, añade esta línea al final del archivo:

define( 'DISALLOW_FILE_EDIT', true );

¿Cómo saber si la conexión funciona?

Después de configurar wp-config.php, simplemente carga tu sitio en el navegador. Si todo está bien, verás la página de inicio o el instalador de WordPress (si es la primera vez).

Si aparece un error, revisa los datos de nuevo. También puedes comprobar si tu servidor MySQL está activo. En Syspanel, puedes ver el estado de los servicios desde el panel principal.

Preguntas frecuentes (FAQ)

¿Qué hago si olvidé mi contraseña de MySQL?

Puedes cambiarla desde el panel de control de tu hosting. En Syspanel, entra en la sección de bases de datos, selecciona el usuario y cambia la contraseña. Luego actualiza wp-config.php con la nueva.

¿Puedo usar SQLite en lugar de MySQL?

WordPress está diseñado para MySQL (o MariaDB, que es compatible). Aunque existen plugins para usar SQLite, no es recomendado para sitios de producción. MySQL es la opción estándar.

¿Qué es el puerto 3306?

Es el puerto por defecto de MySQL. Si tu servidor usa otro puerto, deberás especificarlo en el campo DB_HOST de la siguiente forma: localhost:3307 (cambiando el número). En la mayoría de los casos, no necesitarás tocarlo.

¿Puedo cambiar la base de datos de WordPress después de instalarlo?

Sí, pero no es recomendable. Tendrías que exportar la base de datos actual, crear una nueva, importar los datos y luego modificar wp-config.php. Es un proceso delicado; mejor hacerlo al principio.

¿Necesito conocimientos de programación para editar wp-config.php?

No. Solo necesitas saber copiar y pegar, y tener cuidado de no borrar nada más. Si te sientes inseguro, haz una copia de seguridad del archivo antes de editarlo.

Conclusión

La conexión entre WordPress y MySQL es el corazón de tu sitio web. El archivo wp-config.php es la llave que une ambos mundos. Aunque parezca técnico, configurarlo es un proceso sencillo si sigues los pasos que te hemos dado.

Recuerda: los datos de conexión (nombre de base, usuario y contraseña) los encuentras en tu panel de hosting. Si usas Syspanel, recuerda que el acceso es a través del puerto 2106 y que la gestión de bases de datos es muy intuitiva.

Ahora ya sabes cómo conectar WordPress a una base de datos MySQL. Si encuentras algún error, revisa los puntos que hemos mencionado y no pierdas la calma. La mayoría de los problemas son simples errores de escritura.

[TIP]: Guarda siempre una copia de tu wp-config.php en un lugar seguro (fuera del servidor). Si algo sale mal, podrás restaurarlo fácilmente.

[WARNING]: No compartas nunca tu archivo wp-config.php con nadie. Contiene las credenciales de tu base de datos y podría comprometer la seguridad de tu sitio.

[INFO]: Si usas un hosting compartido, es muy probable que el host de la base de datos sea localhost. En servidores más avanzados, puede ser un dominio como mysql.tudominio.com. Consulta la documentación de tu proveedor si tienes dudas.