Conectar WordPress a MySQL: Configuración de wp-config.php

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

Si estás leyendo esto, es muy probable que hayas intentado instalar WordPress y te hayas encontrado con un mensaje de error sobre la conexión a la base de datos. No te preocupes, es uno de los pasos más comunes y, afortunadamente, uno de los más fáciles de resolver si sabes qué estás haciendo.

El archivo wp-config.php es el corazón de la configuración de tu WordPress. Es el encargado de decirle a tu sitio web cómo, cuándo y con qué credenciales debe conectarse a tu base de datos MySQL. Sin una configuración correcta en este archivo, WordPress simplemente no puede funcionar, porque necesita almacenar y recuperar toda la información: tus entradas, páginas, comentarios, usuarios y ajustes.

Piénsalo así: tu sitio web es como una tienda. WordPress es el vendedor y la base de datos MySQL es el almacén donde guardas todos tus productos. El archivo wp-config.php es la llave maestra que le da acceso al vendedor al almacén. Si la llave no es la correcta, el vendedor se queda en la puerta y no puede abrir la tienda.

Requisitos previos antes de empezar

Antes de lanzarnos a editar archivos, necesitas tener a mano algunos datos. No podemos adivinarlos, así que tómate un momento para reunirlos.

Necesitarás lo siguiente:

El nombre de tu base de datos: Es el nombre exacto que le pusiste a tu base de datos MySQL.
El nombre de usuario de la base de datos: Con qué usuario te conectas a dicha base de datos.
La contraseña de ese usuario: La contraseña asociada a ese usuario.
El host de la base de datos: La dirección del servidor donde se encuentra tu base de datos. Generalmente es localhost, pero a veces puede ser algo como mysql.tudominio.com o una IP específica.
El prefijo de las tablas: Por defecto es wp_, pero a veces se cambia por seguridad. Si no sabes cuál es, asume wp_.

[INFO]
Si has creado la base de datos desde el panel de control de tu hosting (cPanel, Plesk, Syspanel, etc.), normalmente verás estos datos en la sección de "Bases de Datos MySQL". En Syspanel, por ejemplo, el acceso se realiza a través del puerto 2106, y desde ahí puedes gestionar tus bases de datos y ver las credenciales.

Método 1: Configurar wp-config.php durante la instalación de WordPress

La forma más común de encontrarte con este archivo es durante la instalación. WordPress tiene un instalador web muy amigable que te guía paso a paso.

Los pasos son los siguientes:

Descarga WordPress desde el sitio oficial y súbelo a tu servidor.
Abre tu navegador y visita la URL de tu sitio (por ejemplo, www.tudominio.com).
WordPress detectará que no hay un archivo de configuración y te mostrará la pantalla de bienvenida. Haz clic en "¡Vamos a ello!".
Ahora te pedirá los datos de conexión. Aquí es donde debes tener a mano la información que recopilamos antes.
Rellena los campos:
- Nombre de la base de datos: Escribe el nombre exacto.
- Usuario de la base de datos: Escribe el usuario.
- Contraseña de la base de datos: Escribe la contraseña.
- Servidor de la base de datos: Normalmente localhost. Si tu hosting te ha dado otro, escríbelo.
- Prefijo de la tabla: Déjalo como wp_ a menos que tengas una razón específica para cambiarlo.
Haz clic en "Enviar".
Si todo es correcto, verás un mensaje de éxito. Si no, verás un error de conexión. En ese caso, revisa que los datos sean correctos, especialmente el host.

[WARNING]
Error muy común: "Error al establecer una conexión con la base de datos". Esto casi siempre significa que las credenciales son incorrectas o que el host no es el correcto. Verifica también que la base de datos exista y que el usuario tenga todos los privilegios sobre ella.

Método 2: Configurar wp-config.php manualmente (edición directa)

A veces, no estás instalando WordPress desde cero, sino que ya tienes un sitio y necesitas cambiarlo de servidor o simplemente modificar las credenciales. En ese caso, tendrás que editar el archivo wp-config.php manualmente.

