Conectar WordPress a MySQL en cPanel: Configuración wp-config.php

Introducción: El corazón de tu sitio WordPress

Cuando instalas WordPress, técnicamente estás conectando dos piezas de software: el código de WordPress (archivos PHP, temas y plugins) y una base de datos MySQL donde se guardan todas tus publicaciones, páginas, comentarios y configuraciones. Sin esa conexión, tu sitio web no puede funcionar.

Si estás usando cPanel como panel de control de tu hosting, conectar WordPress a una base de datos MySQL es un proceso muy habitual. Ya sea porque estás migrando un sitio, instalando WordPress manualmente o solucionando el temido error "Error al establecer una conexión con la base de datos", entender cómo funciona este vínculo te dará control total sobre tu proyecto.

En esta guía completa, te explicaré paso a paso cómo conectar WordPress a tu base de datos MySQL usando cPanel. No necesitas ser un experto en programación: solo sigue las instrucciones y tendrás tu sitio funcionando en minutos.

¿Qué necesitas antes de empezar?

Antes de ponernos manos a la obra, asegúrate de tener lo siguiente a mano:

Acceso a cPanel: Las credenciales de tu hosting (usuario y contraseña).
Archivos de WordPress: Ya sea que los hayas descargado de wordpress.org o que ya tengas un sitio que quieras mover.
Datos de la base de datos: Nombre de la base, usuario y contraseña. Te enseñaré a crearlos si aún no los tienes.
Un editor de texto: Como el Bloc de notas, Sublime Text o VS Code para modificar el archivo wp-config.php.

Paso 1: Crear la base de datos MySQL en cPanel

Lo primero es tener una base de datos lista. Si ya tienes una creada (por ejemplo, de una instalación anterior), puedes saltarte este bloque. Pero si estás empezando desde cero, sigue estos pasos:

Inicia sesión en cPanel con tu usuario y contraseña.
Busca la sección "Bases de Datos" o "MySQL Databases" (puede variar según el proveedor).
En el campo "Create New Database", escribe un nombre descriptivo, como wordpress_sitio o blog_datos. Ten en cuenta que cPanel suele añadir un prefijo con tu usuario, así que el nombre final quedará algo como usuario_wordpress_sitio.
Haz clic en "Create Database" y espera a que aparezca el mensaje de confirmación.
Anota el nombre completo de la base de datos. Lo necesitarás más adelante.

Paso 2: Crear un usuario para la base de datos

No es seguro usar el usuario principal de cPanel para la base de datos. Lo correcto es crear un usuario dedicado con permisos específicos.

En la misma página de "MySQL Databases", desplázate hasta "MySQL Users".
Introduce un nombre de usuario (por ejemplo, wp_user) y una contraseña robusta. Puedes usar el generador de contraseñas de cPanel para asegurarte de que sea segura.
Haz clic en "Create User".
Guarda tanto el nombre de usuario como la contraseña en un lugar seguro. Los necesitarás para el archivo de configuración.

Paso 3: Asignar el usuario a la base de datos

Ahora viene el paso crucial: darle permisos al usuario para que pueda leer y escribir en la base de datos.

En la misma sección de bases de datos, busca "Add User to Database".
Selecciona el usuario que acabas de crear en el primer desplegable.
Selecciona la base de datos que creaste en el segundo desplegable.
Haz clic en "Add".
Se abrirá una ventana con los privilegios. Para WordPress, lo más sencillo es marcar "ALL PRIVILEGES" (todos los privilegios). Esto permite que WordPress cree tablas, inserte datos, los actualice, etc., sin problemas.
Confirma con "Make Changes".

[INFO] Si por seguridad prefieres dar permisos mínimos, WordPress necesita al menos: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX y DROP. Pero para un sitio estándar, "ALL PRIVILEGES" es lo más recomendable y evita errores extraños.

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

El archivo wp-config.php es el puente entre WordPress y tu base de datos. Se encuentra en la raíz de tu instalación de WordPress (la carpeta donde están las carpetas wp-admin, wp-content, etc.).

Si estás instalando WordPress desde cero

