Configurar conexión a base de datos en WordPress con cPanel: guía fácil

¿Qué es el archivo wp-config.php y por qué es tan importante?

Si alguna vez has intentado mover un sitio WordPress de un servidor a otro, o simplemente has tenido que cambiar la contraseña de tu base de datos, seguro que has oído hablar del archivo wp-config.php. Este pequeño pero poderoso archivo es el corazón de la configuración de WordPress. Contiene la información que tu sitio necesita para conectarse a la base de datos, donde se almacenan todos tus posts, páginas, comentarios, usuarios y ajustes.

Sin una conexión correcta a la base de datos, WordPress simplemente no funciona. Verás un mensaje de error como "Error al establecer una conexión a la base de datos". No te preocupes, es un problema muy común y solucionable. En esta guía te voy a explicar paso a paso cómo configurar la conexión base de datos en WordPress desde cPanel, tanto si estás montando un sitio nuevo como si estás restaurando uno existente.

Requisitos previos: ¿Qué necesitas tener a mano?

Antes de empezar, asegúrate de tener la siguiente información. Te hará la vida mucho más fácil:

Acceso a cPanel de tu hosting (con usuario y contraseña).
Nombre de la base de datos que vas a usar (o que ya has creado).
Usuario de la base de datos (con todos los permisos sobre esa base de datos).
Contraseña del usuario de la base de datos.
Host de la base de datos (normalmente es localhost, pero a veces varía).
Acceso a los archivos de tu sitio (por FTP o desde el administrador de archivos de cPanel).

[INFO] Si estás usando nuestro panel Syspanel (antes conocido como HestiaCP), recuerda que accedes por el puerto 2106. El proceso es muy similar al de cPanel.

Paso 1: Crear la base de datos y el usuario en cPanel

Lo primero es tener una base de datos lista. Si ya la tienes, puedes saltar al Paso 2. Si no, aquí te explico cómo crearla:

Inicia sesión en cPanel. Normalmente accedes desde tudominio.com/cpanel o la URL que te haya proporcionado tu hosting.
Busca la sección "Bases de Datos". Verás varias opciones, como "MySQL Databases" o "MySQL Database Wizard". Te recomiendo usar el Asistente (Wizard) porque te guía paso a paso.
Crea una nueva base de datos. Dale un nombre descriptivo, por ejemplo: miproyecto_wp. Haz clic en "Next Step".
Crea un usuario para la base de datos. Elige un nombre de usuario (ej: miproyecto_user) y una contraseña segura. Guarda esta contraseña en un lugar seguro, la necesitarás más adelante.
Asigna el usuario a la base de datos. El asistente te preguntará qué privilegios darle. Para un sitio WordPress normal, selecciona "ALL PRIVILEGES" (todos los privilegios). Esto es fundamental para que WordPress pueda leer, escribir, modificar y eliminar datos.
Finaliza. El asistente confirmará que todo se ha creado correctamente. ¡Ya tienes tu base de datos!

[TIP] Anota el nombre completo de la base de datos y del usuario. En cPanel, a menudo se les añade un prefijo (ej: tuusuario_miproyecto_wp). Este nombre completo es el que usarás en el archivo wp-config.php.

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

Ahora que tienes la base de datos, toca configurar la conexión. El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress. Normalmente, en la carpeta public_html o en una subcarpeta si tienes el sitio en un subdirectorio.

Opción A: Usando el Administrador de Archivos de cPanel (recomendado para principiantes)

En cPanel, busca la sección "Archivos" y haz clic en "Administrador de Archivos".
Se abrirá una ventana. Navega hasta la carpeta donde está tu WordPress (normalmente public_html).
Busca el archivo wp-config.php. Si no existe, puedes crear uno nuevo a partir del archivo wp-config-sample.php. Simplemente, haz clic derecho sobre wp-config-sample.php y selecciona "Copiar". Luego, renombra la copia a wp-config.php.
Haz clic derecho sobre wp-config.php y selecciona "Editar". Se abrirá un editor de texto.
Verás un montón de código PHP. No te asustes, solo nos interesa una sección específica.

Opción B: Usando FTP

Si prefieres usar un cliente FTP como FileZilla:

Conéctate a tu servidor usando las credenciales FTP que te proporcionó tu hosting.
Navega hasta la carpeta raíz de tu sitio (normalmente public_html).
Busca wp-config.php. Si no existe, descarga wp-config-sample.php y renómbralo.
Abre el archivo con un editor de texto plano (como Notepad++ o Sublime Text).

Paso 3: Configurar las constantes de la base de datos

Dentro del archivo wp-config.php, busca las siguientes líneas. Son las que definen la conexión a la base de datos:

// ** 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, reemplaza los valores de ejemplo con los datos reales que creaste en el Paso 1:

DB_NAME: Pega aquí el nombre completo de la base de datos (con el prefijo de cPanel si lo tiene).
DB_USER: Pega el nombre completo del usuario de la base de datos.
DB_PASSWORD: Pega la contraseña que elegiste para ese usuario.
DB_HOST: En el 99% de los casos, esto es localhost. Si tu hosting te ha proporcionado un host específico (como mysql.tudominio.com), escríbelo aquí. Si no estás seguro, déjalo como localhost.

