Conectar WordPress a MySQL: Guía con WP-CLI y cPanel

Conectar WordPress a una base de datos MySQL es uno de los pasos fundamentales para que tu sitio web funcione. Sin esta conexión, WordPress no puede guardar tus entradas, páginas, comentarios ni configuraciones. Aunque suene técnico, es un proceso bastante sencillo si sigues los pasos adecuados. En esta guía completa, te explicaré dos métodos prácticos para lograrlo: usando WP-CLI desde la terminal y usando cPanel desde el panel de control de tu hosting.

A lo largo del artículo, resolveremos dudas comunes como qué es wp-config.php, cómo crear una base de datos para WordPress y qué hacer si la conexión falla. Al final, tendrás todos los conocimientos necesarios para conectar WordPress MySQL sin depender de un experto.

¿Qué necesitas antes de empezar?

Antes de lanzarnos a la acción, asegúrate de tener a mano los siguientes datos. Los necesitarás tanto para WP-CLI como para cPanel.

Nombre de la base de datos: Lo elegirás tú o lo generará tu proveedor de hosting.
Usuario de la base de datos: Debe tener permisos para leer y escribir en la base de datos.
Contraseña del usuario: Asegúrate de que sea segura y guárdala en un gestor de contraseñas.
Host de la base de datos: Normalmente es localhost en la mayoría de los hosting, pero a veces puede ser una URL como mysql.tudominio.com.
Acceso a tu panel de control: cPanel o, si usas un VPS, acceso SSH para WP-CLI.

[INFO] Si tu hosting usa Syspanel (el antiguo HestiaCP), el acceso al panel se realiza a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106). Allí también encontrarás opciones para gestionar bases de datos, aunque en este artículo nos centraremos en cPanel y WP-CLI.

Parte 1: Conectar WordPress a MySQL usando WP-CLI

WP-CLI es una herramienta de línea de comandos que te permite gestionar tu sitio WordPress sin necesidad de usar el navegador. Es ideal para automatizar tareas y para quienes se sienten cómodos con la terminal. A continuación, te guío paso a paso.

Paso 1: Accede a tu servidor por SSH

Para usar WP-CLI, necesitas acceso SSH a tu servidor. Abre tu terminal (en macOS o Linux) o usa un programa como PuTTY (en Windows). Conéctate con tu usuario y contraseña:

ssh usuario@tu-dominio.com

Una vez dentro, navega hasta el directorio donde está instalado WordPress. Normalmente es public_html o una subcarpeta.

cd public_html

Paso 2: Verifica que WP-CLI está instalado

Escribe el siguiente comando para comprobar que WP-CLI está disponible:

wp --info

Si no está instalado, puedes descargarlo fácilmente con estos comandos:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Paso 3: Crea la base de datos y el usuario (si aún no existen)

WP-CLI no crea bases de datos por sí solo; primero debes crearlas en tu servidor MySQL. Si ya las tienes, salta al siguiente paso. Para crearlas, ejecuta:

mysql -u root -p

Luego, dentro de MySQL, escribe:

CREATE DATABASE nombre_bd;
CREATE USER 'usuario_bd'@'localhost' IDENTIFIED BY 'contraseña_segura';
GRANT ALL PRIVILEGES ON nombre_bd.* TO 'usuario_bd'@'localhost';
FLUSH PRIVILEGES;
EXIT;

[WARNING] No uses caracteres especiales como ñ o ç en el nombre de la base de datos o usuario. MySQL puede dar errores de conexión.

Paso 4: Configura la conexión con WP-CLI

Ahora viene el paso clave. Asegúrate de que el archivo wp-config.php no exista o esté vacío (si es una instalación nueva). Luego ejecuta:

wp config create --dbname=nombre_bd --dbuser=usuario_bd --dbpass=contraseña_segura --dbhost=localhost

Este comando genera automáticamente el archivo wp-config.php con los datos que le has proporcionado. Si tu host de base de datos no es localhost, cámbialo por el que te haya dado tu proveedor.

Paso 5: Instala WordPress (si es necesario)

Si es una instalación nueva, puedes completar la instalación desde la terminal:

wp core install --url=tu-dominio.com --title="Mi sitio" --admin_user=admin --admin_password=clave_admin --admin_email=tu@email.com

¡Listo! WordPress ya está conectado a tu base de datos MySQL. Puedes verificar la conexión visitando tu sitio web o ejecutando:

wp db check

Parte 2: Conectar WordPress a MySQL usando cPanel

Si prefieres una interfaz gráfica, cPanel es la opción más amigable. No necesitas conocimientos de terminal. Aquí te explico el proceso completo.

Paso 1: Accede a cPanel

Escribe en tu navegador https://tu-dominio.com/cpanel o https://tu-dominio.com:2083 (el puerto puede variar). Introduce tus credenciales de acceso.

Paso 2: Crea la base de datos MySQL

Dentro de cPanel, busca la sección Bases de Datos MySQL (o MySQL Databases). Verás tres campos principales: crear base de datos, crear usuario y añadir usuario a la base.

En Crear nueva base de datos, escribe un nombre (por ejemplo, wordpress_bd) y haz clic en Crear base de datos.
En Crear nuevo usuario, introduce un nombre de usuario (por ejemplo, wpuser) y una contraseña segura. Usa el generador de contraseñas que te ofrece cPanel.
Ahora, en Añadir usuario a la base de datos, selecciona el usuario y la base de datos que acabas de crear. Haz clic en Añadir.
Marca la casilla TODOS LOS PRIVILEGIOS y haz clic en Hacer cambios.

