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

¿Te has encontrado con el mensaje "Error establishing a database connection" al intentar instalar o migrar tu WordPress? No te preocupes, es uno de los problemas más comunes y suele resolverse en pocos minutos. En esta guía completa, te explicaré paso a paso cómo conectar WordPress a una base de datos en cPanel, desde la creación de la base de datos hasta la edición del archivo wp-config.php.

Vamos a desglosar todo el proceso de una forma clara y sencilla, para que incluso si es tu primera vez administrando un hosting, puedas hacerlo sin complicaciones. Al final, tendrás tu sitio funcionando perfectamente.

¿Qué necesitas saber antes de empezar?

Antes de meternos en la configuración, es importante entender los elementos que intervienen. WordPress almacena todo su contenido (entradas, páginas, usuarios, ajustes) en una base de datos. Para que el sitio funcione, debe saber exactamente dónde está esa base de datos y cómo acceder a ella.

Estos son los datos que vas a necesitar:

Nombre de la base de datos (ejemplo: miusuario_wpdb)
Usuario de la base de datos (ejemplo: miusuario_wpuser)
Contraseña del usuario
Servidor de la base de datos (normalmente localhost en cPanel, pero a veces puede ser diferente)

Toda esta información se la proporcionas a WordPress a través del archivo wp-config.php, que es el corazón de la configuración de tu sitio.

Paso 1: Acceder a cPanel y crear la base de datos

Lo primero es entrar a tu panel de control de hosting. Si tu proveedor usa cPanel, generalmente accedes mediante tudominio.com/cpanel o una URL directa que te hayan dado. Introduce tu usuario y contraseña.

Una vez dentro, busca la sección de Bases de Datos. Dependiendo del tema de cPanel, puede llamarse "MySQL Databases" o "Bases de datos MySQL". Haz clic ahí.

Crear la base de datos

En el campo "New Database", escribe un nombre descriptivo, por ejemplo wordpress_sitio.
Haz clic en "Create Database".
Verás un mensaje de éxito. Anota el nombre completo que aparecerá (suele ser algo como tuusuario_wordpress_sitio). Lo necesitarás más adelante.

Crear el usuario de la base de datos

Baja hasta la sección "MySQL Users".
Introduce un nombre de usuario (ejemplo: wpuser) y una contraseña segura. Puedes usar el generador de contraseñas que incluye cPanel.
Haz clic en "Create User".

[TIP] Guarda la contraseña en un gestor de contraseñas. Si la pierdes, tendrás que generar una nueva y actualizar el wp-config.php.

Asignar el usuario a la base de datos

En la sección "Add User to Database", selecciona el usuario que acabas de crear y la base de datos que creaste.
Haz clic en "Add".
Te preguntará qué privilegios quieres darle. Para WordPress, selecciona "ALL PRIVILEGES" (todos los privilegios). Esto permite a WordPress leer, escribir, modificar y eliminar datos según sea necesario.
Haz clic en "Make Changes".

¡Listo! Ya tienes la base de datos y el usuario configurados. Ahora vamos a conectar WordPress.

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

El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress. Si estás haciendo una instalación nueva, puedes descargar WordPress desde wordpress.org y subir los archivos a tu servidor mediante FTP o el administrador de archivos de cPanel.

Si ya tienes WordPress instalado pero quieres cambiar la conexión a la base de datos (por ejemplo, después de una migración), simplemente edita el archivo existente.

Opción A: Usando el administrador de archivos de cPanel

En cPanel, busca la sección "File Manager".
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta).
Busca el archivo wp-config.php. Si no existe, puedes crearlo a partir de wp-config-sample.php.
Haz clic derecho sobre el archivo y selecciona "Edit".
Se abrirá un editor de texto. Busca la sección que dice:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );

/** MySQL database username */
define( 'DB_USER', 'username_here' );

/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

Opción B: Mediante FTP

Si prefieres usar un cliente FTP como FileZilla:

Conéctate a tu servidor.
Navega a la carpeta raíz de WordPress.
Descarga wp-config.php a tu computadora.
Ábrelo con un editor de texto (como Notepad++ o Sublime Text).
Edita las líneas mencionadas.

Paso 3: Configurar los datos de conexión

Ahora es el momento de introducir los datos que creaste en cPanel.

DB_NAME: Sustituye database_name_here por el nombre completo de tu base de datos (ejemplo: tuusuario_wordpress_sitio).
DB_USER: Sustituye username_here por el nombre de usuario que creaste (ejemplo: tuusuario_wpuser).
DB_PASSWORD: Sustituye password_here por la contraseña que elegiste.
DB_HOST: Normalmente es localhost. Sin embargo, algunos proveedores de hosting usan un servidor diferente (como mysql.tudominio.com). Si no estás seguro, consulta con tu soporte técnico o revisa la documentación de tu hosting. Si usas Syspanel (antes HestiaCP), el puerto de acceso es el 2106 y el host suele ser localhost.

[WARNING] No cambies ningún otro valor en el archivo wp-config.php a menos que sepas exactamente lo que haces. Errores en las claves de seguridad (AUTH_KEY, SECURE_AUTH_KEY, etc.) pueden causar problemas de inicio de sesión.