¿Dónde está el archivo? Está en la raíz de tu instalación de WordPress, junto a las carpetas wp-admin, wp-content y wp-includes.

Para editarlo, sigue estos pasos:

Accede a tu servidor: Puedes usar el administrador de archivos de tu panel de hosting (como cPanel o Syspanel) o un cliente FTP como FileZilla.
Descarga el archivo wp-config.php a tu computadora. Es una buena práctica hacer una copia de seguridad antes de editarlo.
Abre el archivo con un editor de texto plano: No uses procesadores de texto como Word. Es mejor usar algo como Notepad++ (en Windows) o TextEdit en modo texto (en Mac). El Bloc de notas de Windows también funciona.
Busca la sección que dice // ** Ajustes de MySQL ** //. Verás un bloque de código con constantes de PHP que empiezan con define.
Modifica las siguientes líneas:

// ** Ajustes de MySQL ** //
/** Nombre de la base de datos de WordPress */
define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );

/** Usuario de la base de datos de WordPress */
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );

/** Contraseña de la base de datos de WordPress */
define( 'DB_PASSWORD', 'tu_contraseña_secreta' );

/** Host de la base de datos */
define( 'DB_HOST', 'localhost' );

Reemplaza los valores de ejemplo con los datos reales de tu base de datos. Presta mucha atención a las comillas simples: no las borres, solo cambia el texto que está dentro.
Guarda el archivo y súbelo de vuelta a tu servidor, sobrescribiendo el archivo original.

[TIP]
Si tu base de datos está en un servidor diferente al de tu web (algo común en alojamientos gestionados), el DB_HOST no será localhost. Tu proveedor de hosting te dará una dirección específica, que suele tener el formato mysql.tudominio.com o localhost:3306.

Entendiendo las constantes de configuración clave

Para que no te pierdas, vamos a explicar cada parte del código que acabas de editar.

DB_NAME: Es el nombre de tu base de datos. Es único en tu servidor de hosting.
DB_USER: Es el nombre de usuario que se utiliza para conectarse a la base de datos. Este usuario debe tener permisos para leer, escribir, modificar y eliminar datos en la base de datos que especificaste en DB_NAME.
DB_PASSWORD: La contraseña asociada al usuario DB_USER. Debe ser exacta, incluyendo mayúsculas, minúsculas y símbolos.
DB_HOST: Es la dirección del servidor donde se ejecuta el motor de base de datos MySQL. Como ya hemos dicho, lo más habitual es localhost, que significa que la base de datos está en el mismo servidor que tu sitio web. Si no es así, tu hosting te proporcionará el host correcto.

[WARNING]
Nunca uses el editor de texto del panel de control para editar este archivo si no tienes cuidado. Si el editor añade caracteres invisibles o cambia el formato, el archivo podría romperse y tu sitio dejará de funcionar. Siempre es más seguro descargar, editar localmente y volver a subir.

Método 3: Usando el instalador de Syspanel (HestiaCP)

