Conectar WordPress a MySQL en cPanel: guía de configuración

¿Por qué WordPress necesita una base de datos MySQL?

Antes de lanzarnos a la acción, es fundamental que entiendas por qué WordPress y MySQL son inseparables. WordPress no es solo un montón de archivos PHP; es un sistema de gestión de contenidos (CMS) que guarda toda su información en una base de datos. Cada artículo, página, comentario, ajuste de configuración, usuario y contraseña se almacena en tablas dentro de una base de datos MySQL.

Cuando visitas tu sitio web, WordPress ejecuta el código PHP, pero para mostrar el contenido, realiza consultas a la base de datos. Si la base de datos no está conectada correctamente, tu sitio mostrará el famoso error "Error al establecer una conexión con la base de datos".

Por lo tanto, conectar WordPress a MySQL es el paso más crítico en la instalación o migración de tu sitio. En este artículo, te guiaré paso a paso para que lo hagas tú mismo, incluso si es la primera vez que ves un panel de control como cPanel.

Qué necesitas antes de empezar

Para conectar WordPress a tu base de datos MySQL, necesitarás tres datos que normalmente obtienes de tu proveedor de hosting:

Nombre de la base de datos (ej: usuario_wpdb).
Usuario de la base de datos (ej: usuario_wpuser).
Contraseña del usuario (la que tú definiste al crearla).
Host de la base de datos (normalmente localhost, pero a veces puede ser un servidor remoto como mysql.tudominio.com).

[INFO] Si tu hosting utiliza cPanel, el nombre de la base de datos y el usuario suelen tener un prefijo con tu nombre de cuenta (ej: tech_blogdb). Esto es normal y no debes quitarlo.

Método 1: La forma fácil (usando el instalador de cPanel)

Si aún no has instalado WordPress y tu hosting tiene el instalador Softaculous o Fantastico dentro de cPanel, este es el camino más rápido y seguro.

Paso 1: Localiza el instalador en cPanel

Dentro de tu cPanel, busca la sección "Software" o "Aplicaciones web". Haz clic en el icono de WordPress (normalmente el logo con la "W" naranja).

Paso 2: Configura la instalación

Verás un formulario largo. No te asustes, solo debes prestar atención a las opciones de Base de Datos.

Selecciona la pestaña de "Opciones avanzadas" (si no está visible, suele estar arriba a la derecha).

Aquí verás los campos que mencionamos antes:

Nombre de la base de datos: Elige uno, por ejemplo mipagina_db.
Usuario de la base de datos: Elige otro, por ejemplo mipagina_user.
Contraseña: Usa el generador de contraseñas seguras que te ofrece cPanel.

[TIP] No uses la misma contraseña que la de tu cPanel. Una contraseña segura incluye mayúsculas, minúsculas, números y símbolos.

Paso 3: El instalador hace el trabajo sucio

Al hacer clic en "Instalar", el propio Softaculous se encarga de crear la base de datos, el usuario y de conectar WordPress a MySQL automáticamente. No tocarás ni una línea de código. Al finalizar, te dará la URL de tu sitio y la del panel de administración.

Método 2: La forma manual (editar wp-config.php)

Este método es necesario cuando ya tienes los archivos de WordPress subidos a tu hosting (por ejemplo, tras una migración) o si prefieres tener control total. Aquí es donde entra en juego el archivo más famoso de WordPress: wp-config.php.

Paso 1: Localiza el archivo wp-config.php

Conéctate a tu hosting por FTP (con FileZilla, por ejemplo) o usa el Administrador de archivos de cPanel. Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta como public_html/blog).

Busca el archivo llamado wp-config.php. Si no existe, no te preocupes: busca un archivo llamado wp-config-sample.php. Lo duplicaremos y renombraremos.

Paso 2: Edita el archivo con un editor de texto

Haz clic derecho sobre wp-config.php (o sobre el sample) y selecciona "Editar" o "Code Editor". Se abrirá un editor de texto dentro de cPanel.

