Conectar WordPress a MySQL en cPanel: Guía rápida y fácil

¿Tu página web en WordPress te pide a gritos una conexión a base de datos y no sabes por dónde empezar? No te preocupes, es una tarea mucho más sencilla de lo que parece si sigues los pasos adecuados. En esta guía rápida y visual, te explicaré cómo conectar WordPress a una base de datos MySQL en cPanel, desde la creación de la base de datos hasta la edición del archivo wp-config.php.

Vamos a desglosar el proceso en pasos muy claros, pensados para que cualquier persona, aunque no tenga experiencia técnica, pueda hacerlo sin frustrarse. Al final, también resolveremos los errores de conexión más comunes que suelen aparecer.

Antes de empezar: ¿Qué necesitas?

Para conectar WordPress a MySQL en cPanel, necesitarás tener a mano los siguientes datos. Te recomiendo tenerlos en un bloc de notas mientras realizas el proceso:

Nombre de usuario y contraseña de tu cPanel: Son las credenciales que usas para entrar a tu panel de control de hosting.
Acceso a la sección "Bases de datos MySQL": Dentro de cPanel, busca el icono que dice "Bases de datos MySQL" o "MySQL Databases".
Tu dominio y la ruta de instalación de WordPress: Saber si lo instalaste en la raíz (public_html) o en una subcarpeta.

[INFO] Si tu hosting utiliza "Syspanel" (antes conocido como HestiaCP), el proceso es muy similar, pero el acceso al panel se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). El resto de la lógica de creación de bases de datos es casi idéntica.

Paso 1: Crear una base de datos MySQL en cPanel

Lo primero es crear el "lugar" donde WordPress guardará toda tu información: entradas, páginas, comentarios, usuarios y configuraciones. Sin esto, no hay nada que conectar.

Inicia sesión en tu cPanel con tu usuario y contraseña.
Busca la sección "Bases de Datos" y haz clic en "Bases de datos MySQL".
En el campo "Crear nueva base de datos", escribe un nombre descriptivo. Por ejemplo, wordpress_db o blog_datos. cPanel normalmente añadirá un prefijo con tu nombre de usuario, así que el nombre completo podría ser tuusuario_wordpress_db. Anota el nombre completo, lo necesitarás después.
Haz clic en el botón "Crear base de datos". Verás un mensaje de éxito en la parte superior.

[WARNING] No uses guiones medios (-) en el nombre de la base de datos, solo letras, números y guiones bajos (_). Los guiones pueden causar problemas de conexión en algunos servidores.

Paso 2: Crear un usuario de base de datos MySQL

Ahora necesitas una "identidad" para que WordPress se conecte a esa base de datos. No es seguro usar tu usuario principal de cPanel; es mejor crear uno específico.

En la misma página de "Bases de datos MySQL", baja hasta la sección "Crear usuario de MySQL".
Elige un nombre de usuario (ej. wp_user). Recuerda que también tendrá un prefijo.
Crea una contraseña segura. Usa el generador de contraseñas de cPanel si es posible, o una combinación de mayúsculas, minúsculas, números y símbolos. Anótala, es crucial.
Haz clic en "Crear usuario".

Paso 3: Añadir el usuario a la base de datos (y darle todos los privilegios)

Este es el paso clave donde se establece la relación entre la base de datos y el usuario. Sin esto, WordPress no podrá escribir o leer información.

En la misma página, busca la sección "Añadir usuario a la base de datos".
En el primer menú desplegable, selecciona el usuario que acabas de crear.
En el segundo menú desplegable, selecciona la base de datos que creaste en el Paso 1.
Haz clic en "Añadir".
Se abrirá una nueva página con una lista de privilegios (permisos). Para una instalación estándar de WordPress, lo más fácil y correcto es marcar la casilla "TODOS LOS PRIVILEGIOS" en la parte superior. Esto permite a WordPress crear tablas, insertar datos, actualizarlos, borrarlos, etc.
Haz clic en "Hacer cambios" o "Guardar".

[TIP] Si alguna vez necesitas cambiar la contraseña del usuario de la base de datos, puedes hacerlo desde la misma sección "Bases de datos MySQL" editando el usuario. Luego tendrás que actualizar el archivo wp-config.php.

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

Este archivo es el "corazón" de la configuración de WordPress. Contiene las instrucciones exactas para que WordPress sepa dónde y cómo conectarse a tu base de datos.

