Conectar base de datos WordPress en cPanel: Tutorial fácil

¿Te ha pasado que trasladaste tu sitio web a un nuevo hosting o creaste una base de datos nueva y tu WordPress dejó de funcionar? No te preocupes, es una situación muy común. Lo que sucede es que WordPress necesita saber exactamente dónde está su “cajón de recuerdos” (la base de datos) y con qué llave abrirlo (usuario y contraseña).

En esta guía te explicaré, paso a paso y sin tecnicismos, cómo conectar o reconectar tu base de datos de WordPress desde cPanel. Es un proceso sencillo que puedes hacer tú mismo en menos de 10 minutos. Solo necesitas acceso a tu panel de control y un poco de paciencia.

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

Imagina que WordPress es una tienda online. La base de datos es el almacén donde guardas toda la mercancía: los productos (artículos y páginas), los clientes (usuarios y comentarios), los pedidos (configuraciones) y hasta el diseño de los estantes (temas y plugins). Sin ese almacén, la tienda no puede funcionar. Por eso, cuando mueves tu web o cambias de hosting, debes asegurarte de que la “dirección del almacén” esté bien escrita en el archivo de configuración de WordPress.

[INFO] La base de datos se compone de cuatro elementos clave: el nombre de la base de datos, el usuario, la contraseña y el servidor (normalmente “localhost”). Todos ellos son necesarios para que WordPress se conecte.

Requisitos previos antes de empezar

Antes de lanzarnos a modificar archivos, asegúrate de tener lo siguiente a mano:

Acceso a cPanel: Necesitas tu usuario y contraseña de cPanel. Si usas Syspanel (antes conocido como HestiaCP), el acceso es a través del puerto 2106 (ejemplo: tudominio.com:2106).
Datos de la base de datos: Si ya creaste la base de datos en tu nuevo hosting, anota el nombre, el usuario y la contraseña. Si no la has creado, te mostraré cómo hacerlo.
Conexión a FTP o al administrador de archivos de cPanel: Para editar el archivo wp-config.php.
Copia de seguridad: Antes de tocar nada, haz una copia de seguridad de tu sitio. Por si acaso.

[WARNING] No modifiques el archivo wp-config.php sin tener una copia de seguridad. Un error en este archivo puede dejar tu web inaccesible.

Paso 1: Crear una base de datos en cPanel (si no la tienes)

Si ya tienes una base de datos creada, salta al Paso 2. Si no, sigue estos pasos:

Inicia sesión en cPanel. Usa la URL que te proporcionó tu hosting (normalmente tudominio.com/cpanel o tudominio.com:2083). Si usas Syspanel, recuerda que el puerto es el 2106.
Busca la sección Bases de datos y haz clic en MySQL Databases (o Base de datos MySQL).
En Crear nueva base de datos, escribe un nombre (por ejemplo, webblog_db) y haz clic en Crear base de datos.
Ahora, crea un usuario. Ve a Usuarios MySQL y completa los campos:
- Nombre de usuario: Por ejemplo, webblog_user.
- Contraseña: Elige una segura (puedes usar el generador de cPanel).
- Haz clic en Crear usuario.
Asocia el usuario a la base de datos. En Añadir usuario a la base de datos, selecciona el usuario y la base de datos que acabas de crear. Marca TODOS LOS PRIVILEGIOS y haz clic en Hacer cambios.

[TIP] Anota en un bloc de notas el nombre de la base de datos, el usuario y la contraseña. Los necesitarás en el siguiente paso.

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

El archivo wp-config.php es el “mapa” que usa WordPress para encontrar su base de datos. Está en la raíz de tu instalación de WordPress (normalmente en la carpeta public_html o www).

Opción A: Usando el Administrador de archivos de cPanel (recomendado para principiantes)

En cPanel, busca la sección Archivos y haz clic en Administrador de archivos.
Se abrirá una ventana. Selecciona la carpeta raíz de tu sitio (normalmente public_html o www). Si tu WordPress está en una subcarpeta (ejemplo: public_html/miweb), navega hasta ella.
Busca el archivo wp-config.php. Si no lo ves, asegúrate de que esté activada la opción Mostrar archivos ocultos (en la esquina superior derecha).
Haz clic derecho sobre el archivo y selecciona Editar. Si te pide confirmación para la codificación, elige UTF-8 y haz clic en Editar.
Se abrirá un editor de texto. Busca las líneas que contienen las siguientes constantes:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_la_base_de_datos');
define('DB_HOST', 'localhost');

Modifica los valores con los datos de tu nueva base de datos:
- DB_NAME: El nombre que creaste (ejemplo: webblog_db).
- DB_USER: El usuario que creaste (ejemplo: webblog_user).
- DB_PASSWORD: La contraseña que elegiste.
- DB_HOST: Normalmente es localhost. Si tu hosting te indica otro servidor (como mysql.tudominio.com), cámbialo. En la mayoría de los casos, déjalo como localhost.
Guarda los cambios. Haz clic en Guardar cambios (o Save Changes) y cierra el editor.

