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

¿Qué significa conectar WordPress a una base de datos MySQL?

Antes de entrar en materia, es importante que entiendas qué es exactamente lo que vamos a hacer. WordPress es un gestor de contenidos (CMS) que necesita guardar toda su información: entradas, páginas, comentarios, usuarios y ajustes del sitio. Esa información no se guarda en archivos sueltos, sino en una base de datos MySQL. Por lo tanto, conectar WordPress a MySQL es el proceso de decirle a tu instalación de WordPress dónde está esa base de datos y cómo debe acceder a ella.

Esta conexión se realiza a través del archivo wp-config.php, que es el archivo de configuración principal de WordPress. Si este archivo no está bien configurado, tu sitio web no cargará y verás el famoso error "Error establishing a database connection". No te preocupes, es un problema muy común y fácil de solucionar si sigues los pasos correctos.

En esta guía, te explicaré paso a paso todo lo que necesitas saber sobre la configuración de wp-config.php para base de datos, cómo crear una base de datos MySQL desde cero y qué hacer si tu conexión falla. Vamos a ello.

Requisitos previos antes de empezar

Antes de intentar conectar WordPress a MySQL, asegúrate de tener lo siguiente:

Un servidor web con PHP instalado (Apache, Nginx o LiteSpeed).
MySQL o MariaDB instalado en tu servidor.
Acceso a tu panel de control de hosting o a herramientas como phpMyAdmin, Syspanel o la línea de comandos.
Los datos de acceso de tu base de datos: nombre de la base de datos, usuario y contraseña.
Un cliente FTP o acceso al administrador de archivos de tu hosting para editar archivos.

Si estás usando un panel de control como cPanel, Plesk o Syspanel (recuerda que el puerto de acceso a Syspanel es el 2106), el proceso será mucho más sencillo porque estas herramientas suelen tener asistentes para crear bases de datos en unos pocos clics.

Paso 1: Crear una base de datos MySQL

El primer paso es tener una base de datos lista para usar. Si ya la tienes, puedes saltarte esta sección. Si no, aquí te explico cómo crearla en los entornos más comunes.

Crear una base de datos con Syspanel

Si tu hosting utiliza Syspanel, inicia sesión en tu panel de control escribiendo http://tu-dominio.com:2106 en tu navegador. Una vez dentro, sigue estos pasos:

Busca la sección "Bases de datos" o "MySQL" en el menú principal.
Haz clic en "Crear base de datos" o "Add Database".
Escribe un nombre para tu base de datos (por ejemplo, mipagina_db). Asegúrate de que sea descriptivo y fácil de recordar.
Crea un usuario para la base de datos. Te pedirá un nombre de usuario y una contraseña. Anota estos datos porque los necesitarás más adelante.
Asigna todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) al usuario sobre la base de datos.
Guarda los cambios.

Crear una base de datos con phpMyAdmin

Si tienes acceso a phpMyAdmin, el proceso es igualmente sencillo:

Abre phpMyAdmin desde el panel de tu hosting.
Haz clic en la pestaña "Bases de datos".
Escribe el nombre de tu nueva base de datos en el campo correspondiente y selecciona la codificación utf8mb4_general_ci (recomendado para WordPress).
Haz clic en "Crear".
Ahora ve a la pestaña "Usuarios" y crea un nuevo usuario con contraseña.
Asigna los privilegios necesarios sobre la base de datos que acabas de crear.

[TIP] Anota siempre el nombre de la base de datos, el usuario y la contraseña en un lugar seguro. Los necesitarás para completar la configuración de wp-config.php.

Paso 2: Localizar y editar el archivo wp-config.php

El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress, normalmente en la carpeta public_html, www o htdocs, dependiendo de tu servidor. Si ya tienes WordPress instalado, este archivo existirá. Si estás instalando WordPress desde cero, el archivo se llamará wp-config-sample.php y deberás renombrarlo.

Para editarlo, tienes dos opciones:

Usar un cliente FTP como FileZilla: descarga el archivo, edítalo en tu ordenador con un editor de texto (como Notepad++ o Sublime Text) y súbelo de nuevo.
Usar el administrador de archivos de tu hosting: muchos paneles de control incluyen un editor de archivos integrado. Busca el archivo wp-config.php, haz clic derecho y selecciona "Editar".