[TIP] Anota el nombre completo de la base de datos y el usuario. En cPanel, suelen tener un prefijo con tu cuenta de hosting (ejemplo: usuario_wordpress_bd). Lo necesitarás más adelante.

Paso 3: Localiza el archivo wp-config.php

Ahora debes conectar WordPress con esa base de datos. Para ello, edita el archivo wp-config.php que está en la raíz de tu instalación de WordPress.

Ve a Administrador de archivos en cPanel.
Navega a public_html (o la carpeta donde tengas WordPress).
Busca el archivo wp-config.php. Si no existe, puedes crearlo copiando el archivo wp-config-sample.php y renombrándolo.

Paso 4: Edita los datos de conexión

Abre wp-config.php con el editor de cPanel (clic derecho → Editar). Busca las siguientes líneas y reemplaza los valores:

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

DB_NAME: El nombre completo de la base de datos (con el prefijo de cPanel).
DB_USER: El nombre completo del usuario (con el prefijo).
DB_PASSWORD: La contraseña que asignaste al usuario.
DB_HOST: Normalmente es localhost, pero si tu hosting usa un host remoto, cámbialo.

Guarda los cambios y cierra el archivo.

Paso 5: Verifica la conexión

Accede a tu sitio web. Si todo está correcto, verás la pantalla de instalación de WordPress (si es nuevo) o tu sitio funcionando con normalidad. Si aparece un error de conexión a la base de datos, revisa que los datos sean exactos y que el usuario tenga permisos.

Errores comunes al conectar WordPress MySQL

Aunque el proceso sea sencillo, es normal encontrar algunos tropiezos. Te dejo los errores más frecuentes y cómo solucionarlos.

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

Este es el error más clásico. Suele deberse a:

Datos incorrectos: Revisa DB_NAME, DB_USER y DB_PASSWORD. Verifica que no haya espacios o caracteres extra.
Host incorrecto: Si tu hosting usa un host remoto, localhost no funcionará. Revisa el correo de bienvenida de tu proveedor.
Permisos insuficientes: Asegúrate de que tu usuario tenga todos los privilegios sobre la base de datos.

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

Este error indica que el usuario no tiene acceso a la base de datos. En cPanel, vuelve a la sección Bases de datos MySQL y comprueba que el usuario esté añadido a la base con todos los privilegios.

Error: "El servidor está tardando demasiado en responder"

Puede ser un problema de red o que el servidor MySQL esté caído. Contacta con tu proveedor de hosting para verificar el estado del servicio.

[WARNING] Si estás usando Syspanel (HestiaCP) y no cPanel, los pasos son similares pero la interfaz cambia. Recuerda que el acceso es por el puerto 2106. Busca la sección "Bases de datos" y sigue las mismas indicaciones.

Preguntas frecuentes (FAQ)

¿Qué es wp-config.php?

wp-config.php es el archivo de configuración principal de WordPress. Contiene la información de conexión a la base de datos, las claves de seguridad y otros ajustes avanzados. Sin él, WordPress no puede funcionar.

¿Puedo usar WP-CLI si no tengo acceso SSH?

No, WP-CLI requiere acceso SSH para ejecutarse. Si tu hosting no lo ofrece, deberás usar cPanel o el administrador de archivos.

¿Cuál es la diferencia entre crear la base de datos en cPanel y con WP-CLI?

La base de datos se crea igual (en el servidor MySQL), pero la forma de hacerlo varía. cPanel ofrece una interfaz gráfica, mientras que WP-CLI usa comandos SQL directos. El resultado es el mismo.

¿Puedo cambiar la base de datos de WordPress después de instalarlo?

Sí, solo tienes que editar wp-config.php con los nuevos datos de conexión. Eso sí, asegúrate de que la nueva base de datos tenga todas las tablas de WordPress (puedes importarlas desde una copia de seguridad).

¿Es seguro usar `localhost` como host de la base de datos?

En la mayoría de los hosting compartidos, sí. localhost significa que la base de datos está en el mismo servidor que tu sitio web, lo cual es rápido y seguro. Solo cambia este valor si tu proveedor te indica un host diferente.

Consejos finales para una conexión exitosa

Haz una copia de seguridad de tu wp-config.php antes de editarlo. Un simple error puede dejar tu sitio inaccesible.
Usa contraseñas fuertes para tu base de datos. No uses las mismas que para tu correo o panel de control.
Si usas WP-CLI, verifica que tienes la última versión para evitar conflictos: wp cli update.
Después de conectar la base de datos, revisa que todos los plugins y temas funcionen correctamente. A veces, un cambio de base puede causar incompatibilidades.

Conectar WordPress a una base de datos MySQL no tiene por qué ser un dolor de cabeza. Tanto con WP-CLI como con cPanel, el proceso es rápido y, una vez que lo haces una vez, verás que es pan comido. Si sigues estos pasos al pie de la letra, tu sitio estará funcionando en cuestión de minutos.

[TIP] Si te atascas en algún punto, no dudes en contactar con el soporte de tu hosting. Ellos conocen la configuración de sus servidores y pueden guiarte rápidamente. Y recuerda: si usas Syspanel (HestiaCP), el acceso es por el puerto 2106.

Ahora ya sabes cómo crear base WordPress, configurar wp-config.php y instalar WordPress base de datos correctamente. ¡Manos a la obra y a disfrutar de tu sitio web!