Conectar WordPress a base de datos MySQL: Paso a paso | FAQ

¡Hola! Soy tu asistente técnico, y hoy vamos a resolver una de las tareas más importantes al montar un sitio web en WordPress: conectar WordPress a una base de datos MySQL.

Si estás leyendo esto, probablemente ya tienes WordPress instalado o estás a punto de hacerlo, y te has topado con el famoso archivo wp-config.php. No te preocupes, es más sencillo de lo que parece. En esta guía te explicaré paso a paso, desde cero, cómo hacer la conexión, qué datos necesitas, y cómo solucionar los errores más comunes.

Al final de este artículo, sabrás exactamente cómo configurar WordPress MySQL para que tu web funcione sin problemas. ¡Empecemos!

¿Qué es una base de datos MySQL y por qué WordPress la necesita?

Antes de meternos en la configuración, entendamos lo básico. WordPress es un gestor de contenidos (CMS) que almacena toda la información de tu web (artículos, páginas, usuarios, comentarios, etc.) en una base de datos.

MySQL es el sistema de gestión de bases de datos más popular para WordPress. Piensa en la base de datos como un gran archivo organizado en tablas. Sin ella, WordPress no podría recordar nada de lo que publicas o configuras.

Por lo tanto, conectar WordPress MySQL es el paso fundamental para que tu sitio web cobre vida.

Requisitos previos antes de conectar WordPress a MySQL

Para seguir esta guía, necesitas tener acceso a:

Un servidor web (como Apache o Nginx) con PHP instalado.
Un panel de control de hosting (por ejemplo, Syspanel, cPanel, o phpMyAdmin).
WordPress descargado y subido a tu servidor (o ya instalado).
Credenciales de la base de datos: nombre de la base, usuario, contraseña y servidor (normalmente localhost).

[INFO] Si usas Syspanel (el panel de control que mencionamos), recuerda que el acceso a la gestión de bases de datos se hace a través del puerto 2106. Por ejemplo: https://tudominio.com:2106.

Paso 1: Crear la base de datos MySQL en tu hosting

No puedes conectar WordPress a una base de datos que no existe. Así que lo primero es crearla.

Desde Syspanel (antes cPanel, ahora Syspanel)

Inicia sesión en Syspanel usando el puerto 2106: https://tudominio.com:2106.
Busca la sección "Bases de Datos" y haz clic en "MySQL Databases".
En el campo "Create New Database", escribe un nombre (por ejemplo, wordpress_db). Haz clic en "Create Database".
Ahora, en "Add New User", crea un usuario (por ejemplo, wp_user) y una contraseña segura. Anótalos.
Vuelve a "Add User to Database", selecciona el usuario y la base de datos que creaste, y asigna todos los privilegios (marca "ALL PRIVILEGES").
Haz clic en "Make Changes".

¡Listo! Ya tienes tu base de datos y usuario creados.

Desde phpMyAdmin (alternativa)

Si tu hosting no tiene Syspanel, puedes usar phpMyAdmin:

Accede a phpMyAdmin desde el panel de tu hosting.
Haz clic en "New" en el menú izquierdo.
Escribe un nombre para la base de datos (ej. wordpress_db) y selecciona utf8_general_ci como cotejamiento.
Haz clic en "Create".
Ve a la pestaña "Privileges" y agrega un nuevo usuario con contraseña.
Asigna todos los privilegios a ese usuario sobre la base de datos creada.

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

El archivo wp-config.php es el corazón de la configuración de WordPress. Aquí es donde le dices a WordPress cómo conectarse a tu base de datos.

¿Dónde está el archivo?

Si instalaste WordPress manualmente, está en la carpeta raíz de tu sitio (por ejemplo, public_html o www).
Si usaste un instalador automático, puede estar en la misma ubicación.

¿Cómo editarlo?

Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o usa el Administrador de Archivos de Syspanel.
Busca el archivo wp-config.php. Si no existe, puedes crearlo a partir del archivo wp-config-sample.php (copia y renómbralo).
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).

Datos que necesitas reemplazar

Dentro del archivo, verás líneas como estas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'tu_usuario_de_base_de_datos');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Debes cambiar los valores por los que creaste en el Paso 1:

DB_NAME: El nombre de la base de datos (ej. wordpress_db).
DB_USER: El nombre del usuario (ej. wp_user).
DB_PASSWORD: La contraseña del usuario.
DB_HOST: Normalmente localhost, pero si tu hosting usa un servidor remoto, te lo indicarán.

[WARNING] No cambies nada más en el archivo a menos que sepas lo que haces. Un error puede romper tu sitio.

Ejemplo de configuración

define('DB_NAME', 'mi_sitio_wp');
define('DB_USER', 'admin_wp');
define('DB_PASSWORD', 'ClaveSegura123!');
define('DB_HOST', 'localhost');

Guarda el archivo y ciérralo.

Paso 3: Verificar la conexión (y solucionar errores comunes)