Una vez que tengas el archivo abierto, busca la sección que dice:

// ** Ajustes de MySQL ** //
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

Paso 3: Configurar los datos de conexión

Ahora viene la parte clave: cómo conectar WordPress a MySQL modificando estos valores.

Nombre de la base de datos (DB_NAME)

Reemplaza 'nombre_de_tu_base_de_datos' con el nombre exacto que le diste a tu base de datos en el paso anterior. Por ejemplo:

define( 'DB_NAME', 'mipagina_db' );

Usuario de la base de datos (DB_USER)

Aquí debes poner el nombre de usuario que creaste. En algunos hosting, el nombre de usuario lleva un prefijo (por ejemplo, usuario_mipagina). Asegúrate de copiarlo exactamente.

define( 'DB_USER', 'usuario_mipagina' );

Contraseña (DB_PASSWORD)

Introduce la contraseña que asignaste al usuario. Es normal que contenga caracteres especiales, así que ten cuidado al copiarla y pegarla.

define( 'DB_PASSWORD', 'tu_contraseña_segura_123' );

Host de la base de datos (DB_HOST)

Este es un punto que causa mucha confusión. En la mayoría de los casos, el host es localhost, pero algunos proveedores de hosting utilizan una dirección diferente, como mysql.tudominio.com o una IP específica.

Si estás en un hosting compartido, lo más probable es que sea localhost.
Si usas un hosting gestionado o una base de datos externa, consulta la documentación de tu proveedor.

define( 'DB_HOST', 'localhost' );

[WARNING] Si pones un host incorrecto, WordPress no podrá conectarse a la base de datos. Si no estás seguro, contacta con tu proveedor de hosting o prueba con localhost primero.

Puerto y socket (opcional)

En algunos casos, especialmente en servidores dedicados o VPS, la base de datos puede estar escuchando en un puerto diferente al estándar (3306). Si tu proveedor te lo indica, puedes añadir el puerto al host de la siguiente manera:

define( 'DB_HOST', 'localhost:3307' );

También puedes definir un socket si tu servidor lo requiere:

define( 'DB_HOST', 'localhost:/var/run/mysqld/mysqld.sock' );

Pero esto es poco común y solo deberías hacerlo si sabes exactamente lo que estás haciendo.

Paso 4: Guardar y probar la conexión

Una vez que hayas editado los valores, guarda el archivo wp-config.php y súbelo de nuevo a tu servidor si lo estabas editando localmente.

Ahora abre tu navegador y visita tu sitio web. Si todo está correcto, verás tu página principal o el asistente de instalación de WordPress si aún no lo has configurado.

Si en lugar de tu web aparece el error "Error establishing a database connection", significa que algo no está bien. No entres en pánico, es un problema muy común y casi siempre se debe a uno de estos motivos:

El nombre de la base de datos, el usuario o la contraseña son incorrectos.
El host de la base de datos no es el correcto.
El usuario no tiene privilegios sobre la base de datos.
La base de datos no existe.

Revisa cada uno de los valores y vuelve a intentarlo.

[INFO] Si estás usando un hosting con Syspanel, recuerda que el puerto de acceso es el 2106. Asegúrate de que tu firewall o las reglas de seguridad no bloqueen la conexión a tu base de datos.

Paso 5: Configuraciones adicionales en wp-config.php

Además de los datos de conexión básicos, el archivo wp-config.php tiene otras configuraciones útiles que te pueden ayudar a optimizar tu sitio o a solucionar problemas.

Prefijo de tablas

Por defecto, WordPress utiliza el prefijo wp_ para sus tablas. Si quieres personalizarlo por seguridad, puedes cambiarlo en la línea:

$table_prefix = 'wp_';

Por ejemplo, podrías cambiarlo a mi_prefijo_. Esto es especialmente recomendable si quieres dificultar los ataques de inyección SQL.

Claves de autenticación (salts)

WordPress utiliza claves de autenticación para cifrar las cookies de sesión. Estas claves se definen mediante constantes como AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, etc. Si no las tienes definidas, WordPress te las generará automáticamente, pero es recomendable añadirlas manualmente.

Puedes obtener claves aleatorias desde 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 wp-config.php.

Depuración (WP_DEBUG)

