Conectar WordPress a Base de Datos MySQL: Guía Fácil y Rápida

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver una de las dudas más comunes cuando empiezas con WordPress: cómo conectar tu sitio web a una base de datos MySQL. Parece algo técnico, pero te prometo que es más fácil de lo que crees. Vamos paso a paso, como si estuviéramos viendo la pantalla juntos.

¿Qué es la conexión entre WordPress y MySQL?

WordPress es un gestor de contenidos (CMS) que necesita un lugar donde guardar toda tu información: entradas, páginas, usuarios, comentarios, configuraciones, etc. Ese lugar es una base de datos, casi siempre MySQL. La conexión se hace a través de un archivo llamado wp-config.php, que es como el “cerebro” que le dice a WordPress dónde y cómo encontrar esa base de datos.

Sin esta conexión, WordPress no puede funcionar. Por eso es tan importante saber configurarla correctamente.

Requisitos previos para conectar WordPress a MySQL

Antes de empezar, asegúrate de tener lo siguiente a mano:

Un servidor web (puede ser local con XAMPP, MAMP, o un hosting remoto).
MySQL o MariaDB instalado (casi todos los hosting lo incluyen).
Acceso a tu panel de control (cPanel, Syspanel, Plesk, etc.).
Datos de la base de datos: nombre de la base, usuario, contraseña y servidor (normalmente es "localhost").

[INFO] Si usas Syspanel (el panel que antes se llamaba HestiaCP), recuerda que accedes a él a través del puerto 2106. Por ejemplo: https://tudominio.com:2106. Allí podrás crear tu base de datos MySQL fácilmente.

Paso 1: Crear la base de datos MySQL

El primer paso es tener una base de datos lista. Aquí te explico cómo hacerlo en los paneles más comunes.

En Syspanel (HestiaCP)

Inicia sesión en Syspanel usando https://tudominio.com:2106.
Ve a la sección Base de datos o Databases.
Haz clic en Agregar base de datos.
Escribe un nombre para tu base (por ejemplo: mipagina_wp).
El sistema generará automáticamente un usuario y una contraseña. Guárdalos en un lugar seguro.
Haz clic en Guardar.

En cPanel

Entra a tu cPanel.
Busca la sección Bases de datos y haz clic en MySQL Databases.
Crea una nueva base de datos (ej: mipagina_wp).
Crea un usuario y asigna una contraseña segura.
Vincula el usuario a la base de datos y dale todos los privilegios.

En phpMyAdmin (local o remoto)

Abre phpMyAdmin desde tu servidor (normalmente en http://localhost/phpmyadmin).
Haz clic en Nueva.
Ponle un nombre a tu base (ej: wordpress_db).
Elige utf8_general_ci como cotejamiento.
Haz clic en Crear.

[TIP] Para contraseñas seguras, usa generadores online o el mismo panel. Evita contraseñas como "123456" o "admin".

Paso 2: Obtener los datos de conexión

Una vez creada la base, necesitas cuatro datos clave:

Nombre de la base de datos (Database Name)
Usuario de la base de datos (Username)
Contraseña del usuario (Password)
Servidor de la base de datos (Database Host)

En la mayoría de los hosting, el servidor es localhost. Sin embargo, en algunos casos (como hosting compartidos o servidores remotos) puede ser una dirección IP o un nombre como mysql.tudominio.com. Si no estás seguro, revisa el panel o contacta a tu proveedor.

Paso 3: Configurar el archivo wp-config.php

Aquí viene la parte más importante. El archivo wp-config.php es el que contiene toda la configuración de conexión.

Opción A: Instalación nueva de WordPress

Si estás instalando WordPress por primera vez, el proceso típico es:

Descarga WordPress desde wordpress.org.
Sube los archivos a tu servidor (por FTP o desde el panel de archivos).
Abre tu navegador y ve a tudominio.com/wp-admin/install.php.
WordPress te pedirá los datos de la base de datos. Introduce los cuatro datos que guardaste.
Si todo está bien, ¡WordPress se conectará automáticamente!

Opción B: Si ya tienes WordPress y necesitas cambiar la base de datos

A veces cambias de hosting o restauras un backup. Entonces debes editar manualmente el wp-config.php.

Accede a los archivos de tu sitio (vía FTP o panel de archivos).
Busca el archivo wp-config.php en la raíz de tu instalación.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca estas líneas y modifícalas con tus datos:

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_del_usuario');
define('DB_HOST', 'localhost');

Guarda el archivo y súbelo de nuevo si lo editaste localmente.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una coma o comilla mal puesta) puede romper tu sitio. Siempre haz una copia de seguridad antes.