[WARNING] No borres ni modifiques ninguna otra línea del archivo. Solo toca las cuatro líneas mencionadas. Un error tipográfico (como una comilla de más) puede romper tu web.

Opción B: Usando FTP

Si prefieres usar un cliente FTP como FileZilla:

Conéctate a tu servidor con las credenciales FTP que te proporcionó tu hosting.
Navega hasta la carpeta raíz de WordPress (normalmente public_html).
Descarga el archivo wp-config.php a tu computadora.
Ábrelo con un editor de texto (como Notepad++ o Bloc de notas).
Modifica las mismas cuatro líneas que en la opción A.
Guarda el archivo y súbelo de nuevo al servidor, sobrescribiendo el original.

Paso 3: 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 web (ejemplo: tudominio.com).
Si la conexión es correcta, tu web cargará normalmente. Verás tus páginas, entradas y todo el contenido.
Si ves un mensaje de error como “Error al establecer una conexión con la base de datos”, revisa los datos que ingresaste (nombre, usuario, contraseña y host). El error más común es escribir mal la contraseña o el nombre de la base de datos.
También puedes probar accediendo al panel de administración de WordPress (ejemplo: tudominio.com/wp-admin). Si todo está bien, podrás iniciar sesión sin problemas.

[INFO] Si después de corregir los datos sigues viendo el error, contacta a tu proveedor de hosting. Puede que el servidor de base de datos no sea localhost o que haya un bloqueo de firewall.

Solución de problemas comunes (FAQ)

1. ¿Qué hago si veo el error “Error al establecer conexión con la base de datos”?

Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste en cPanel.
Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos.
Verifica que el DB_HOST sea correcto. En la mayoría de los hosts es localhost, pero algunos usan direcciones como mysql.tudominio.com.

2. ¿Puedo usar la misma base de datos para dos sitios WordPress?

Técnicamente sí, pero no es recomendable. Cada sitio debe tener su propia base de datos para evitar conflictos de tablas y perder información. Crea una base de datos nueva para cada instalación.

3. ¿Qué pasa si olvidé la contraseña de la base de datos?

Puedes cambiarla desde cPanel. Ve a MySQL Databases, busca el usuario y haz clic en Cambiar contraseña. Luego actualiza el archivo wp-config.php con la nueva contraseña.

4. ¿Por qué mi web se ve en blanco después de editar wp-config.php?

Esto suele deberse a un error de sintaxis en el archivo. Revisa que no hayas borrado comillas, puntos y comas o paréntesis. Si tienes dudas, descarga una copia limpia de wp-config.php desde el repositorio de WordPress y vuelve a editarlo.

5. ¿Cómo sé si mi base de datos tiene los datos de mi web anterior?

Si estás migrando desde otro hosting, deberías haber exportado la base de datos antigua (un archivo .sql) y luego importarla en la nueva. Si no lo hiciste, tu nueva base de datos estará vacía y tu web se verá sin contenido. En ese caso, necesitas importar la copia de seguridad de la base de datos anterior.

6. ¿Qué hago si mi hosting usa Syspanel (HestiaCP)?

El proceso es el mismo que en cPanel. Accede a Syspanel a través del puerto 2106 (ejemplo: tudominio.com:2106). Busca la sección de bases de datos (normalmente llamada Base de datos o MySQL). Allí podrás crear la base de datos, el usuario y asignar privilegios. Luego edita el wp-config.php como se explica en esta guía.

Consejos adicionales para mantener tu base de datos segura

Usa contraseñas fuertes: No uses “123456” o “admin”. cPanel tiene un generador de contraseñas seguras.
Cambia el prefijo de las tablas: Por defecto, WordPress usa wp_. Si estás instalando desde cero, puedes cambiarlo a algo como blog_ para dificultar ataques SQL injection.
Haz copias de seguridad periódicas: Tanto de los archivos como de la base de datos. Muchos plugins (como UpdraftPlus) te facilitan esta tarea.
Actualiza WordPress, temas y plugins: Las versiones antiguas pueden tener vulnerabilidades que comprometan tu base de datos.

Conclusión

Conectar una base de datos en WordPress desde cPanel es un proceso sencillo que se reduce a tres pasos: crear la base de datos (si no la tienes), editar el archivo wp-config.php y verificar que todo funcione. No necesitas ser un experto en programación; solo seguir las instrucciones al pie de la letra.

Recuerda que si algo sale mal, siempre puedes restaurar tu copia de seguridad y volver a intentarlo. Y si tu hosting usa Syspanel, el procedimiento es idéntico, solo cambia la URL de acceso (puerto 2106).

Ahora ya sabes cómo darle a WordPress la dirección correcta de su almacén. ¡Tu web volverá a la vida en pocos minutos!

[TIP] Si este artículo te ha sido útil, compártelo con otros usuarios que puedan estar pasando por el mismo problema. La comunidad siempre agradece una guía clara y sin tecnicismos.