Conectar WordPress a MySQL en cPanel | Guía Paso a Paso

Conectar WordPress a una base de datos MySQL que ya has creado en cPanel es uno de los pasos más importantes para lanzar tu sitio web. Aunque pueda sonar técnico, te aseguro que con esta guía paso a paso lo lograrás sin problemas, incluso si es tu primera vez. Vamos a desglosar todo el proceso, desde qué necesitas hasta cómo solucionar los errores más comunes.

¿Qué necesitas antes de empezar?

Antes de lanzarnos a la configuración, es fundamental que tengas a mano tres datos clave. Sin ellos, el proceso sería como intentar abrir una puerta sin llave.

Los tres datos imprescindibles

El nombre de la base de datos: Lo elegiste o lo generaste al crear la base en cPanel. Suele tener un prefijo que coincide con tu usuario de hosting (ejemplo: tuusuario_wpdb).
El nombre de usuario de la base de datos: Este usuario tiene los permisos para leer y escribir en la base. Es diferente al usuario de tu cuenta de cPanel (ejemplo: tuusuario_wpuser).
La contraseña de ese usuario: La estableciste al crear el usuario de la base de datos. Si no la recuerdas, siempre puedes generar una nueva desde cPanel.

[WARNING] Si no tienes estos datos o no has creado la base de datos aún, no continúes. Primero ve a la sección "Bases de datos MySQL" en cPanel y créala junto con su usuario. Asegúrate de asignar TODOS LOS PRIVILEGIOS al usuario sobre la base de datos antes de continuar.

Opción 1: Editar el archivo wp-config.php (Método manual)

Este es el método más directo y el que te recomiendo si ya tienes WordPress instalado pero te da error de conexión, o si prefieres tener el control total de la configuración.

Paso 1: Localiza tu archivo wp-config.php

Primero, necesitas acceder a los archivos de tu sitio web. Puedes hacerlo de dos maneras:

A través del Administrador de archivos de cPanel: Entra a cPanel, busca la sección "Archivos" y haz clic en "Administrador de archivos". Luego navega hasta la carpeta donde instalaste WordPress. Normalmente es public_html si WordPress está en la raíz de tu dominio, o una subcarpeta como public_html/miweb si lo instalaste en un subdirectorio.
A través de un cliente FTP (como FileZilla): Conecta a tu servidor usando las credenciales FTP que te proporcionó tu proveedor de hosting. Navega a la misma carpeta public_html.

Una vez allí, busca el archivo llamado wp-config.php. Si no lo ves, asegúrate de que tu administrador de archivos esté configurado para mostrar archivos ocultos. En cPanel, puedes hacerlo con el botón "Configuración" en la esquina superior derecha del Administrador de archivos.

Paso 2: Edita el archivo con seguridad

Haz clic derecho sobre wp-config.php y selecciona "Editar" o "Edit". Esto abrirá un editor de texto dentro de cPanel. Es crucial que no toques nada más que las líneas que te indicaré.

Busca las líneas que contienen DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. Deberían verse así:

// ** Configuraciones de MySQL ** //
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );

/** Usuario de MySQL */
define( 'DB_USER', 'usuario_de_tu_base' );

/** Contraseña de MySQL */
define( 'DB_PASSWORD', 'contraseña_de_tu_usuario' );

/** Host de MySQL */
define( 'DB_HOST', 'localhost' );

Paso 3: Sustituye con tus datos

Ahora, reemplaza los valores de ejemplo con los datos reales que recopilaste al principio.

En DB_NAME, escribe el nombre exacto de tu base de datos.
En DB_USER, escribe el nombre exacto del usuario de la base de datos.
En DB_PASSWORD, escribe la contraseña exacta de ese usuario.
En DB_HOST, en el 99% de los casos de hosting compartido, debes dejar localhost. Sin embargo, algunos proveedores usan un host específico como mysql.tudominio.com. Si no estás seguro, revisa la documentación de tu hosting o el correo de bienvenida. Si usas un hosting con Syspanel (antes conocido como HestiaCP), el host suele ser localhost también, pero verifícalo en la sección de bases de datos de tu panel.

[TIP] Después de editar, pulsa "Guardar cambios" o "Save Changes". Asegúrate de que el archivo se guarde con el mismo nombre y sin extensiones extra.

Paso 4: Verifica la conexión

Ahora, intenta acceder a tu sitio web. Si has hecho todo correctamente, WordPress debería cargar sin problemas. Si el error persiste, revisa que no haya espacios en blanco o caracteres extraños al principio o final de los valores que has introducido.

Opción 2: Usar el instalador de WordPress (Método automático)

Si aún no has instalado WordPress, este método es mucho más sencillo, ya que el propio instalador te pedirá los datos de la base de datos.

Paso 1: Descarga y sube WordPress

Descarga el paquete de WordPress desde es.wordpress.org. Descomprímelo en tu ordenador. Luego, sube el contenido de la carpeta wordpress a tu public_html (o la carpeta que prefieras) usando el Administrador de archivos de cPanel o FTP.

