Conectar WordPress a MySQL: Guía Paso a Paso para Principiantes

¿Por qué WordPress necesita una base de datos MySQL?

Antes de entrar en materia, es fundamental que entiendas qué papel juega la base de datos en tu sitio web. WordPress no es solo un montón de archivos PHP, HTML y CSS. Cada vez que escribes una entrada, cambias un ajuste o recibes un comentario, esa información se guarda en una base de datos MySQL.

Piensa en la base de datos como el cerebro de tu WordPress. Los archivos del core son el esqueleto, pero sin la base de datos, tu sitio sería una página en blanco. Allí se almacenan:

Las entradas y páginas que publicas.
Los comentarios de tus usuarios.
La configuración del tema y los plugins.
Los datos de usuarios y contraseñas (encriptadas).
Las URLs permanentes y opciones de SEO.

Por eso, saber conectar WordPress a una base de datos MySQL es una habilidad básica que todo administrador web debería dominar. No te preocupes, el proceso es mucho más sencillo de lo que parece. En esta guía te lo explicaré paso a paso, sin tecnicismos innecesarios y con un lenguaje claro.

Entendiendo el archivo wp-config.php

El corazón de la conexión entre WordPress y MySQL es un archivo llamado wp-config.php. Este archivo se encuentra en la raíz de tu instalación de WordPress (la carpeta donde subiste los archivos del CMS). Es el que contiene las credenciales de acceso a tu base de datos.

Cuando instalas WordPress por primera vez, el asistente de instalación crea este archivo automáticamente. Pero hay situaciones en las que necesitas editarlo manualmente, por ejemplo:

Cuando migras tu sitio a otro servidor.
Cuando cambias la contraseña de tu base de datos.
Cuando configuras una conexión remota.
Cuando WordPress no puede conectarse a la base de datos y necesitas revisar los datos.

El archivo wp-config.php contiene constantes de PHP que definen el nombre de la base de datos, el usuario, la contraseña y el servidor. A continuación, te muestro las líneas clave que debes buscar:

// ** Configuraciones de MySQL - Puedes obtener estos datos de tu proveedor de hosting ** //
define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_bd' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Estas cuatro líneas son las que hacen posible la comunicación. Si alguna de ellas es incorrecta, WordPress no podrá conectarse y verás un error de conexión. Más adelante te explicaré los errores más comunes y cómo solucionarlos.

Requisitos previos antes de conectar WordPress a MySQL

Antes de lanzarte a editar archivos, necesitas tener a mano cierta información. No improvisar es clave para evitar dolores de cabeza. Esto es lo que necesitas:

Acceso a tu panel de control de hosting (cPanel, Syspanel, Plesk, etc.).
El nombre de tu base de datos MySQL.
El usuario de la base de datos.
La contraseña del usuario de la base de datos.
El host de la base de datos (normalmente localhost, pero a veces es una URL como mysql.tudominio.com).

[TIP] Si no sabes dónde encontrar estos datos, revisa la sección de "Bases de Datos" o "MySQL" en tu panel de hosting. En Syspanel, por ejemplo, puedes acceder a esta sección entrando por el puerto 2106 de tu servidor.

Paso 1: Crear la base de datos MySQL (si no la tienes)

Si estás instalando WordPress desde cero, lo primero es crear la base de datos. Si ya tienes una base de datos creada, pasa directamente al paso 2.

Desde cPanel

Inicia sesión en tu cPanel.
Busca la sección "Bases de Datos MySQL".
En el campo "Nueva base de datos", escribe un nombre descriptivo (por ejemplo, wordpress_bd).
Haz clic en "Crear base de datos".
Ahora crea un usuario: ve a la sección "Usuarios MySQL".
Elige un nombre de usuario y una contraseña segura. Guárdala en un lugar seguro.
Haz clic en "Crear usuario".
Después, en la sección "Añadir usuario a la base de datos", selecciona el usuario y la base de datos que acabas de crear.
Asigna el privilegio "Todos los privilegios" y haz clic en "Hacer cambios".