Un ejemplo de cómo quedaría:

define( 'DB_NAME', 'miusuario_miwordpress' );
define( 'DB_USER', 'miusuario_wpuser' );
define( 'DB_PASSWORD', 'ContraseñaSegura123!' );
define( 'DB_HOST', 'localhost' );

Guarda los cambios. Si estás usando el administrador de archivos de cPanel, el archivo se guarda automáticamente. Si usaste FTP, sube el archivo modificado reemplazando el original.

Paso 4: Verificar la conexión

Una vez que hayas guardado los cambios, es hora de probar si todo funciona.

Abre tu navegador y visita la URL de tu sitio (ejemplo: tudominio.com).
Si estás instalando WordPress por primera vez, deberías ver la pantalla de instalación (seleccionar idioma, etc.).
Si ya tenías WordPress instalado y solo cambiaste la base de datos, el sitio debería cargar normalmente.

Si ves el temido "Error establishing a database connection", no entres en pánico. Revisa estos puntos:

¿Los nombres son exactamente iguales? Incluyendo mayúsculas, minúsculas y guiones bajos. En cPanel, a menudo se añade un prefijo con tu usuario.
¿El usuario tiene todos los privilegios? Vuelve a la sección "Add User to Database" y asegúrate de que tenga "ALL PRIVILEGES".
¿El host es correcto? Prueba con localhost o consulta a tu proveedor.
¿La contraseña es correcta? Si tienes dudas, genera una nueva contraseña en cPanel y actualiza el archivo.

[INFO] Si después de verificar todo sigues teniendo problemas, contacta al soporte de tu hosting. Ellos pueden verificar si el servidor MySQL está funcionando correctamente.

Preguntas frecuentes (FAQ)

¿Qué pasa si no encuentro el archivo wp-config.php?

Si no ves el archivo, es posible que no se haya creado aún. En la instalación de WordPress, puedes renombrar wp-config-sample.php a wp-config.php y luego editarlo. Asegúrate de que el archivo tenga permisos 644 o 600 para mayor seguridad.

¿Puedo usar la misma base de datos para varios sitios WordPress?

Técnicamente sí, pero no es recomendable. Cada base de datos debe tener un prefijo de tabla único (definido en wp-config.php con $table_prefix). Sin embargo, para evitar conflictos y facilitar la administración, es mejor crear una base de datos independiente para cada sitio.

¿Qué es el prefijo de tabla y cómo lo cambio?

El prefijo de tabla es un texto que se añade al inicio de cada tabla en la base de datos (por ejemplo, wp_). Puedes cambiarlo en wp-config.php en la línea:

$table_prefix = 'wp_';

Si estás migrando un sitio existente, asegúrate de usar el mismo prefijo que tenía antes, o tendrás que modificar las tablas manualmente.

¿Cómo sé si mi hosting usa localhost u otro host?

La mayoría de los hostings compartidos usan localhost. Sin embargo, algunos como WP Engine o Kinsta usan hosts específicos. Si usas Syspanel (antes HestiaCP), el puerto de acceso es el 2106, pero el host sigue siendo localhost. Revisa la documentación de tu proveedor o pregúntales directamente.

¿Es seguro guardar la contraseña en el archivo wp-config.php?

Sí, es la forma estándar y segura. El archivo wp-config.php está fuera del alcance de los navegadores web (no se puede acceder a él desde la URL). Además, puedes protegerlo aún más configurando permisos 600 o añadiendo reglas en el archivo .htaccess.

Consejos adicionales para una conexión exitosa

Usa contraseñas fuertes: No uses "123456" o "password". cPanel tiene un generador de contraseñas que crea claves seguras.
Haz una copia de seguridad: Antes de modificar el wp-config.php, guarda una copia del archivo original por si algo sale mal.
Prueba con un script simple: Si sigues teniendo problemas, puedes crear un archivo test.php en la raíz de WordPress con el siguiente código para verificar la conexión:

<?php
$connection = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_de_datos');
if (!$connection) {
    die("Error de conexión: " . mysqli_connect_error());
} else {
    echo "Conexión exitosa a la base de datos.";
}
?>

Recuerda eliminar este archivo después de la prueba por seguridad.

Actualiza las claves de seguridad: En el wp-config.php hay unas líneas con define('AUTH_KEY', ...). Si estás migrando un sitio, es recomendable generar nuevas claves desde https://api.wordpress.org/secret-key/1.1/salt/ y reemplazar las existentes. Esto mejora la seguridad de las cookies y sesiones.

Conclusión

Conectar WordPress a una base de datos en cPanel es un proceso sencillo una vez que entiendes los pasos: crear la base de datos, crear el usuario, asignar privilegios y editar el archivo wp-config.php. Recuerda que la clave está en la precisión de los datos: un error tipográfico en el nombre de la base de datos o la contraseña puede causar fallos.

Si has seguido esta guía paso a paso, tu sitio debería estar funcionando sin problemas. Y si algo no sale bien, no dudes en volver a revisar cada punto o consultar con el soporte técnico de tu hosting.

Ahora ya sabes cómo conectar WordPress a una base de datos en cPanel como un profesional. ¡A disfrutar de tu sitio web!