Conectar WordPress a MySQL en cPanel: Solución a problemas de conexión

¿Tienes una base de datos MySQL ya creada en tu hosting con cPanel y necesitas que WordPress la use?

Este es un proceso muy común, sobre todo cuando migras una web desde otro servidor o cuando un desarrollador te ha entregado un backup de tu sitio.

La buena noticia es que no necesitas ser un experto en programación para hacerlo. Solo tienes que editar un archivo de configuración (el famoso wp-config.php) y asegurarte de que los datos de acceso sean correctos.

En esta guía te explicaré paso a paso cómo conectar WordPress a una base de datos MySQL existente en cPanel, cómo solucionar el temido error conexión base de datos wordpress y algunos consejos extra para que todo funcione a la primera.

¿Qué necesitas antes de empezar?

Antes de tocar nada, es fundamental que tengas a mano tres datos que son como las llaves de tu casa:

El nombre de la base de datos (suele tener un prefijo como usuario_nombrebd).
El nombre de usuario de la base de datos (también con prefijo, ej. usuario_wpuser).
La contraseña de ese usuario (¡ojo! no es la contraseña de cPanel, es la de la base de datos).
El host de la base de datos (normalmente es localhost, pero a veces puede ser 127.0.0.1 o un servidor remoto).

Si no tienes estos datos, entra en tu cPanel, busca la sección "Bases de datos MySQL" y allí podrás ver la lista de bases de datos y sus usuarios. Si no recuerdas la contraseña, puedes cambiarla ahí mismo (eso sí, si ya tienes WordPress instalado, tendrás que actualizar el archivo de configuración después).

Paso 1: Localiza tu archivo wp-config.php

Este es el archivo más importante de tu instalación de WordPress. Es el que contiene la configuración de conexión a la base de datos, claves secretas y otras opciones avanzadas.

Normalmente se encuentra en la raíz de tu sitio web. Para acceder a él tienes dos opciones:

Desde el Administrador de archivos de cPanel: Entra en cPanel > "Administrador de archivos" > public_html (o la carpeta donde esté instalado tu WordPress). Busca el archivo llamado wp-config.php.
Desde un cliente FTP (como FileZilla): Conéctate a tu servidor y navega hasta la carpeta raíz. Descarga el archivo wp-config.php a tu ordenador para editarlo con un editor de texto (recomiendo Notepad++ o Sublime Text).

[WARNING] No edites el archivo directamente desde el editor de cPanel sin una copia de seguridad. Si cometes un error, puedes dejar la web caída. Mejor descárgalo y edítalo localmente.

Paso 2: Edita los datos de conexión

Abre el archivo wp-config.php y busca un bloque de código que se parece a este:

// ** Configuraciones de MySQL - Puedes obtener esta información desde tu servidor ** //
/** Nombre de la base de datos de WordPress */
define('DB_NAME', 'nombre_base_datos');

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

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

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

Ahora, simplemente reemplaza los valores entre comillas por los datos que tienes de tu base de datos MySQL existente en cPanel.

DB_NAME: Pon el nombre exacto de tu base de datos.
DB_USER: Pon el usuario exacto asociado a esa base de datos.
DB_PASSWORD: Pon la contraseña de ese usuario.
DB_HOST: Normalmente es localhost, pero si tu hosting usa un host remoto, cPanel te lo indicará en la sección de bases de datos (a veces es algo como mysql.tudominio.com).

Ejemplo real:

define('DB_NAME', 'miusuario_miweb');
define('DB_USER', 'miusuario_adminwp');
define('DB_PASSWORD', 'Clave#Segura2024');
define('DB_HOST', 'localhost');

Una vez editado, guarda el archivo y súbelo de vuelta a tu servidor (si lo habías descargado), sobrescribiendo el anterior.

Paso 3: Verifica el prefijo de las tablas (¡Importante!)

Si estás conectando WordPress a una base de datos que ya tenía tablas creadas (por ejemplo, de una instalación anterior o de un backup), debes asegurarte de que el prefijo de las tablas coincide.

En el mismo archivo wp-config.php, busca la línea que dice:

$table_prefix = 'wp_';

Si tu base de datos existente usa un prefijo diferente (por ejemplo, miweb_), tendrás que cambiarlo aquí. Si no lo haces, WordPress intentará crear tablas nuevas con el prefijo wp_ y no encontrará las tuyas, dando errores de "tabla no existe".

[TIP] Si no sabes qué prefijo usa tu base de datos, entra en phpMyAdmin desde cPanel, selecciona tu base de datos y mira el nombre de las tablas. El prefijo es la parte antes del primer guion bajo (ej. wp_options, wp_posts).

Solución de errores comunes al conectar

Aquí es donde la mayoría de la gente se frustra. No te preocupes, casi siempre es un problema de configuración simple. Vamos a ver los errores más típicos y cómo solucionarlos.

Error: "Error al establecer conexión con la base de datos" (Error establishing a database connection)