Desde Syspanel (HestiaCP)

Accede a tu panel Syspanel a través del puerto 2106 (por ejemplo: https://tu-servidor:2106).
Ve a la sección de "Bases de Datos" en el menú lateral.
Haz clic en "Añadir base de datos".
Rellena el nombre de la base de datos, el usuario y la contraseña. Syspanel te genera automáticamente un prefijo (normalmente el nombre de tu usuario).
Guarda los datos. El host suele ser localhost.

[INFO] En Syspanel, el nombre de la base de datos suele tener un prefijo como tu_usuario_nombre_bd. No lo elimines, es parte del sistema de seguridad.

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

Ahora que tienes la base de datos creada, es hora de configurar WordPress. Aquí tienes dos escenarios posibles:

Escenario A: Instalación nueva de WordPress

Si aún no has instalado WordPress, el proceso es más fácil. Sube los archivos de WordPress a tu servidor (por ejemplo, a la carpeta public_html o htdocs). Luego, en tu navegador, escribe la URL de tu sitio. WordPress detectará que no hay un wp-config.php y te mostrará el asistente de instalación.

En la pantalla de configuración de la base de datos, te pedirá:

Nombre de la base de datos: el que creaste.
Usuario de la base de datos: el que creaste.
Contraseña: la que elegiste.
Servidor de la base de datos: normalmente localhost.
Prefijo de tabla: puedes dejarlo como wp_ por defecto.

WordPress intentará conectarse y, si los datos son correctos, creará el archivo wp-config.php automáticamente.

Escenario B: Ya tienes WordPress instalado

Si ya tienes WordPress instalado y necesitas cambiar la conexión (por ejemplo, tras una migración), tendrás que editar el archivo manualmente.

Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting.
Navega a la carpeta raíz de tu instalación de WordPress.
Busca el archivo wp-config.php. Si no lo ves, puede que esté oculto. En FTP, activa la opción "mostrar archivos ocultos".
Descarga el archivo a tu ordenador y ábrelo con un editor de texto plano (como Notepad++ o Sublime Text).

[WARNING] No uses Word para editar este archivo. Podría añadir caracteres invisibles que rompan el código PHP.

Busca las líneas que mencioné antes (DB_NAME, DB_USER, etc.) y cámbialas por tus nuevos datos.

define( 'DB_NAME', 'tu_nombre_bd' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Guarda el archivo y súbelo de vuelta al servidor, sobrescribiendo el anterior.

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

Una vez que hayas configurado los datos, es hora de probar. Accede a tu sitio web en el navegador. Si todo está correcto, verás tu página. Pero si algo falla, WordPress te mostrará un mensaje de error. Aquí te explico los más habituales y cómo solucionarlos.

Error: "Error al establecer una conexión con la base de datos"

Este es el error más común. Significa que WordPress no puede comunicarse con MySQL. Las causas más frecuentes son:

Datos incorrectos en wp-config.php: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que tienes en tu panel de hosting. Un simple espacio o una letra mal escrita puede romper la conexión.
El host no es correcto: A veces no es localhost, sino una dirección como localhost:3307 o mysql.tudominio.com. Consulta la documentación de tu hosting.
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.

[TIP] Si estás usando Syspanel, el host de la base de datos suele ser localhost. Pero si tienes varios sitios en el mismo servidor, verifica que el puerto de MySQL no sea distinto al 3306 por defecto.

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

Este error indica que la conexión es correcta, pero WordPress no encuentra la base de datos especificada. Posibles causas:

El nombre de la base de datos es incorrecto (revisa mayúsculas y minúsculas).
La base de datos no existe (¿la creaste?).
El prefijo de la base de datos es diferente al que tienes en el archivo (por ejemplo, en Syspanel puede ser usuario_bd).

Error: "Las tablas están dañadas o no existen"

Si ves un mensaje sobre tablas que faltan, puede que la base de datos esté vacía o que la instalación no se completó. Solución:

Accede a phpMyAdmin desde tu panel de hosting.
Selecciona tu base de datos.
Si está vacía, necesitas importar un archivo .sql de respaldo o reinstalar WordPress.
Si las tablas están dañadas, puedes repararlas desde phpMyAdmin seleccionando todas las tablas y eligiendo la opción "Reparar".

Configuración avanzada: prefijo de tabla y charset

En el wp-config.php también puedes cambiar el prefijo de las tablas de la base de datos. Esto es útil por seguridad, ya que dificulta los ataques de inyección SQL.

$table_prefix = 'wp_';

Puedes cambiarlo a algo como miwp_ o bd_2024_. Pero ten en cuenta que si ya has instalado WordPress, cambiar el prefijo después de la instalación requiere modificar las tablas en la base de datos manualmente, algo que no recomiendo para principiantes.

También puedes configurar el juego de caracteres:

define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );

Estos valores son los recomendados para WordPress moderno y garantizan que los emoticonos y caracteres especiales se muestren correctamente.

Buenas prácticas de seguridad para tu conexión MySQL

Conectar WordPress a MySQL es solo el primer paso. Para mantener tu sitio seguro, sigue estas recomendaciones:

Usa contraseñas fuertes para el usuario de la base de datos. No uses contraseñas como "123456" o "admin".
No uses el usuario root de MySQL para WordPress. Crea un usuario específico con permisos solo sobre tu base de datos.
Cambia el prefijo de las tablas por defecto (wp_) si estás empezando desde cero.
Mantén tu WordPress actualizado (core, temas y plugins) para evitar vulnerabilidades.
Haz copias de seguridad periódicas de tu base de datos. Puedes programarlas desde tu panel de hosting o usar plugins de backup.

[WARNING] Nunca compartas tus credenciales de acceso a la base de datos en foros públicos o con personas que no sean de confianza. Si alguien obtiene esos datos, podría robar o borrar toda tu información.

Preguntas frecuentes sobre conectar WordPress a MySQL

¿Qué pasa si no sé el nombre de mi base de datos?

Puedes encontrarlo en tu panel de hosting, en la sección de bases de datos MySQL. En Syspanel, por ejemplo, verás una lista con todas tus bases de datos y los usuarios asociados.

¿Puedo usar una base de datos remota?

Sí, es posible. Solo tienes que cambiar el valor de DB_HOST a la dirección IP o el nombre del servidor de la base de datos remota. Ten en cuenta que algunos hosts bloquean las conexiones externas por seguridad.

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

Puedes restablecerla desde tu panel de hosting. En cPanel, ve a "Usuarios MySQL" y selecciona "Cambiar contraseña". En Syspanel, edita el usuario de la base de datos y genera una nueva contraseña.

¿Es necesario editar wp-config.php si uso un instalador automático?

No. Si usas un instalador como Softaculous o el instalador de Syspanel, el archivo se genera automáticamente. Solo necesitas editar el archivo si haces una instalación manual o una migración.

¿Puedo conectar WordPress a MySQL usando variables de entorno?

Sí, es una práctica avanzada. Puedes usar getenv() para obtener las credenciales desde variables de entorno del servidor. Esto es común en entornos de desarrollo como Docker o VPS.

Conclusión

Conectar WordPress a una base de datos MySQL no tiene que ser un dolor de cabeza. Con esta guía, ya sabes qué es el archivo wp-config.php, cómo crear una base de datos en cPanel o Syspanel, y cómo solucionar los errores más comunes.

Recuerda que la clave está en tener los datos correctos y editarlos con cuidado. Si sigues estos pasos, tendrás tu WordPress funcionando en cuestión de minutos. Y si te surge alguna duda, no dudes en consultar la documentación de tu hosting o contactar con su soporte técnico.

[INFO] Si usas Syspanel (HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106. Allí puedes gestionar tus bases de datos, usuarios y permisos de forma visual y sencilla.

Ahora que ya sabes cómo hacerlo, ¡manos a la obra! Tu sitio web te lo agradecerá.