Conectar MySQL con WordPress en cPanel: guía para novatos

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a aprender a conectar una base de datos MySQL con WordPress usando cPanel. Este es un paso esencial para instalar WordPress manualmente o para solucionar problemas de conexión a la base de datos. No te preocupes si nunca lo has hecho, te guiaré paso a paso de forma muy sencilla.

Antes de empezar, asegúrate de tener acceso a tu panel de control de hosting (cPanel) y a tu dominio principal o subdominio donde quieras instalar WordPress. Si usas un panel alternativo como Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106), pero los pasos son muy similares.

¿Qué necesitas para conectar MySQL con WordPress en cPanel?

Para que WordPress funcione, necesita una base de datos donde guardar todo tu contenido: entradas, páginas, usuarios, comentarios, etc. En cPanel, esto se gestiona a través de la sección Bases de Datos MySQL. Los elementos clave son:

Nombre de la base de datos (ejemplo: miusuario_wpdb).
Usuario de la base de datos (ejemplo: miusuario_wpusr).
Contraseña segura para ese usuario.
Servidor de la base de datos (normalmente localhost o la dirección que te indique tu hosting).

Con estos datos, editarás el archivo wp-config.php de WordPress para que se conecte correctamente.

Paso 1: Crear la base de datos MySQL desde cPanel

Este es el primer paso. Ve a tu cPanel y busca la sección Bases de Datos. Allí encontrarás la opción MySQL Database Wizard (Asistente de bases de datos MySQL). Es la herramienta más fácil para crear todo de una sola vez.

### Crear el nombre de la base de datos

Haz clic en MySQL Database Wizard.
En el primer campo, escribe un nombre para tu base de datos. Por ejemplo: wordpress_data.
Haz clic en Next Step.

[TIP] El nombre completo se verá como tuusuario_wordpress_data. No te preocupes por el prefijo, el sistema lo añade automáticamente.

### Crear un usuario y asignarle contraseña

En el siguiente paso, te pedirá crear un usuario. Pon un nombre fácil de recordar, como wp_user.
Escribe una contraseña segura. Puedes usar el generador que te ofrece cPanel. Guarda esta contraseña en un lugar seguro, la necesitarás más adelante.
Haz clic en Create User.

### Asignar privilegios al usuario

Ahora verás una lista de permisos (privilegios). Marca la opción ALL PRIVILEGES (Todos los privilegios) para que WordPress pueda leer, escribir, modificar y eliminar datos sin problemas.
Haz clic en Next Step.

¡Listo! Ya tienes tu base de datos y usuario creados. Verás un resumen con los datos: nombre de la base, usuario y servidor (normalmente localhost).

[INFO] Si tu hosting usa un servidor remoto, el nombre del servidor te lo proporcionará tu proveedor. En el 99% de los casos es localhost.

Paso 2: Descargar y preparar los archivos de WordPress

Ahora necesitas tener los archivos de WordPress en tu servidor. Puedes hacerlo de dos formas:

### Opción A: Instalador automático (Softaculous, Fantastico, etc.)

Muchos paneles cPanel tienen instaladores automáticos. Busca la sección Softaculous Apps Installer o similar. Allí seleccionas WordPress, ingresas los datos de la base de datos que creaste y en minutos estará listo. Pero en este tutorial nos centraremos en la instalación manual, que te da más control.

### Opción B: Instalación manual (descarga e ingresa por FTP)

Ve a wordpress.org/download y descarga el archivo .zip de WordPress.
Descomprime el archivo en tu computadora. Obtendrás una carpeta llamada wordpress.
Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o usa el Administrador de Archivos de cPanel.
Sube todo el contenido de la carpeta wordpress (no la carpeta en sí, sino su interior) a la carpeta raíz de tu dominio o subdominio (normalmente public_html o public_html/tu-carpeta).

[WARNING] Asegúrate de que el archivo wp-config.php (si existe) no esté presente. Si estás haciendo una instalación limpia, no debería estar. Si ya tienes una instalación anterior, haz una copia de seguridad antes de continuar.

Paso 3: Configurar el archivo wp-config.php

Este es el corazón de la conexión. El archivo wp-config.php le dice a WordPress dónde está la base de datos, cómo acceder a ella y otros parámetros importantes.

### Localizar o crear el archivo

En la carpeta donde subiste WordPress, busca el archivo wp-config-sample.php. Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.). Verás algo como esto:

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

### Rellenar los datos de tu base de datos

Reemplaza los valores entre comillas con los datos que creaste en el Paso 1:

DB_NAME: El nombre completo de tu base de datos (ejemplo: tuusuario_wordpress_data).
DB_USER: El nombre completo del usuario (ejemplo: tuusuario_wp_user).
DB_PASSWORD: La contraseña que pusiste al crear el usuario.
DB_HOST: Normalmente localhost. Si tu hosting te indica otro valor (como mysql.tudominio.com), escríbelo aquí.

[TIP] Si no estás seguro del nombre del servidor, revisa el correo de bienvenida de tu hosting o contacta al soporte. En la mayoría de los casos es localhost.