Opción C: Usando Syspanel (HestiaCP) para editar el archivo

Si tu hosting usa Syspanel, puedes editar el wp-config.php directamente desde el panel:

Inicia sesión en Syspanel (https://tudominio.com:2106).
Ve a la sección Archivos o File Manager.
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html).
Busca wp-config.php, haz clic derecho y selecciona Editar.
Cambia las líneas de configuración y guarda.

Paso 4: Probar la conexión y solucionar errores comunes

Una vez que hayas configurado todo, es hora de probar. Simplemente visita tu sitio web. Si ves la página de inicio de WordPress, ¡felicidades! La conexión fue exitosa.

Pero si ves una pantalla en blanco o un mensaje de error, no te preocupes. Aquí tienes los errores más comunes y cómo solucionarlos.

Error: "Error establishing a database connection"

Este es el más frecuente. Significa que WordPress no puede comunicarse con MySQL.

Posibles causas y soluciones:

Datos incorrectos: Revisa que el nombre de la base, usuario y contraseña sean exactamente los que creaste. Un error de tipeo es muy común.
Servidor de base de datos incorrecto: Si tu hosting no usa localhost, prueba con la IP o el nombre que te dieron. Por ejemplo, en algunos hosting es mysql.tudominio.com.
Usuario sin privilegios: Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. Vuelve a vincularlo desde el panel.
Base de datos corrupta: Si importaste una base de datos, puede estar dañada. Prueba creando una nueva base limpia e instalando WordPress de nuevo.

Error: "Headers already sent"

Esto suele ocurrir si el archivo wp-config.php tiene espacios o líneas en blanco antes de <?php o después de ?>. Abre el archivo y asegúrate de que no haya nada antes de la etiqueta de apertura de PHP.

Error: "Your PHP installation appears to be missing the MySQL extension"

Esto significa que tu servidor no tiene instalada la extensión necesaria para conectar con MySQL. Contacta a tu proveedor de hosting y pídele que active la extensión mysqli o PDO_MySQL.

Error: "Table 'wp_options' doesn't exist"

Esto pasa cuando la base de datos está vacía o no tiene las tablas de WordPress. Solución: instala WordPress de nuevo o importa una base de datos correcta.

[TIP] Si después de todo sigues sin conexión, prueba a cambiar temporalmente el DB_HOST de localhost a 127.0.0.1. A veces el servidor MySQL escucha en esa dirección.

Consejos adicionales para mantener tu conexión segura

Cambia el prefijo de las tablas: Por defecto es wp_. Puedes cambiarlo durante la instalación o editando el wp-config.php con $table_prefix = 'miprefijo_';. Esto dificulta ataques de SQL injection.
No compartas tu archivo wp-config.php: Contiene información sensible. Nunca lo subas a repositorios públicos como GitHub.
Usa contraseñas fuertes para la base de datos.
Actualiza WordPress y los plugins regularmente para evitar vulnerabilidades.

Preguntas frecuentes (FAQ)

¿Puedo usar MariaDB en lugar de MySQL?

Sí, MariaDB es un reemplazo directo de MySQL y WordPress funciona perfectamente con él. De hecho, muchos hosting lo usan por defecto.

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

Puedes cambiarla desde el panel de control (Syspanel, cPanel, etc.). Luego actualiza el wp-config.php con la nueva contraseña.

¿Puedo tener varias bases de datos para un mismo WordPress?

No, WordPress solo puede conectarse a una base de datos a la vez. Si necesitas separar contenido, usa plugins como "WordPress Multisite".

¿Es seguro tener la base de datos en el mismo servidor que WordPress?

Sí, es lo más común. Pero si tienes mucho tráfico, puedes considerar una base de datos separada en otro servidor (más avanzado).

Conclusión

Conectar WordPress a una base de datos MySQL es un proceso sencillo si sigues los pasos correctos. Recuerda:

Crear la base de datos y el usuario.
Obtener los datos de conexión.
Configurar el archivo wp-config.php.
Probar y solucionar errores comunes.

Si usas Syspanel (HestiaCP), recuerda que accedes por el puerto 2106 y que desde allí puedes gestionar todo. Y si algo sale mal, no dudes en volver a este artículo o contactar a tu soporte técnico.

¡Ahora ya puedes poner en marcha tu WordPress! ¿Tienes alguna duda? Escríbela en los comentarios y te ayudaré encantado.