Descarga WordPress desde wordpress.org y descomprime el ZIP en tu ordenador.
Dentro de la carpeta descomprimida, verás un archivo llamado wp-config-sample.php.
Haz una copia de ese archivo y renómbrala a wp-config.php. Este será el archivo que edites.

Si ya tienes WordPress instalado

Conéctate a tu hosting mediante FTP (por ejemplo, con FileZilla) o usa el Administrador de Archivos de cPanel.
Navega hasta la carpeta raíz de tu WordPress (normalmente public_html o una subcarpeta).
Busca el archivo wp-config.php. Si no existe, crea uno a partir de wp-config-sample.php como en el caso anterior.

Paso 5: Configurar los datos de conexión

Abre el archivo wp-config.php con tu editor de texto favorito. Busca las siguientes líneas (suelen estar al principio del archivo):

// ** 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' );

Ahora, sustituye los valores de ejemplo por los tuyos:

DB_NAME: El nombre completo de la base de datos que anotaste en el Paso 1 (por ejemplo, usuario_wordpress_sitio).
DB_USER: El nombre de usuario que creaste en el Paso 2 (por ejemplo, usuario_wp_user).
DB_PASSWORD: La contraseña que asignaste a ese usuario.
DB_HOST: En el 99% de los casos con cPanel, esto es localhost. Si tu hosting usa un servidor MySQL externo, te lo habrán indicado en un correo o en la documentación del proveedor. Si no estás seguro, deja localhost.

Guarda el archivo y súbelo de nuevo al servidor si estabas trabajando en local.

[WARNING] NUNCA subas el archivo wp-config.php con contraseñas reales en texto plano a repositorios públicos de GitHub o similares. Es un riesgo de seguridad muy grave. Si necesitas compartir archivos, elimina las credenciales antes.

Paso 6: Subir los archivos de WordPress (si aplica)

Si estás haciendo una instalación manual, ahora toca subir todos los archivos de WordPress a tu servidor.

En cPanel, abre el Administrador de Archivos.
Navega hasta public_html (o la carpeta donde quieras instalar WordPress, por ejemplo, una subcarpeta llamada blog).
Sube el contenido de la carpeta de WordPress (todos los archivos y carpetas, no la carpeta en sí).
Asegúrate de que el archivo wp-config.php que editaste esté incluido en la subida.

Si prefieres usar FTP, hazlo con FileZilla o cualquier cliente similar.

Paso 7: Ejecutar el instalador de WordPress

Ahora viene la parte emocionante. Abre tu navegador y escribe la URL de tu sitio. Por ejemplo:

Si instalaste en la raíz: http://tudominio.com
Si instalaste en una subcarpeta: http://tudominio.com/blog

WordPress detectará el archivo wp-config.php y te pedirá que completes los datos del sitio:

Título del sitio: El nombre de tu página.
Nombre de usuario: El usuario administrador que usarás para entrar al panel.
Contraseña: Una contraseña fuerte para ese usuario.
Tu correo electrónico: Para recuperaciones y avisos.
Visibilidad para buscadores: Desmarca esta opción si quieres que Google indexe tu sitio desde el principio (recomendado).

Haz clic en "Install WordPress" y, en unos segundos, tendrás tu sitio funcionando.

Solución de problemas comunes

A veces, la conexión falla. Estos son los errores más típicos y cómo solucionarlos:

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

Este es el error más común. Significa que WordPress no puede comunicarse con MySQL. Comprueba:

Que el nombre de la base de datos, usuario y contraseña estén escritos correctamente en wp-config.php.
Que el usuario tenga los privilegios asignados (Paso 3).
Que el DB_HOST sea el correcto. Prueba a cambiar localhost por 127.0.0.1 o viceversa.
Que la base de datos exista realmente en cPanel.

[TIP] Si has creado la base de datos y el usuario con caracteres especiales (como guiones), WordPress puede tener problemas. Usa solo letras y números.

2. Error: "No se pudo conectar con la base de datos: Host 'x' no está permitido"

Esto suele pasar cuando el DB_HOST no es localhost. Vuelve a revisar los datos de tu proveedor de hosting. En cPanel, casi siempre es localhost.