Accede a tu hosting por FTP o usa el Administrador de Archivos de cPanel. El Administrador de Archivos es más fácil para principiantes.
Navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html (si lo instalaste en la raíz) o una subcarpeta como public_html/miweb.
Busca el archivo llamado wp-config.php.
Haz clic derecho sobre él y selecciona "Editar". Si te pregunta cómo abrirlo, elige el editor de texto.
Busca la sección que dice "Configuración de la base de datos" o las líneas que empiezan con define('DB_NAME', define('DB_USER'...

Los 4 datos mágicos que debes cambiar

Ahora es el momento de usar los datos que anotaste antes.

// ** Configuración de la base de datos - Puedes obtenerla de tu proveedor de hosting ** //
define( 'DB_NAME', 'aqui_va_el_nombre_de_tu_base_de_datos' );

/** Usuario de la base de datos */
define( 'DB_USER', 'aqui_va_el_usuario' );

/** Contraseña de la base de datos */
define( 'DB_PASSWORD', 'aqui_va_la_contrasena' );

/** Host de la base de datos */
define( 'DB_HOST', 'localhost' );

Vamos a rellenarlos uno a uno:

DB_NAME: Sustituye aqui_va_el_nombre_de_tu_base_de_datos por el nombre completo que viste al crear la base de datos (ej. tuusuario_wordpress_db).
DB_USER: Sustituye aqui_va_el_usuario por el nombre de usuario completo que creaste (ej. tuusuario_wp_user).
DB_PASSWORD: Sustituye aqui_va_la_contrasena por la contraseña que elegiste para ese usuario.
DB_HOST: Este es un punto que confunde a muchos. En el 99% de los casos, este valor debe ser localhost. Sin embargo, algunos hosts (como WP Engine o Kinsta) usan un host específico. Si no estás seguro, deja localhost. Si después de todo no funciona, consulta la documentación de tu proveedor de hosting.

[WARNING] No toques ninguna otra línea del archivo wp-config.php que no sean las cuatro que hemos mencionado. Un error en una comilla o un punto y coma puede romper tu sitio web.

Guarda el archivo y ciérralo.

Paso 5: Probar la conexión

Este es el momento de la verdad. Ahora vamos a ver si todo lo que hemos hecho ha funcionado correctamente.

Abre tu navegador web y ve a la URL de tu sitio web. Por ejemplo, www.tudominio.com.
Si todo está bien, verás la pantalla de instalación de WordPress (si es una instalación nueva) o tu sitio web funcionando (si ya tenías contenido).
Si es una instalación nueva, sigue los pasos de instalación (elegir idioma, crear usuario admin, etc.).

¡Enhorabuena! Ya has conectado WordPress a tu base de datos MySQL.

Errores de conexión MySQL de WordPress: Solución de problemas (FAQ)

¿Has visto un error como "Error al establecer la conexión con la base de datos"? No entres en pánico. Es el problema más común al configurar WordPress. Aquí tienes las soluciones más efectivas.

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

Este error genérico suele significar que WordPress no puede "hablar" con MySQL. Las causas más frecuentes son:

Credenciales incorrectas: Vuelve a revisar el archivo wp-config.php. Asegúrate de que no haya espacios en blanco alrededor de los valores y que las comillas estén bien cerradas. Es la causa más habitual.
Host incorrecto: Aunque localhost funciona en la mayoría de los casos, algunos hosts usan un hostname específico como mysql.tudominio.com o db.example.com. Revisa el correo de bienvenida de tu hosting o su documentación.
El usuario no tiene permisos: Vuelve al Paso 3 y asegúrate de que has añadido el usuario a la base de datos y que marcaste "TODOS LOS PRIVILEGIOS".

Error 2: "La conexión a la base de datos falló: acceso denegado para el usuario..."

Este error es más específico y apunta a un problema con el nombre de usuario o la contraseña.

Revisa el prefijo: Asegúrate de haber incluido el prefijo que cPanel añade. No es wp_user, es tuusuario_wp_user.
Contraseña: A veces, al copiar y pegar la contraseña, se añaden espacios o se corta. Intenta escribirla manualmente en el archivo wp-config.php.

Error 3: "La base de datos no existe"

Este error es muy claro: WordPress no encuentra la base de datos que le has indicado.

Nombre incorrecto: Revisa el nombre en DB_NAME. Asegúrate de que coincida exactamente con el que ves en cPanel, incluyendo el prefijo.
Base de datos no creada: Verifica en cPanel que la base de datos existe en la lista de "Bases de datos MySQL".

Error 4: El sitio funciona, pero no puedo acceder al wp-admin

A veces la conexión se establece, pero aparece un error al intentar entrar al panel de administración.

Limpia la caché: Borra la caché de tu navegador y la de cualquier plugin de caché que tengas.
Revisa la URL: Ve a la tabla wp_options en phpMyAdmin y asegúrate de que las opciones siteurl y home apuntan a la URL correcta de tu sitio.

[TIP] Para acceder a phpMyAdmin desde cPanel, busca el icono "phpMyAdmin" en la sección "Bases de Datos". Ahí podrás ver todas tus bases de datos y hacer consultas SQL si es necesario.

Conclusión y buenas prácticas

Conectar WordPress a MySQL en cPanel es un proceso de 5 pasos: crear la base de datos, crear el usuario, asignar permisos, editar wp-config.php y probar. Es una habilidad fundamental para cualquier persona que gestione su propio sitio web.

Para finalizar, te dejo con algunos consejos de oro:

Haz una copia de seguridad de tu archivo wp-config.php antes de editarlo.
No uses el usuario root de la base de datos para WordPress. Siempre crea un usuario específico con permisos limitados.
Si tu sitio ya funciona, no cambies las credenciales a menos que sea estrictamente necesario, ya que podrías dejarlo fuera de línea.
Si estás en Syspanel, recuerda que el acceso al panel es a través del puerto 2106, pero la filosofía de gestión de bases de datos es la misma: crear la BD, crear el usuario, vincularlos y usar esos datos en wp-config.php.

Con esta guía, ya tienes el conocimiento para resolver los problemas de conexión más comunes. Si el error persiste, te recomiendo contactar con el soporte de tu hosting, ya que podría haber un problema de configuración en el servidor que solo ellos pueden solucionar. ¡Mucho ánimo y a seguir creciendo tu web!