[WARNING] Es muy importante que no olvides las comillas simples (') alrededor de cada valor. Si las borras, WordPress no podrá conectarse a la base de datos.

Un ejemplo real:

Si tu base de datos se llama midominio_bdwordpress, tu usuario es midominio_userwp y la contraseña es MiClaveSegura123, el código debería verse así:

define( 'DB_NAME', 'midominio_bdwordpress' );
define( 'DB_USER', 'midominio_userwp' );
define( 'DB_HOST', 'localhost' );
define( 'DB_PASSWORD', 'MiClaveSegura123' );

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

Una vez que hayas reemplazado todos los valores:

Guarda el archivo (Ctrl+S o Cmd+S).
Ciérralo.
Ahora, visita tu sitio web en el navegador.

Si todo está correcto, tu sitio WordPress debería cargar sin problemas. Si ves la pantalla de instalación de WordPress (el famoso "¡Bienvenido a WordPress!"), significa que la base de datos está vacía y estás listo para instalar. Si ya tenías contenido, tu sitio debería aparecer tal como estaba.

[INFO] Si el sitio no carga y ves un error, no te preocupes. Revisa los pasos anteriores. El error más común es escribir mal el nombre de la base de datos o del usuario. Vuelve a cPanel y verifica los nombres exactos.

Paso 5: Configuraciones adicionales importantes en wp-config.php

El archivo wp-config.php no solo sirve para la base de datos. Aquí te dejo algunas configuraciones clave que pueden ahorrarte muchos dolores de cabeza.

5.1. Las "Salt Keys" o Claves de Seguridad

Busca estas líneas en el archivo:

define('AUTH_KEY',         'coloca tu frase aleatoria aquí');
define('SECURE_AUTH_KEY',  'coloca tu frase aleatoria aquí');
define('LOGGED_IN_KEY',    'coloca tu frase aleatoria aquí');
define('NONCE_KEY',        'coloca tu frase aleatoria aquí');
define('AUTH_SALT',        'coloca tu frase aleatoria aquí');
define('SECURE_AUTH_SALT', 'coloca tu frase aleatoria aquí');
define('LOGGED_IN_SALT',   'coloca tu frase aleatoria aquí');
define('NONCE_SALT',       'coloca tu frase aleatoria aquí');

Estas claves son como la sal de una contraseña: hacen que tu sitio sea mucho más seguro contra ataques de fuerza bruta. No uses las que vienen por defecto. Puedes generar unas nuevas y únicas visitando la página oficial de WordPress: https://api.wordpress.org/secret-key/1.1/salt/. Simplemente copia todo el bloque que te da la web y pégalo en tu archivo, reemplazando las líneas existentes.

5.2. Cambiar el prefijo de las tablas (por seguridad)

Por defecto, las tablas de la base de datos de WordPress empiezan con wp_. Esto es conocido por los atacantes. Para dificultarles la vida, puedes cambiarlo:

$table_prefix = 'wp_';

Cámbialo a algo como miprefijo_ o xyz123_. Importante: Si ya tienes un sitio funcionando, no lo cambies a menos que también modifiques el nombre de las tablas en la base de datos. Este cambio es recomendable solo en instalaciones nuevas.

5.3. Forzar SSL en el área de administración

Si tienes un certificado SSL instalado (algo muy recomendable hoy en día), puedes forzar que el acceso a /wp-admin sea siempre por HTTPS:

define('FORCE_SSL_ADMIN', true);

Solución de problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes que recibimos en soporte técnico sobre este tema.

¿Por qué veo el error "Error al establecer una conexión a la base de datos"?

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

Nombre de base de datos o usuario incorrectos. Revisa en cPanel el nombre exacto, incluyendo el prefijo.
Contraseña incorrecta. Asegúrate de haberla copiado bien, sin espacios adicionales.
Host de base de datos incorrecto. Prueba con localhost. Si no funciona, contacta a tu hosting.
El usuario no tiene todos los privilegios. Vuelve a cPanel y asegúrate de que el usuario tenga "ALL PRIVILEGES" sobre la base de datos.

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

Técnicamente sí, pero es una muy mala idea. Cada sitio debe tener su propia base de datos. Si usas la misma, los datos se mezclarán y causarás errores graves e irreversibles. Crea siempre una base de datos nueva para cada instalación de WordPress.

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

No te preocupes, es normal en instalaciones nuevas. Simplemente busca el archivo wp-config-sample.php, cópialo y renómbralo como wp-config.php. Luego, edítalo como te hemos explicado.

¿Cómo sé cuál es el host de mi base de datos?

En cPanel, dentro de la sección "Bases de Datos", suele aparecer la información. Si no, el valor por defecto es localhost. Si tu hosting usa un host remoto, te lo habrán indicado en el correo de bienvenida. En Syspanel (puerto 2106), también suele ser localhost.

Cambié los datos en wp-config.php y ahora el sitio no carga. ¿Qué hago?

No te preocupes. Simplemente vuelve a editar el archivo y revisa que no hayas borrado ninguna comilla o punto y coma. Si el error persiste, restaura una copia de seguridad del archivo original (si la tienes) o descarga una nueva copia de WordPress y extrae el wp-config-sample.php.

Conclusión: Tu sitio ya está conectado

Configurar la conexión base de datos en WordPress desde cPanel es un proceso sencillo una vez que sabes dónde mirar. Recuerda que el archivo wp-config.php es la llave maestra de tu sitio. Trátalo con cuidado, haz siempre una copia de seguridad antes de modificarlo y nunca compartas sus datos (como la contraseña de la base de datos) con nadie.

Espero que esta guía te haya sido de ayuda. Si tienes alguna duda, no dudes en contactar con nuestro equipo de soporte. ¡Estamos aquí para ayudarte a que tu web funcione a la perfección!