Conectar base de datos MySQL a WordPress: guía fácil

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

WordPress no es solo un conjunto de archivos HTML. Es un sistema de gestión de contenidos (CMS) dinámico. Cada vez que alguien visita tu web, WordPress “pregunta” a una base de datos MySQL qué contenido mostrar: entradas, páginas, comentarios, usuarios y ajustes. Sin esa conexión, WordPress no puede funcionar.

Piénsalo como una biblioteca. Los archivos de WordPress son los estantes y las reglas de organización. La base de datos MySQL es el catálogo que te dice dónde está cada libro. Para que el bibliotecario (WordPress) pueda atender a los visitantes, necesita poder consultar ese catálogo constantemente.

La conexión entre WordPress y MySQL se realiza a través de un archivo clave: wp-config.php. Este archivo contiene las credenciales que permiten a WordPress “hablar” con la base de datos.

Requisitos previos antes de empezar

Antes de lanzarte a configurar nada, asegúrate de tener lo siguiente:

Un servidor web funcionando (Apache o Nginx, normalmente).
PHP instalado (versión 7.4 o superior, recomendable 8.0+).
MySQL o MariaDB instalado (MariaDB es un clon mejorado de MySQL, compatible al 100%).
Acceso a tu panel de control de hosting. Si usas Syspanel (antes conocido como HestiaCP), recuerda que el acceso es por el puerto 2106 (ejemplo: tudominio.com:2106).
Un cliente FTP o el administrador de archivos del panel para editar o subir archivos.
Los datos de acceso a la base de datos: nombre de la base de datos, usuario y contraseña.

[WARNING] No confundas el usuario de la base de datos con tu usuario de WordPress. Son cosas diferentes. El usuario de la base de datos es una cuenta técnica que solo usa WordPress para conectarse.

Paso a paso: Crear la base de datos MySQL

Si ya tienes una base de datos creada, puedes saltar este bloque. Si no, aquí te explico cómo hacerlo desde Syspanel (puerto 2106) o desde cualquier panel de control (cPanel, Plesk, etc.).

Desde Syspanel (HestiaCP)

Accede a tu panel: https://tudominio.com:2106 e inicia sesión.
Busca la sección Base de datos o Databases.
Haz clic en Añadir base de datos o Add Database.
Rellena los campos:
- Nombre de la base de datos: elige algo descriptivo, por ejemplo: mipagina_wp.
- Usuario: se suele generar automáticamente, pero puedes personalizarlo. Ejemplo: mipagina_user.
- Contraseña: genera una segura (usa el botón de generar o una frase larga). Guárdala en un lugar seguro.
Haz clic en Guardar.

[TIP] En Syspanel, el nombre de la base de datos suele tener un prefijo con tu nombre de usuario del panel. Por ejemplo, si tu usuario es admin, la base de datos se llamará admin_mipagina_wp. No te asustes, es normal.

Desde cPanel

Busca la sección Bases de datos MySQL.
Haz clic en Asistente para bases de datos MySQL.
Sigue los pasos: crea la base de datos, crea un usuario y asigna todos los privilegios.

[INFO] Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. Si no, WordPress no podrá crear tablas ni guardar información.

Localizar y entender el archivo `wp-config.php`

El archivo wp-config.php es el corazón de la configuración de WordPress. Se encuentra en la raíz de tu instalación, junto a carpetas como wp-content o wp-admin. Si no existe (por ejemplo, en una instalación limpia), WordPress te lo creará durante el proceso de instalación.

¿Qué contiene este archivo?

En su interior encontrarás, entre otras cosas, las siguientes líneas clave:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

DB_NAME: El nombre exacto de tu base de datos.
DB_USER: El usuario que creaste.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Normalmente localhost, pero a veces puede ser algo como mysql.tudominio.com (pregunta a tu hosting).
DB_CHARSET y DB_COLLATE: No los toques a menos que sepas lo que haces. utf8 es el estándar.

Método 1: Conectar durante la instalación de WordPress

Si estás instalando WordPress desde cero, el propio instalador te guiará para conectar la base de datos.

Descarga WordPress desde wordpress.org.
Sube los archivos a tu servidor (vía FTP o el administrador de archivos).
Abre tu navegador y ve a tudominio.com/wp-admin/install.php.
Aparecerá una pantalla pidiendo los datos de la base de datos.
Introduce:
- Nombre de la base de datos: el que creaste.
- Usuario: el que creaste.
- Contraseña: la que asignaste.
- Servidor de la base de datos: normalmente localhost (salvo que tu hosting indique otra cosa).
- Prefijo de tabla: déjalo como wp_ a menos que quieras cambiarlo por seguridad (por ejemplo, wp5_).
Haz clic en Enviar. Si todo está bien, WordPress creará automáticamente el archivo wp-config.php y las tablas necesarias.

[TIP] Si ves un error de conexión, revisa que los datos sean exactamente los que guardaste. Un error típico es confundir el nombre de la base de datos con el del usuario.