Si tu hosting utiliza Syspanel (también conocido como HestiaCP), el proceso para crear una base de datos y obtener las credenciales es muy sencillo. Recuerda que el acceso al panel se hace a través del puerto 2106 (por ejemplo, https://tu-servidor:2106).

Para crear una base de datos y un usuario en Syspanel:

Inicia sesión en Syspanel.
Busca la sección "Base de Datos" o "Databases" en el menú lateral.
Haz clic en "Añadir Base de Datos".
Completa los campos:
- Base de datos: El nombre que quieras para tu base (por ejemplo, mipagina_db).
- Usuario: El nombre de usuario que usarás (por ejemplo, mipagina_user).
- Contraseña: Introduce una contraseña segura o usa el generador del propio panel.
Haz clic en "Guardar".
Verás un resumen con el nombre de la base de datos, el usuario, la contraseña y el host (que normalmente será localhost).

Con estos datos, ya puedes usar el Método 1 o el Método 2 para configurar tu WordPress.

Solución de problemas comunes (FAQ)

Aquí tienes una lista de los problemas más habituales y cómo solucionarlos.

¿Por qué me da "Error al establecer una conexión con la base de datos"?

Este es el error más frecuente. Las causas suelen ser:

Credenciales incorrectas: Revisa el nombre de la base de datos, el usuario y la contraseña. Un simple error tipográfico es la causa número uno.
Host incorrecto: Si el host no es localhost, asegúrate de que has escrito la dirección exacta que te dio tu proveedor.
La base de datos no existe: Verifica en tu panel de control que la base de datos se haya creado correctamente.
El usuario no tiene permisos: Asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos. En cPanel o Syspanel puedes gestionar los privilegios desde la sección de bases de datos.

¿Qué hago si el error dice "No se pudo seleccionar la base de datos"?

Este error es un poco más específico. Significa que WordPress se conectó al servidor MySQL, pero no pudo encontrar la base de datos que le indicaste.

Revisa el DB_NAME: Asegúrate de que el nombre de la base de datos existe exactamente como lo escribiste. En algunos paneles, el nombre de la base de datos lleva un prefijo con el nombre de tu usuario (ej. usuario_wpdb). Copia el nombre completo desde tu panel de control.

¿Cómo sé si mi host es `localhost` o no?

La regla general es: si tu sitio web y tu base de datos están en el mismo servidor de hosting, el host es localhost. Si estás en un hosting compartido, lo más probable es que sea localhost. Si tienes dudas, consulta la documentación de tu proveedor o el panel de control.

¿Puedo cambiar el prefijo de las tablas de WordPress?

Sí, puedes. De hecho, es una medida de seguridad recomendada. En el archivo wp-config.php, busca la línea que dice:

$table_prefix = 'wp_';

Cámbiala por algo como mi_prefijo_ o blog_. Importante: Si ya has instalado WordPress, cambiar el prefijo manualmente romperá tu sitio, ya que las tablas en la base de datos se llaman wp_posts, wp_options, etc. Si cambias el prefijo, WordPress buscará mi_prefijo_posts, que no existe. Solo debes cambiarlo antes de la instalación.

Consejos de seguridad para tu archivo wp-config.php

Este archivo contiene información sensible, así que debes protegerlo.

No lo compartas: No publiques el contenido de este archivo en foros o con terceros. Contiene tus credenciales de base de datos.
Mantén las claves de seguridad (Salts): En el mismo archivo, verás una sección con las llamadas "Authentication Unique Keys and Salts". Estas claves ayudan a encriptar las sesiones de los usuarios. Si tu sitio ha sido hackeado, es recomendable cambiarlas. Puedes generar nuevas claves desde la página oficial de WordPress: https://api.wordpress.org/secret-key/1.1/salt/.
Considera mover el archivo: WordPress permite mover el archivo wp-config.php a un directorio superior a la raíz de tu sitio web, es decir, fuera del alcance público. Esto dificulta que un atacante pueda acceder a él. Para hacerlo, simplemente mueve el archivo a la carpeta padre y WordPress lo encontrará automáticamente.

Conclusión

Conectar WordPress a una base de datos MySQL es un proceso fundamental y, una vez que lo entiendes, es muy sencillo. El archivo wp-config.php es la pieza clave, y saber editarlo te dará una gran autonomía para gestionar tu sitio web, ya sea para una instalación inicial o para una migración a un nuevo servidor.

Recuerda siempre verificar tus credenciales, ser cuidadoso al editar el archivo y mantenerlo seguro. Con esta guía, ya tienes todas las herramientas para hacerlo correctamente. Si sigues teniendo problemas, no dudes en contactar con el soporte técnico de tu proveedor de hosting. Ellos podrán verificar la configuración del servidor y ayudarte a resolver cualquier problema específico de tu entorno.

[TIP]
Guarda tus credenciales de base de datos en un gestor de contraseñas. Es una buena práctica que te ahorrará muchos dolores de cabeza en el futuro.