Paso 2: Ejecuta el instalador

Abre tu navegador y escribe la URL de tu dominio (ejemplo: https://tudominio.com). WordPress detectará que no hay ningún archivo de configuración y te mostrará la pantalla de instalación. Haz clic en "¡Vamos a ello!".

Paso 3: Introduce los datos de la base de datos

Aquí es donde el asistente te pedirá los datos que ya tienes:

Nombre de la base de datos: Introdúcelo.
Usuario de la base de datos: Introdúcelo.
Contraseña de la base de datos: Introdúcela.
Servidor de la base de datos: Deja localhost salvo que tu hosting te indique lo contrario.
Prefijo de tabla: Si no sabes qué es, déjalo como wp_. Solo cámbialo si tienes motivos de seguridad muy específicos.

Haz clic en "Enviar". Si los datos son correctos, verás un mensaje de éxito y podrás continuar con la instalación. Si no, te mostrará un error de conexión.

Solución de problemas: "Error al conectar con la base de datos"

Este es el error más frustrante, pero casi siempre tiene una solución sencilla. Vamos a repasarlas una por una.

1. Verifica los datos en wp-config.php

Es el error más común. Vuelve a abrir el archivo wp-config.php y comprueba que no haya espacios en blanco alrededor de los valores. Por ejemplo, ' miusuario ' es diferente de 'miusuario'. Asegúrate de que estás copiando y pegando exactamente los nombres de la base y del usuario desde cPanel, ya que a veces son fáciles de confundir.

2. Comprueba los privilegios del usuario

A veces el usuario existe, pero no tiene permisos sobre la base de datos. Ve a cPanel > "Bases de datos MySQL". Localiza tu base de datos y en la sección "Usuarios en la base de datos", asegúrate de que tu usuario esté añadido. Si no lo está, añádelo y marca la casilla "TODOS LOS PRIVILEGIOS". Guarda los cambios y prueba de nuevo.

3. El host de la base de datos no es localhost

Algunos proveedores de hosting (especialmente los de gama alta o servidores dedicados) utilizan un host de base de datos distinto. Revisa tu correo de bienvenida o la sección de ayuda de tu proveedor. Si usas un panel como Syspanel, el puerto de acceso al panel es el 2106, pero el host de la base de datos para WordPress suele ser localhost o la IP del servidor. Si tienes dudas, contacta con soporte.

4. La base de datos o el usuario no existen

Puede parecer obvio, pero a veces creamos la base de datos en un dominio y luego intentamos conectar desde otro. Verifica en cPanel que la base de datos y el usuario existen exactamente con los nombres que has puesto en el archivo de configuración.

5. Problemas con el prefijo de las tablas

Si has importado una base de datos de otro sitio, es posible que las tablas tengan un prefijo diferente (por ejemplo, miweb_ en lugar de wp_). En ese caso, debes cambiar la línea $table_prefix = 'wp_'; en tu wp-config.php para que coincida con el prefijo de las tablas que has importado.

6. El servidor de bases de datos está caído o saturado

A veces el problema no eres tú, sino el servidor. Si todo lo demás falla, espera unos minutos y vuelve a intentarlo. También puedes comprobar el estado del servicio en el panel de tu hosting.

[INFO] Si después de todos estos pasos sigues sin poder conectar, el problema puede ser un plugin o tema corrupto. Para descartarlo, renombra la carpeta wp-content/plugins a wp-content/plugins_old desde el Administrador de archivos. Si el sitio carga, el problema era un plugin. Haz lo mismo con la carpeta wp-content/themes si el error persiste.

Consejos finales para una conexión exitosa

Haz una copia de seguridad del wp-config.php: Antes de editarlo, descarga una copia a tu ordenador. Así, si algo sale mal, puedes restaurarlo fácilmente.
No uses el usuario "root" de MySQL: Siempre crea un usuario específico para tu base de datos. Es más seguro.
Actualiza tus contraseñas periódicamente: Desde cPanel, puedes cambiar la contraseña del usuario de la base de datos. Recuerda actualizar también el wp-config.php si lo haces.
Si usas Syspanel (HestiaCP): Recuerda que el acceso al panel es a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). El proceso de creación de bases de datos es muy similar al de cPanel, pero con una interfaz diferente.

Conectar WordPress a una base de datos MySQL en cPanel es un proceso que, una vez que lo entiendes, te llevará menos de cinco minutos. La clave está en tener los datos correctos a mano y ser meticuloso al copiarlos. No tengas miedo de equivocarte, ya que es un proceso muy reversible. Si has seguido todos los pasos y aún tienes problemas, te invito a releer la sección de solución de problemas, ya que la respuesta a tu error casi siempre está ahí.

Espero que esta guía te haya sido de gran ayuda. Ahora ya tienes el conocimiento para conectar WordPress a tu base de datos como un profesional. ¡A construir tu sitio web!