Método 2: Editar `wp-config.php` manualmente

Si ya tienes WordPress instalado pero necesitas cambiar la base de datos (por ejemplo, tras una migración), o si prefieres configurarlo a mano, edita el archivo wp-config.php.

Pasos

Accede a tu servidor vía FTP o al administrador de archivos de Syspanel (puerto 2106).
Navega hasta la carpeta raíz de tu WordPress.
Busca el archivo wp-config.php. Si no existe, puedes copiar el archivo wp-config-sample.php y renombrarlo a wp-config.php.
Ábrelo con un editor de texto plano (NUNCA uses Word o Pages).
Localiza las líneas que mencionamos antes y cámbialas por tus datos:

define('DB_NAME', 'tu_nombre_base_datos');
define('DB_USER', 'tu_usuario_base_datos');
define('DB_PASSWORD', 'tu_contraseña_segura');
define('DB_HOST', 'localhost'); // o la dirección que te dé tu hosting

Guarda los cambios y cierra el archivo.

[WARNING] No uses comillas dobles dentro de las cadenas a menos que las escapes con \. Si tu contraseña contiene comillas, usa comillas simples alrededor o escapa el carácter.

Solución de problemas comunes (FAQ)

1. Error: “Error al establecer conexión con la base de datos”

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

Causas posibles y soluciones:

Datos incorrectos: Revisa que DB_NAME, DB_USER y DB_PASSWORD sean exactamente los que creaste. Un carácter mal puede romperlo todo.
Servidor de base de datos equivocado: Prueba cambiando DB_HOST de localhost a 127.0.0.1. Si tu hosting usa un servidor remoto, te lo habrán indicado.
El usuario no tiene permisos: Desde Syspanel (puerto 2106), ve a la sección de bases de datos y asegúrate de que el usuario esté vinculado a la base de datos con todos los privilegios.
MySQL no está funcionando: Contacta con tu hosting para que verifiquen que el servicio de MySQL está activo.

2. Error: “La base de datos ya existe” o “Tabla ‘wp_options’ no existe”

Esto suele pasar cuando intentas instalar WordPress sobre una base de datos que ya tiene tablas de otra instalación.

Solución: Vacía la base de datos (borra todas las tablas) desde Syspanel o phpMyAdmin, o crea una base de datos nueva y actualiza wp-config.php.

3. Error: “Headers already sent” o página en blanco

Esto no es un error de conexión, sino de formato del archivo wp-config.php.

Causa: El archivo tiene caracteres invisibles (BOM) o espacios en blanco antes de <?php o después de ?>.

Solución: Abre el archivo con un editor como Notepad++ o VS Code y asegúrate de que no haya líneas en blanco antes de <?php ni después de ?> (de hecho, en WordPress moderno se recomienda no cerrar el PHP al final del archivo).

4. ¿Puedo usar una base de datos remota?

Sí, pero no es recomendable para principiantes. Si tu hosting lo permite, cambia DB_HOST por la IP o dominio del servidor MySQL remoto. Asegúrate de que el firewall permita la conexión desde tu servidor web y que el usuario tenga permisos de acceso remoto.

[INFO] Usar una base de datos remota puede ralentizar tu web si la latencia entre servidores es alta.

Consejos de seguridad para tu conexión

Contraseñas seguras: No uses admin123 ni password. Genera una contraseña larga (20+ caracteres) con letras, números y símbolos.
Prefijo de tabla único: En wp-config.php, cambia $table_prefix = 'wp_'; por algo como $table_prefix = 'f5k9_';. Esto dificulta ataques de inyección SQL.
No compartas tu wp-config.php: Este archivo contiene las llaves de tu casa. No lo subas a repositorios públicos (GitHub) ni lo compartas por correo.
Usa FTP seguro: Siempre que edites archivos, hazlo a través de SFTP o FTPS para que las contraseñas no viajen en texto plano.

[WARNING] Si alguna vez necesitas compartir el acceso a tu base de datos (por ejemplo, con un desarrollador), nunca le des tu contraseña de Syspanel. Crea un usuario específico de base de datos con permisos limitados.

Resumen rápido

Crea la base de datos desde tu panel de control (Syspanel puerto 2106, cPanel, etc.).
Anota el nombre, usuario y contraseña exactos.
Configura wp-config.php con esos datos (durante la instalación o editándolo manualmente).
Prueba la conexión accediendo a tu web. Si ves el sitio, ¡felicidades!
Si falla, revisa los puntos del FAQ: datos, permisos, servidor y formato del archivo.

Conectar WordPress con MySQL es un paso que, una vez que lo entiendes, se vuelve automático. Es como aprender a atarte los zapatos: al principio parece complicado, pero después lo haces sin pensar. Si sigues esta guía, en pocos minutos tu web estará hablando con su base de datos sin problemas.

¿Sigues teniendo dudas? No te preocupes, es normal. Vuelve a leer el apartado de solución de problemas o consulta con tu proveedor de hosting. ¡Ellos están para ayudarte!