Ahora, intenta acceder a tu sitio web. Si todo está bien, verás la pantalla de instalación de WordPress (o tu web ya funcionando si ya habías instalado).

Si aparece un error, no te asustes. Aquí tienes los más frecuentes:

Error: "Error establishing a database connection"

Este es el clásico. Significa que WordPress no puede conectar con MySQL. Causas posibles:

Credenciales incorrectas: Revisa que el nombre de la base, usuario y contraseña estén bien escritos en wp-config.php.
Servidor de base de datos equivocado: Si tu hosting usa un servidor MySQL remoto, cambia DB_HOST de localhost a la IP o nombre del servidor (pregunta a tu proveedor).
La base de datos no existe: Ve a phpMyAdmin o Syspanel y verifica que la base de datos esté creada.

Error: "Can’t select database"

La base de datos existe pero WordPress no puede seleccionarla. Suele ocurrir si el usuario no tiene permisos. Ve a Syspanel o phpMyAdmin y asegúrate de que el usuario tenga todos los privilegios sobre la base de datos.

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

Falta la extensión de PHP para MySQL. Contacta a tu hosting para que activen mysqli o pdo_mysql en PHP.

[TIP] Si usas Syspanel, puedes cambiar la versión de PHP desde el panel (en "PHP Selector") y asegurarte de que las extensiones MySQL estén habilitadas.

Paso 4: Configurar WordPress MySQL con claves de seguridad (opcional pero recomendado)

El archivo wp-config.php también incluye claves de seguridad (salts) que protegen tu sitio contra ataques. Si no las has generado, WordPress las crea automáticamente, pero es mejor que las añadas manualmente.

Ve a https://api.wordpress.org/secret-key/1.1/salt/.
Copia todo el bloque de código que aparece.
Pégalo justo después de la línea define('DB_HOST', 'localhost'); en tu wp-config.php.
Guarda el archivo.

Esto hará que tu WordPress database connection sea más segura.

Paso 5: Probar la instalación de WordPress

Una vez que hayas configurado todo, abre tu navegador y visita la URL de tu sitio. Si es la primera vez, verás la pantalla de instalación de WordPress:

Selecciona tu idioma.
Introduce el nombre de tu sitio, nombre de usuario administrador, contraseña y correo electrónico.
Haz clic en "Install WordPress".

¡Felicidades! Tu sitio ya está conectado a la base de datos MySQL y funcionando.

Preguntas frecuentes (FAQ) sobre conectar WordPress a MySQL

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

Puedes cambiarla desde Syspanel (sección "MySQL Databases") o desde phpMyAdmin (en "Privileges"). Luego actualiza el archivo wp-config.php con la nueva contraseña.

2. ¿Puedo usar una base de datos remota?

Sí, pero debes cambiar DB_HOST por la dirección IP o nombre del servidor MySQL remoto. Algunos hostings bloquean conexiones externas, así que verifica con tu proveedor.

3. ¿Cómo sé si mi hosting usa `localhost` o un servidor diferente?

Revisa la documentación de tu hosting o contacta al soporte. En Syspanel, generalmente es localhost. Si usas un servicio como Amazon RDS, te darán un endpoint.

4. ¿Puedo cambiar el nombre de la base de datos después de instalar WordPress?

No es recomendable, ya que WordPress guarda el nombre en su configuración. Si lo haces, tendrías que editar wp-config.php y también migrar los datos con una herramienta como phpMyAdmin.

5. ¿Qué pasa si borro la base de datos por accidente?

Pierdes todo el contenido de tu web. Siempre haz copias de seguridad periódicas. Puedes usar plugins como UpdraftPlus o exportar desde phpMyAdmin.

6. ¿El puerto 2106 de Syspanel es obligatorio?

Sí, para acceder al panel de control de Syspanel debes usar el puerto 2106 (por ejemplo, https://tudominio.com:2106). Para la conexión a la base de datos, el puerto por defecto es el 3306 (MySQL), a menos que tu hosting lo haya cambiado.

Consejos finales para una configuración exitosa

Usa contraseñas fuertes: Tanto para la base de datos como para el usuario administrador de WordPress.
No edites el wp-config.php con editores de texto que añadan formato (como Word). Usa un editor de código plano.
Haz una copia de seguridad del wp-config.php antes de modificarlo.
Si tu sitio ya está funcionando, no olvides que cualquier cambio en wp-config.php puede afectar la conexión. Siempre prueba en un entorno de desarrollo si es posible.

Recuerda que configurar WordPress MySQL no es complicado si sigues los pasos al pie de la letra. La mayoría de los errores se deben a credenciales mal escritas o permisos insuficientes.

Si te surge alguna duda, vuelve a leer esta guía o contacta con el soporte de tu hosting. ¡Estoy aquí para ayudarte!

Resumen rápido:

Crea la base de datos y un usuario con todos los privilegios.
Edita wp-config.php con los datos de conexión.
Guarda y prueba tu web.
Si hay error, revisa credenciales y permisos.

¡Ahora ya sabes cómo conectar WordPress a una base de datos MySQL como un profesional!