3. Error: "Base de datos no encontrada"

El nombre de la base de datos está mal. Recuerda que en cPanel el nombre completo incluye el prefijo de tu usuario. Revisa el nombre exacto en la sección de bases de datos de cPanel.

4. Después de migrar, el sitio muestra una página en blanco

Esto puede deberse a que la base de datos importada tiene URLs antiguas. No te asustes: es un problema de configuración, no de conexión. Puedes usar plugins como "Better Search Replace" o editar las URLs directamente en la base de datos desde phpMyAdmin.

Consejos adicionales para mantener tu base de datos sana

Conectar WordPress a MySQL no es solo cuestión de una vez. Con el tiempo, tu base de datos puede crecer y volverse lenta. Aquí tienes algunos consejos:

Haz copias de seguridad periódicas: Usa plugins como UpdraftPlus o las herramientas de cPanel para exportar tu base de datos.
Optimiza las tablas: Desde phpMyAdmin, puedes marcar todas las tablas y elegir "Optimizar tablas" para reducir el tamaño y mejorar el rendimiento.
Cambia el prefijo de las tablas: Si instalaste WordPress con el prefijo por defecto wp_, considera cambiarlo por uno personalizado (por ejemplo, miwp_) para dificultar ataques de inyección SQL. Puedes hacerlo editando el wp-config.php con la constante $table_prefix.

Preguntas frecuentes (FAQ)

¿Puedo conectar WordPress a una base de datos que no esté en cPanel?

Sí, puedes usar una base de datos externa (por ejemplo, de Amazon RDS o de otro servidor). Solo tendrás que cambiar el DB_HOST por la dirección IP o el dominio del servidor MySQL externo y asegurarte de que los puertos estén abiertos. Sin embargo, para la mayoría de los sitios, tener la base de datos en el mismo cPanel es más rápido y sencillo.

¿Qué pasa si olvido la contraseña de la base de datos?

No hay problema. Ve a cPanel, sección "MySQL Databases", busca el usuario y haz clic en "Change Password". Luego actualiza el archivo wp-config.php con la nueva contraseña.

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

Técnicamente sí, pero NO es recomendable. Las dos instalaciones compartirían las mismas tablas y se sobrescribirían datos. Siempre usa una base de datos separada para cada sitio, aunque estén en el mismo cPanel.

¿Qué es Syspanel y cómo se relaciona con esto?

Si en algún momento ves referencias a Syspanel, debes saber que es un panel de control alternativo a cPanel, muy similar en funciones. Si tu hosting usa Syspanel, el acceso se realiza a través del puerto 2106 (por ejemplo, http://tudominio.com:2106). Los pasos para crear bases de datos y usuarios son prácticamente idénticos a los de cPanel: busca las secciones de "Bases de Datos" y sigue el mismo flujo.

¿Por qué mi WordPress es lento? ¿Tiene que ver con la conexión a la base de datos?

A veces sí. Si tu base de datos está llena de basura (revisiones antiguas, transients caducados, spam), las consultas tardan más. Además, si tu hosting es compartido y tiene muchos sitios, el rendimiento puede verse afectado. Optimiza tus tablas y considera usar un plugin de caché para reducir la carga.

Conclusión

Conectar WordPress a una base de datos MySQL desde cPanel es un proceso simple una vez que conoces los pasos. La clave está en tener claros los tres datos fundamentales: nombre de la base de datos, usuario y contraseña, y saber dónde colocarlos en el archivo wp-config.php.

Con esta guía, no solo podrás hacer instalaciones limpias, sino también diagnosticar problemas de conexión y migrar sitios sin dolores de cabeza. Recuerda siempre hacer copias de seguridad y mantener tus credenciales en un lugar seguro.

Si has seguido todos los pasos y tu WordPress sigue sin conectar, repasa los puntos de solución de problemas o contacta con tu proveedor de hosting: a veces hay límites de conexiones o restricciones de IP que ellos pueden resolver por ti.

¡Ahora ya sabes cómo funciona la magia detrás de tu WordPress! ¿Te animas a probarlo?