Si estás desarrollando tu sitio, te recomiendo activar el modo de depuración. Esto te mostrará errores de PHP que pueden ayudarte a solucionar problemas de conexión o de otro tipo.

define( 'WP_DEBUG', true );

[TIP] Cuando termines de desarrollar, cambia WP_DEBUG a false para que los errores no sean visibles para los visitantes de tu sitio.

Solución de problemas comunes

Aunque la configuración de wp-config.php es sencilla, a veces surgen problemas. Aquí tienes una lista de los errores más frecuentes y cómo solucionarlos.

Error: "Error establishing a database connection"

Este es el error más común. Las causas más probables son:

Datos incorrectos: revisa el nombre de la base de datos, usuario y contraseña.
Host incorrecto: prueba a cambiar localhost por 127.0.0.1 o consulta con tu hosting.
La base de datos no existe: verifica que la base de datos se creó correctamente.
El usuario no tiene permisos: asegúrate de que el usuario tiene todos los privilegios sobre la base de datos.

Error: "Connection refused"

Este error suele indicar que el servidor MySQL no está aceptando conexiones. Puede ser porque:

El servicio MySQL está caído.
El puerto 3306 está bloqueado por el firewall.
El host especificado no es accesible desde tu servidor web.

Error: "Access denied for user"

Este error significa que el usuario no tiene permisos para conectarse a la base de datos. Soluciones:

Verifica que el nombre de usuario es correcto.
Asegúrate de que el usuario tiene privilegios sobre la base de datos específica.
Si usas Syspanel, revisa que el usuario esté asociado a la base de datos correcta.

Error: "Unknown database"

Este error indica que la base de datos no existe. Puede deberse a:

Un error al escribir el nombre en wp-config.php.
La base de datos se eliminó accidentalmente.
La base de datos se creó en otro servidor.

Preguntas frecuentes (FAQ)

¿Puedo conectar WordPress a una base de datos MySQL remota?

Sí, es posible. Solo necesitas cambiar el valor de DB_HOST a la dirección IP o dominio del servidor MySQL remoto. Eso sí, asegúrate de que el servidor remoto permite conexiones externas y que el puerto 3306 está abierto.

¿Qué es mejor, MySQL o MariaDB?

Ambos son sistemas de gestión de bases de datos muy similares. MariaDB es un fork de MySQL y es totalmente compatible con WordPress. Si tu hosting ofrece MariaDB, puedes usarlo sin problemas.

¿Cómo sé si mi base de datos está usando la codificación correcta?

WordPress recomienda usar utf8mb4 para soportar todos los caracteres Unicode, incluidos los emojis. Asegúrate de que tu base de datos y tus tablas estén configuradas con esta codificación.

¿Puedo cambiar el prefijo de las tablas después de instalar WordPress?

Sí, pero no es recomendable hacerlo manualmente. Si cambias el prefijo en wp-config.php sin actualizar las tablas, WordPress no podrá encontrar sus datos. Si necesitas cambiarlo, usa un plugin especializado o hazlo con cuidado mediante phpMyAdmin.

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

Si olvidaste la contraseña, puedes restablecerla desde tu panel de control de hosting (como Syspanel, cPanel, etc.) o desde phpMyAdmin. Una vez restablecida, actualiza el valor en wp-config.php.

Conclusión

Conectar WordPress a una base de datos MySQL es un proceso fundamental que, aunque puede parecer técnico, es bastante sencillo una vez que entiendes los conceptos básicos. La clave está en configurar correctamente el archivo wp-config.php con los datos de tu base de datos: nombre, usuario, contraseña y host.

Recuerda siempre:

Anota los datos de tu base de datos en un lugar seguro.
Verifica que el usuario tenga los permisos adecuados.
Prueba la conexión después de cada cambio.
Si algo falla, revisa los errores comunes y solucionalos uno por uno.

Con esta guía, ya tienes todo lo necesario para realizar la configuración de wp-config.php y resolver cualquier problema de conexión WordPress MySQL. Si sigues estos pasos, tu sitio web estará funcionando en poco tiempo.

[TIP] Si te surge cualquier duda, no dudes en consultar la documentación de tu proveedor de hosting o buscar ayuda en los foros oficiales de WordPress. La comunidad es muy activa y siempre hay alguien dispuesto a echar una mano.

¡Buena suerte con tu sitio web!