### Guardar el archivo con el nombre correcto

Una vez que hayas reemplazado los datos, guarda el archivo como wp-config.php (sin la parte -sample). Si ya existía un wp-config.php, reemplázalo o renómbralo como respaldo.

### Claves de seguridad (opcional pero recomendado)

En el mismo archivo, más abajo, verás líneas como:

define('AUTH_KEY',         'coloca aquí tu frase única');
define('SECURE_AUTH_KEY',  'coloca aquí tu frase única');
...

Puedes generar claves seguras desde https://api.wordpress.org/secret-key/1.1/salt/. Copia todo el bloque generado y pégalo reemplazando las líneas existentes. Esto mejora la seguridad de tu sitio.

[INFO] No es obligatorio, pero es una buena práctica. Las claves ayudan a proteger las cookies y contraseñas de los usuarios.

Paso 4: Verificar la conexión y finalizar la instalación

Una vez que hayas subido el archivo wp-config.php al servidor (si lo editaste localmente, súbelo por FTP o usando el Administrador de Archivos), es hora de probar la conexión.

Abre tu navegador y visita la URL de tu dominio (ejemplo: tudominio.com).
Si todo está bien, aparecerá la pantalla de instalación de WordPress (seleccionar idioma, nombre del sitio, usuario administrador, etc.).
Si ves un mensaje de error como "Error establishing a database connection", no te preocupes. Revisa:
- Que los datos en wp-config.php sean correctos (nombre de base, usuario, contraseña).
- Que el usuario tenga todos los privilegios (puedes revisarlo en cPanel > Bases de Datos MySQL).
- Que el servidor de base de datos sea el correcto (prueba con localhost o el que te indique tu hosting).
Si la conexión es exitosa, completa el formulario de instalación: título del sitio, nombre de usuario administrador, contraseña fuerte y correo electrónico.

[WARNING] No uses "admin" como nombre de usuario administrador. Es el más atacado por bots. Elige algo único.

Solución de problemas comunes (FAQ)

Aquí tienes las dudas más frecuentes que resuelvo como técnico de soporte:

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

Causa más común: Los datos en wp-config.php son incorrectos. Revisa que el nombre de la base, usuario y contraseña estén escritos exactamente como en cPanel.
El usuario no tiene privilegios: Ve a cPanel > Bases de Datos MySQL, selecciona el usuario y asígnale ALL PRIVILEGES.
El servidor de base de datos no es localhost: Algunos hosts usan direcciones como mysql.tudominio.com. Pregunta a tu proveedor.

### ¿Cómo sé si mi hosting usa `localhost` o un servidor remoto?

En cPanel, dentro de Bases de Datos MySQL, al lado del nombre de la base de datos suele aparecer el servidor. Si no aparece, asume que es localhost. Si tienes dudas, contacta al soporte técnico.

### ¿Puedo usar el mismo usuario para varias bases de datos?

Sí, pero no es recomendable por seguridad. Cada base de datos debería tener su propio usuario. Si ya tienes un usuario creado, puedes asignarlo a la nueva base desde cPanel > Bases de Datos MySQL > Add User to Database.

### ¿Qué hago si olvidé la contraseña del usuario de la base de datos?

En cPanel, ve a Bases de Datos MySQL, busca el usuario y haz clic en Change Password. Luego actualiza el archivo wp-config.php con la nueva contraseña.

### ¿Es necesario usar el asistente MySQL Database Wizard?

No, también puedes crear la base y el usuario por separado desde MySQL Databases, pero el Wizard es más rápido y evita errores.

Consejos adicionales para mantener tu base de datos segura

Usa contraseñas fuertes: Combina mayúsculas, minúsculas, números y símbolos. No uses fechas de cumpleaños ni palabras comunes.
Cambia el prefijo de las tablas: En wp-config.php, puedes añadir $table_prefix = 'wp_' (o cámbialo por algo como miprefijo_). Esto dificulta ataques de inyección SQL.
Haz copias de seguridad periódicas: Desde cPanel puedes exportar la base de datos a un archivo .sql. También hay plugins de WordPress como UpdraftPlus que lo automatizan.

[TIP] Si migras tu sitio a otro hosting, solo necesitas exportar la base de datos, crear una nueva en el destino, importar los datos y actualizar wp-config.php con los nuevos datos de conexión.

Conclusión

Conectar una base de datos MySQL con WordPress en cPanel es un proceso sencillo si sigues estos pasos: creas la base de datos, el usuario, subes los archivos de WordPress y configuras wp-config.php. Recuerda que el archivo de configuración es el puente entre WordPress y la base de datos; cualquier error en él impedirá la conexión.

Si usas Syspanel (HestiaCP), no olvides que el acceso es por el puerto 2106, y los pasos son prácticamente los mismos: busca la sección de bases de datos MySQL, crea la base y el usuario, y edita el wp-config.php con esos datos.

Espero que este tutorial te haya sido de gran ayuda. Si te encuentras con algún problema, no dudes en consultar la documentación de tu hosting o contactar a su soporte técnico. ¡Buena suerte con tu sitio WordPress!