Este es el error más común. Significa que WordPress no puede conectarse a tu base de datos por alguna de estas razones:

Datos incorrectos en wp-config.php: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los mismos que aparecen en cPanel. Un espacio extra o un cambio de mayúsculas/minúsculas puede ser fatal.
El usuario no tiene permisos sobre la base de datos: En cPanel, ve a la sección "Bases de datos MySQL" y asegúrate de que tu usuario está añadido a la base de datos con TODOS LOS PRIVILEGIOS.
Host incorrecto: Aunque parezca raro, a veces el host no es localhost. Si tu hosting es de pago, revisa el correo de bienvenida o la documentación. Prueba con 127.0.0.1 si localhost falla.

Error: "No se puede seleccionar la base de datos" (Can’t select database)

Este error suele aparecer cuando el nombre de la base de datos en el archivo wp-config.php no existe o está mal escrito. Revisa que el nombre en el archivo coincida exactamente con el de cPanel.

Error: "Las tablas no existen" o "Tabla 'wp_options' no existe"

Este error indica que WordPress no encuentra las tablas dentro de tu base de datos. Las causas más comunes son:

El prefijo de las tablas en wp-config.php no coincide con el de las tablas reales (ya lo hemos visto arriba).
La base de datos está vacía y necesitas instalar WordPress desde cero (si es tu caso, visita tu dominio y sigue el asistente de instalación).
El backup que importaste no se completó correctamente. Revisa que en phpMyAdmin aparezcan las tablas.

Cómo conectar WordPress a una base de datos MySQL existente sin cPanel

Si por casualidad tu hosting no usa cPanel sino Syspanel (el panel de control al que se accede por el puerto 2106), el proceso es prácticamente idéntico, pero la interfaz cambia un poco.

En Syspanel, busca la sección de "Bases de datos" o "MySQL". Allí podrás crear la base de datos y el usuario, o ver los datos de una ya existente. El archivo wp-config.php se modifica exactamente igual que hemos descrito antes.

[INFO] Recuerda que en Syspanel, el acceso al panel de control se realiza a través del puerto 2106 (ej. https://tudominio.com:2106).

Consejos finales y buenas prácticas

Para terminar, aquí tienes algunos consejos que te ahorrarán dolores de cabeza:

Haz una copia de seguridad: Antes de tocar el wp-config.php, copia el contenido en un bloc de notas. Si algo sale mal, puedes restaurarlo fácilmente.
Usa una contraseña segura: No uses contraseñas como "admin123" o "password". Una buena contraseña para la base de datos es crucial para la seguridad de tu sitio.
No compartas el archivo wp-config.php: Contiene credenciales de acceso a tu base de datos. Nunca lo subas a repositorios públicos ni lo compartas por email.
Si migras a otro hosting: Recuerda que al mover una web, debes exportar la base de datos desde el hosting antiguo e importarla en el nuevo (desde cPanel o Syspanel). Después, solo tendrás que ajustar los datos en wp-config.php.

Preguntas frecuentes (FAQ)

¿Puedo cambiar el usuario de la base de datos después de haber conectado WordPress?

Sí. Deberás actualizar las líneas DB_USER y DB_PASSWORD en el archivo wp-config.php con los nuevos datos. Asegúrate de que el nuevo usuario tenga todos los privilegios sobre la base de datos.

¿Qué hago si no encuentro el archivo wp-config.php en mi servidor?

Si no lo ves, puede que tu instalación de WordPress esté en una subcarpeta o que el archivo esté oculto. Activa la opción de "Mostrar archivos ocultos" en el Administrador de archivos de cPanel. Si aún así no aparece, es posible que WordPress no esté instalado correctamente.

¿Por qué me sale "error conexión base de datos wordpress" en un sitio recién migrado?

Lo más probable es que los datos de la base de datos en el wp-config.php no correspondan con los del nuevo servidor. Verifica el nombre de la BD, el usuario, la contraseña y el host. También revisa que el prefijo de las tablas coincida.

¿Necesito crear una base de datos nueva o puedo usar una existente?

Puedes usar una existente, siempre y cuando no tenga datos que quieras conservar en otras aplicaciones. Si la base de datos ya tiene tablas de WordPress, asegúrate de que el prefijo coincida. Si no tiene nada, WordPress la usará sin problema.

¿Qué es exactamente el "DB_HOST"?

Es la dirección del servidor donde se aloja la base de datos. En el 99% de los casos en hosting compartido es localhost, ya que la base de datos está en el mismo servidor que tu web. En configuraciones más avanzadas (como Amazon RDS o servidores dedicados), puede ser una URL o IP.

En resumen, conectar WordPress a una base de datos MySQL existente en cPanel es un proceso mecánico de "copiar y pegar" los datos correctos en el archivo wp-config.php. Siguiendo estos pasos y prestando atención a los errores comunes, tendrás tu sitio web funcionando en cuestión de minutos. ¡No tengas miedo de intentarlo!