Conectar WordPress a Base de Datos MySQL | cPanel Tutorial

¿Qué significa conectar WordPress a una base de datos MySQL existente?

Cuando instalas WordPress, el sistema necesita un lugar donde guardar todas tus publicaciones, páginas, comentarios, usuarios y configuraciones. Ese lugar es una base de datos MySQL. Aunque la mayoría de instalaciones automáticas crean una base de datos nueva, a veces ya tienes una creada en cPanel (por ejemplo, una que usaste para otro proyecto o que viene incluida en tu plan de hosting) y quieres que WordPress la utilice.

Conectar WordPress a una base de datos MySQL existente no es complicado, pero requiere que toques un archivo llamado wp-config.php. Este archivo es el "puente" entre tu WordPress y la base de datos. En este artículo te explico, paso a paso y sin tecnicismos, cómo hacerlo correctamente, incluso si nunca has tocado un código en tu vida.

[INFO]
Si tu hosting usa Syspanel en lugar de cPanel, el proceso es muy similar. Solo cambia la interfaz, pero los conceptos de base de datos, usuario y archivo wp-config.php son exactamente los mismos. Recuerda que el acceso a Syspanel se realiza por el puerto 2106 (por ejemplo: https://tu-dominio.com:2106).

Antes de empezar: qué necesitas tener a mano

Para realizar la conexión de forma segura y sin errores, necesitas tres datos. Te recomiendo tenerlos escritos en un bloc de notas antes de continuar:

El nombre de la base de datos (suele tener un prefijo como usuario_basededatos).
El nombre de usuario de la base de datos (a menudo es el mismo que el prefijo, seguido de un nombre).
La contraseña de ese usuario (asegúrate de que sea la correcta, porque si la cambias después, WordPress dejará de funcionar).

Además, necesitas acceso a tu cPanel (o Syspanel) y a un administrador de archivos (puede ser el Administrador de archivos de cPanel, o un cliente FTP como FileZilla).

[WARNING]
Si ya tienes contenido en esa base de datos (por ejemplo, una web anterior), conectarla a un WordPress nuevo podría sobrescribir o mezclar datos. Si no estás seguro de su contenido, haz una copia de seguridad antes de empezar. En cPanel puedes usar la herramienta "Backup" o "Copias de seguridad".

Paso 1: Localizar o crear la base de datos en cPanel

Si la base de datos ya existe, no necesitas crearla, solo verificar su nombre exacto. Pero si no la tienes, aquí te digo cómo crearla.

1.1. Si ya existe la base de datos

Entra a tu cPanel (generalmente en tu-dominio.com/cpanel).
Busca la sección Bases de Datos MySQL (o "MySQL Databases").
Verás una lista con todas las bases de datos. Anota el nombre exacto de la que quieres usar.
En esa misma pantalla, asegúrate de que el usuario que vas a usar esté asignado a esa base de datos con TODOS LOS PRIVILEGIOS. Si no lo está, añádelo en la sección "Añadir usuario a base de datos" y marca todas las casillas de privilegios.

1.2. Si necesitas crearla nueva (pero quieres mantener el nombre)

Aunque el título dice "existente", a veces la base de datos existe pero no tiene usuario asignado. En ese caso:

Ve a Bases de Datos MySQL.
En "Crear nueva base de datos", escribe el nombre que quieras y pulsa "Crear".
Más abajo, en "Crear usuario de base de datos", escribe un nombre de usuario y una contraseña segura.
Finalmente, en "Añadir usuario a base de datos", selecciona tu base de datos y tu usuario, y asígnale TODOS LOS PRIVILEGIOS.

[TIP]
Las contraseñas seguras son fundamentales. En cPanel puedes usar el generador de contraseñas (el icono del dado) para crear una aleatoria. No la pierdas, la necesitarás en el paso 3.

Paso 2: Acceder al archivo wp-config.php

El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress. Si instalaste WordPress en la carpeta principal de tu dominio (como public_html), el archivo estará ahí. Si lo instalaste en una subcarpeta (por ejemplo, public_html/blog), ahí lo encontrarás.

Para editarlo, tienes dos opciones:

Opción A: Desde el Administrador de Archivos de cPanel (recomendada para principiantes)

En cPanel, busca la sección Archivos y haz clic en Administrador de Archivos.
Navega hasta la carpeta donde tienes WordPress (normalmente public_html).
Busca el archivo wp-config.php. Haz clic derecho sobre él y elige Editar (o "Edit").
Se abrirá un editor de texto. No te asustes por el contenido, solo vamos a tocar una parte específica.

Opción B: Desde un cliente FTP

Conéctate a tu servidor usando FileZilla o similar.
Navega hasta la carpeta de WordPress.
Descarga el archivo wp-config.php a tu ordenador.
Ábrelo con cualquier editor de texto (Bloc de notas, Sublime Text, etc.).

[INFO]
Si no encuentras wp-config.php, puede que esté oculto. En el Administrador de Archivos de cPanel, haz clic en "Configuración" (arriba a la derecha) y marca la casilla "Mostrar archivos ocultos (dotfiles)". En FTP, asegúrate de tener activada la opción de ver archivos ocultos.

Paso 3: Editar los datos de conexión en wp-config.php

Este es el corazón del asunto. Dentro del archivo wp-config.php, busca las líneas que se parecen a esto:

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

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

/** MySQL database password */
define( 'DB_PASSWORD', 'tu_contraseña' );

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

Ahora, reemplaza los valores entre comillas con los datos que anotaste en el paso 1:

DB_NAME: Pon el nombre exacto de la base de datos (ej: midominio_wpdb).
DB_USER: Pon el nombre de usuario (ej: midominio_wpuser).
DB_PASSWORD: Pon la contraseña de ese usuario.
DB_HOST: Este es un punto crítico. En el 90% de los casos, es localhost. Pero si tu hosting usa servidores de bases de datos externos, puede ser algo como mysql.tudominio.com o localhost:/tmp/mysql5.sock. Si no estás seguro, déjalo como localhost. Si falla, contacta con tu proveedor.

[WARNING]
No cambies nada más en el archivo. No toques las líneas que dicen $table_prefix ni las constantes de seguridad (AUTH_KEY, etc.) a menos que sepas lo que haces. Un error aquí puede romper tu web.

Ejemplo práctico

Imagina que tu base de datos se llama web_pedro_bd, tu usuario es web_pedro_admin y la contraseña es Clave#Segura2024. El bloque debería quedar así:

define( 'DB_NAME', 'web_pedro_bd' );
define( 'DB_USER', 'web_pedro_admin' );
define( 'DB_PASSWORD', 'Clave#Segura2024' );
define( 'DB_HOST', 'localhost' );

Paso 4: Guardar los cambios y probar la conexión

Una vez que hayas editado los datos, guarda el archivo.

Si usaste el Administrador de Archivos, pulsa el botón "Guardar cambios" y luego "Cerrar".
Si usaste FTP, sube el archivo modificado a tu servidor, sobrescribiendo el original.

Ahora viene la prueba de fuego. Abre tu navegador y visita la URL de tu WordPress.

Si todo está bien: verás la pantalla de instalación de WordPress (si es nuevo) o tu web funcionando (si ya estaba instalado).
Si hay un error de conexión: verás un mensaje como "Error establishing a database connection" o "No se pudo conectar a la base de datos". No te preocupes, es el síntoma clásico de que algún dato está mal.

Solución de problemas comunes (FAQ)

Aquí te dejo las dudas más frecuentes que resolvemos en soporte técnico. Léelas con calma, seguro que alguna te ayuda.

¿Por qué me sale "Error establishing a database connection"?

Es el error más común. Las causas suelen ser:

El nombre de la base de datos o usuario está mal escrito. Revísalo letra por letra. A veces se confunde una 0 con una O, o una 1 con una l.
La contraseña es incorrecta. Cópiala directamente desde cPanel si es posible.
El usuario no tiene privilegios en la base de datos. Vuelve al paso 1 y asegúrate de que el usuario está asignado con TODOS los privilegios a la base de datos correcta.
El host de la base de datos no es localhost. Algunos hostings usan un host específico. Revisa el correo de bienvenida de tu hosting o el panel de control.

¿Puedo usar la misma base de datos para dos WordPress diferentes?

Técnicamente sí, pero es muy desaconsejable. Ambas instalaciones compartirán las mismas tablas, lo que significa que si una se actualiza, la otra puede romperse. Además, los datos se mezclarán y habrá conflictos de usuarios y contraseñas. Es como poner dos motores en un mismo coche: no funciona bien.

¿Qué pasa si cambio la contraseña de la base de datos en cPanel?

WordPress dejará de funcionar al instante. La conexión se rompe porque el archivo wp-config.php sigue teniendo la contraseña antigua. Si cambias la contraseña, debes actualizarla también en el archivo wp-config.php.

¿Necesito crear un usuario nuevo para cada base de datos?

No es obligatorio, pero es una buena práctica de seguridad. Si usas el mismo usuario para varias bases de datos, un fallo en una de ellas podría comprometer a las demás. En cPanel puedes crear tantos usuarios como quieras, pero recuerda que cada usuario debe tener asignados los privilegios sobre la base de datos que vaya a usar.

Mi hosting usa Syspanel, ¿cómo accedo?

Si tu proveedor te ha dado acceso a Syspanel, el panel de control es diferente a cPanel, pero el proceso es análogo. Accede a través de la URL que te hayan dado, que normalmente es https://tu-dominio.com:2106. Dentro, busca la sección de bases de datos MySQL y sigue los mismos pasos: crear o localizar la base, crear o asignar el usuario, y luego editar wp-config.php. La lógica es idéntica.

[TIP]
Si al acceder a Syspanel no encuentras la opción de bases de datos, busca en la documentación de tu hosting o contacta con soporte. A veces está en un submenú llamado "Servicios" o "Aplicaciones".

¿Y si mi WordPress ya está instalado y solo quiero cambiar la base de datos?

Si tu WordPress ya funciona y quieres apuntarlo a una base de datos diferente (por ejemplo, porque has migrado de hosting), el proceso es exactamente el mismo: edita wp-config.php con los nuevos datos. Importante: si la base de datos nueva está vacía, tendrás que instalar WordPress de nuevo (o importar una copia de seguridad). Si la base de datos ya tiene contenido, tu web aparecerá con ese contenido.

Consejo final: haz una copia de seguridad antes de tocar nada

Este consejo nunca es demasiado. Antes de editar wp-config.php o modificar cualquier cosa en cPanel, haz una copia de seguridad completa de tu sitio (archivos y base de datos). En cPanel puedes usar la herramienta "Backup" o un plugin de WordPress si tu web está funcionando.

[WARNING]
Un error al editar wp-config.php puede dejar tu web inaccesible. Si no te sientes seguro, contacta con el soporte de tu hosting. Ellos pueden hacer el cambio por ti en cuestión de minutos.

Resumen rápido de los pasos

Para que no te pierdas, aquí tienes la secuencia completa:

Localiza o crea la base de datos en cPanel o Syspanel.
Crea o verifica que el usuario tiene todos los privilegios sobre esa base.
Abre el archivo wp-config.php desde el Administrador de Archivos o FTP.
Reemplaza los valores de DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.
Guarda el archivo y sube los cambios si usaste FTP.
Prueba tu web.

Conectar WordPress a una base de datos MySQL existente es una tarea que, una vez que la haces dos veces, te resultará trivial. Solo requiere paciencia y tener los datos correctos a mano. Si algo falla, repasa los pasos y revisa la FAQ. Y recuerda: el archivo wp-config.php es la clave de todo. Si lo tocas con cuidado, no hay nada que temer.

Preguntas frecuentes rápidas (FAQ express)

¿Qué es wp-config.php?
Es el archivo de configuración principal de WordPress. Contiene la información de conexión a la base de datos, entre otras cosas.

¿Puedo conectar WordPress a una base de datos de otro servidor?
Sí, si tu hosting lo permite. Solo tendrás que cambiar el DB_HOST a la dirección del servidor remoto. Eso sí, asegúrate de que el servidor remoto permite conexiones externas.

¿Qué hago si no tengo cPanel?
Si tu hosting usa un panel diferente (como Syspanel, Plesk o DirectAdmin), busca la sección de "Bases de datos MySQL". El procedimiento de editar wp-config.php es universal.

¿Pierdo mis datos si cambio la base de datos?
Depende. Si la base de datos nueva está vacía, perderás el contenido actual (porque no está allí). Si la base de datos nueva tiene contenido, verás ese contenido en tu web. Haz una copia de seguridad de lo que no quieras perder.

¿Cuál es el puerto para acceder a Syspanel?
El acceso a Syspanel se realiza por el puerto 2106. Por ejemplo: https://tu-dominio.com:2106. Asegúrate de incluir el puerto en la URL.

Ahora ya tienes todo lo necesario para realizar la conexión con éxito. ¡Manos a la obra!