Verás un código PHP que empieza así:

<?php
// ** Configuración de MySQL ** //
define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña_usuario' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

Paso 3: Sustituye los datos

Ahora llega el momento de la verdad. Debes reemplazar los valores de ejemplo con los datos reales de tu base de datos.

DB_NAME: Pon el nombre exacto de la base de datos que creaste.
DB_USER: Pon el usuario exacto que tiene permisos sobre esa base.
DB_PASSWORD: Pon la contraseña que le asignaste a ese usuario.
DB_HOST: En el 90% de los casos en cPanel, este valor es localhost. Si tu hosting usa un servidor de bases de datos externo, te lo indicarán en el correo de bienvenida.

[WARNING] No cambies DB_CHARSET ni DB_COLLATE. El valor utf8 es el estándar y el correcto para la mayoría de sitios.

Paso 4: Guarda los cambios

Haz clic en "Guardar cambios" o "Save" en la esquina superior derecha del editor. Si estabas editando el archivo wp-config-sample.php, deberás renombrarlo a wp-config.php antes de guardar.

Paso 5: Verifica la conexión

Ahora, abre tu navegador y escribe la URL de tu sitio web (ej: https://tudominio.com). Si todo está correcto, verás tu sitio o el asistente de instalación de WordPress (si es una instalación nueva). Si ves el error de conexión, revisa que hayas escrito bien los datos, especialmente las mayúsculas y minúsculas en el nombre de la base de datos y el usuario.

Método 3: Crear la base de datos desde cero en cPanel

¿Y si aún no has creado la base de datos? Este es el paso previo a los Métodos 1 y 2. Aunque el método 1 la crea automáticamente, es bueno que sepas hacerlo manualmente.

Paso 1: Entra en "MySQL Databases"

Dentro de tu cPanel, busca la sección "Bases de datos" y haz clic en "MySQL® Databases".

Paso 2: Crea la base de datos

En el campo "Crear nueva base de datos", escribe un nombre (ej: mipagina). cPanel automáticamente le añadirá tu nombre de usuario como prefijo (ej: tech_mipagina). Haz clic en "Crear base de datos".

Paso 3: Crea el usuario de la base de datos

Baja hasta la sección "Crear usuario de MySQL". Introduce un nombre de usuario (ej: wpuser) y una contraseña segura. Haz clic en "Crear usuario".

Paso 4: Asigna el usuario a la base de datos

En la sección "Añadir usuario a la base de datos", selecciona el usuario y la base de datos que acabas de crear en los menús desplegables. Haz clic en "Añadir".

Te aparecerá una pantalla con los privilegios. Marca la casilla "TODOS LOS PRIVILEGIOS" (es lo recomendado para WordPress) y haz clic en "Hacer cambios".

[INFO] Sin este paso, WordPress no podrá leer ni escribir en la base de datos, aunque los datos de conexión sean correctos. Es el error más común en instalaciones manuales.

Solución de problemas comunes al conectar WordPress a MySQL

Aunque sigas los pasos al pie de la letra, a veces surgen problemas. Aquí tienes los más típicos y cómo solucionarlos.

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

Este es el error genérico. Las causas más probables son:

Credenciales incorrectas: Revisa que el nombre de la base de datos y el usuario no tengan espacios y que las contraseñas estén bien escritas.
Usuario no vinculado: Asegúrate de haber añadido el usuario a la base de datos y de haberle dado todos los privilegios (paso 4 del Método 3).
Host incorrecto: Prueba a cambiar localhost por 127.0.0.1 en el wp-config.php. A veces el servidor de bases de datos usa una IP específica.

Error: "No se puede seleccionar la base de datos"

Este error indica que el usuario existe pero no tiene permiso para usar esa base de datos en concreto. Vuelve al paso 4 del Método 3 y verifica los privilegios.

Error: "Las tablas no existen"

Esto suele pasar si has subido los archivos de WordPress pero no has importado la base de datos desde tu sitio anterior. Necesitas importar un archivo .sql a través de phpMyAdmin en cPanel.

El sitio carga muy lento tras la conexión

A veces el problema no es la conexión, sino el servidor de base de datos. Si tu hosting es muy básico, MySQL puede saturarse. Te recomiendo optimizar las consultas de tu base de datos o considerar un hosting con mejor rendimiento.

Preguntas frecuentes (FAQ)

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

No es recomendable. Cada instalación necesita su propia base de datos para evitar conflictos de tablas. Si usas la misma, los datos se sobrescribirán y tu sitio se romperá.

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

Puedes cambiarla desde cPanel. Ve a "MySQL Databases" y en la sección "Usuarios actuales", haz clic en "Cambiar contraseña". Luego, actualiza el valor DB_PASSWORD en tu wp-config.php.

¿Es seguro usar localhost como host de la base de datos?

Sí, es lo más seguro y común en cPanel. Significa que la base de datos está en el mismo servidor que tu sitio web, lo que reduce la latencia.

¿Qué es phpMyAdmin y para qué sirve?

Es una herramienta incluida en cPanel que te permite gestionar tu base de datos MySQL a través de una interfaz web. Sirve para importar/exportar bases de datos, ejecutar consultas SQL y ver las tablas.

¿Puedo conectar WordPress a una base de datos externa (de otro hosting)?

Sí, es posible. En el campo DB_HOST, en lugar de localhost, deberías poner la IP o el nombre del servidor externo. Sin embargo, la mayoría de los hostings bloquean las conexiones externas por seguridad. Si tu proveedor lo permite, asegúrate de que tu IP esté en la lista blanca del servidor MySQL.

¿Qué es Syspanel y qué relación tiene con esto?

Si tu hosting usa Syspanel (antes conocido como HestiaCP) en lugar de cPanel, el proceso es muy similar. La diferencia principal es que el acceso a tu panel de control se realiza a través del puerto 2106 (ej: https://tudominio.com:2106). Dentro de Syspanel, busca la sección de "Base de Datos" o "MySQL" para crear tu base de datos y usuario. El archivo wp-config.php que debes editar es exactamente el mismo.

¿Qué hago si mi archivo wp-config.php no existe?

Si no ves wp-config.php pero sí wp-config-sample.php, simplemente renombra el segundo a wp-config.php y edítalo. Si no ves ninguno de los dos, es que tu instalación de WordPress está incompleta. Vuelve a subir todos los archivos desde el paquete oficial de WordPress.

Consejos finales para una conexión segura

Conectar WordPress a MySQL es solo el primer paso. Aquí tienes algunos consejos para mantener tu sitio seguro y rápido:

Nunca uses las credenciales de tu cPanel para la base de datos. Usa siempre un usuario dedicado.
Cambia el prefijo de las tablas de WordPress (el valor wp_). Puedes hacerlo durante la instalación o editando el wp-config.php con la constante $table_prefix = 'mi_prefijo_';. Esto dificulta los ataques de inyección SQL.
Haz copias de seguridad de tu base de datos regularmente. Puedes usar plugins como UpdraftPlus o la herramienta de copias de seguridad de tu cPanel.
Mantén tu WordPress actualizado. Cada actualización corrige vulnerabilidades de seguridad que podrían comprometer tu base de datos.

[TIP] Si te sientes abrumado, no dudes en pedir ayuda al soporte de tu hosting. La mayoría de los proveedores ofrecen asistencia gratuita para este tipo de configuraciones. Es mejor preguntar que arriesgarte a perder tu información.

Con estos pasos, ya deberías tener tu WordPress conectado a tu base de datos MySQL sin problemas. Recuerda que la paciencia es clave. Revisa cada paso dos veces y, si algo falla, los errores te darán pistas sobre qué está mal. ¡Buena suerte con tu sitio web!