Conectar WordPress a tu base de datos: guía completa

Conectar WordPress con una base de datos es el paso fundamental para poner en marcha tu sitio web. Sin una conexión correcta, WordPress simplemente no puede funcionar, ya que toda la información de tu sitio (entradas, páginas, usuarios, comentarios y configuraciones) se almacena en una base de datos. Esta guía te llevará de la mano, paso a paso, para que puedas realizar esta conexión sin complicaciones, incluso si no tienes experiencia técnica previa.

Aquí aprenderás qué es el archivo wp-config.php, cómo crear una base de datos MySQL desde tu panel de control (como cPanel o Syspanel), y cómo editar los parámetros de conexión. Al final, tendrás tu WordPress perfectamente enlazado con su base de datos y listo para funcionar.

¿Qué necesitas antes de empezar?

Antes de lanzarte a conectar, asegúrate de tener estos tres elementos a la mano:

Acceso a tu panel de hosting: Normalmente es cPanel, Syspanel (HestiaCP) o Plesk. Necesitas poder crear bases de datos y usuarios.
Los datos de acceso a la base de datos: Nombre de la base de datos, nombre de usuario, contraseña y servidor (host).
Archivos de WordPress: Ya sea que los hayas descargado desde wordpress.org o los tengas instalados en tu servidor.

Si ya tienes WordPress instalado pero no recuerdas los datos de conexión, no te preocupes: podemos revisarlos y reconfigurarlos.

Paso 1: Crear la base de datos MySQL desde tu panel de hosting

El primer paso técnico es crear el espacio donde WordPress guardará toda la información. Esto se hace desde el panel de control de tu hosting.

Desde cPanel (el más común)

Inicia sesión en cPanel con tu usuario y contraseña.
Busca la sección Bases de Datos y haz clic en MySQL Database Wizard (Asistente de bases de datos MySQL).
Crea la base de datos: Escribe un nombre descriptivo (ej: mipagina_wp) y haz clic en Crear base de datos.
Crea un usuario: En el siguiente paso, escribe un nombre de usuario (ej: admin_wp) y una contraseña segura. Anótala porque la necesitarás después.
Asigna privilegios: Marca la opción Todos los privilegios y haz clic en Siguiente.
¡Listo! Ya tienes tu base de datos y usuario creados.

Desde Syspanel (HestiaCP)

Si tu hosting usa Syspanel (el panel basado en HestiaCP), el proceso es igual de sencillo:

Accede a Syspanel a través de tu navegador usando la dirección https://tudominio.com:2106 (recuerda, el puerto es el 2106).
Inicia sesión con tus credenciales de administrador.
Ve a la sección Bases de Datos en el menú lateral.
Haz clic en Añadir base de datos.
Completa los campos:
- Nombre de la base de datos: Elige un nombre único.
- Usuario: Se creará automáticamente con el mismo nombre, pero puedes personalizarlo.
- Contraseña: Genera una contraseña segura (Syspanel suele ofrecer un botón para generarla automáticamente).
Haz clic en Guardar. Syspanel creará la base de datos y el usuario con todos los permisos necesarios.

[TIP] Anota en un bloc de notas el nombre de la base de datos, el usuario y la contraseña. Los usarás en el siguiente paso.

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

WordPress utiliza un archivo llamado wp-config.php para almacenar la configuración de conexión a la base de datos. Este archivo se encuentra en la raíz de tu instalación de WordPress, es decir, en la misma carpeta donde están las carpetas wp-admin, wp-content y wp-includes.

Si estás instalando WordPress por primera vez, verás que el archivo se llama wp-config-sample.php. Debes renombrarlo a wp-config.php o crear uno nuevo basado en él.

¿Cómo acceder al archivo?

Tienes dos opciones principales:

A través del panel de archivos de tu hosting: En cPanel busca File Manager; en Syspanel busca Administrador de archivos. Navega hasta la carpeta de tu sitio (normalmente public_html o www).
Mediante FTP: Usa un cliente como FileZilla. Conéctate a tu servidor y navega a la carpeta raíz.

Una vez localices el archivo wp-config.php (o wp-config-sample.php), ábrelo con un editor de texto (como el bloc de notas o el editor integrado del panel).

Paso 3: Configurar los parámetros de conexión

Dentro del archivo wp-config.php encontrarás varias líneas de código PHP. Las que nos interesan son las que definen la conexión a la base de datos. Búscalas, se ven así:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

Ahora, reemplaza los valores con los datos que creaste en el paso anterior:

DB_NAME: Escribe exactamente el nombre de la base de datos que creaste (ej: mipagina_wp).
DB_USER: El nombre de usuario que creaste (ej: admin_wp).
DB_PASSWORD: La contraseña que asignaste a ese usuario.
DB_HOST: Normalmente es localhost, pero algunos proveedores usan direcciones como mysql.tudominio.com o 127.0.0.1. Si no estás seguro, consulta la documentación de tu hosting o revisa el correo de bienvenida. En Syspanel, suele ser localhost.

[WARNING] No modifiques las líneas DB_CHARSET y DB_COLLATE a menos que sepas lo que haces. utf8 es el valor correcto para la mayoría de los sitios.

Ejemplo práctico

Supongamos que creaste una base de datos llamada mipagina_wp, usuario admin_wp y contraseña ClaveSegura123. Tu configuración se vería así:

define('DB_NAME', 'mipagina_wp');
define('DB_USER', 'admin_wp');
define('DB_PASSWORD', 'ClaveSegura123');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

Paso 4: Guardar y probar la conexión

Una vez que hayas editado los valores, guarda el archivo wp-config.php. Si estabas usando wp-config-sample.php, recuerda renombrarlo a wp-config.php (o simplemente guarda el archivo con ese nombre).

Ahora, abre tu navegador y visita la URL de tu sitio web (ej: tudominio.com). Si todo está correcto, verás la pantalla de instalación de WordPress (si es una instalación nueva) o tu sitio funcionando normalmente (si ya tenías contenido).

¿Qué hacer si aparece un error de conexión?

Si ves un mensaje como "Error al conectar con la base de datos", no entres en pánico. Sigue estos pasos de verificación:

Revisa los nombres: Comprueba que el nombre de la base de datos, usuario y contraseña estén escritos exactamente como los creaste. A veces los paneles agregan prefijos (ej: usuario_nombre_db).
Verifica el servidor (DB_HOST): Si localhost no funciona, prueba con 127.0.0.1. Si sigues con problemas, contacta a tu proveedor de hosting para obtener el host correcto.
Comprueba los permisos del usuario: Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. Puedes revisarlo desde el panel de control.
Reinicia el servidor: En algunos casos, un reinicio del servidor web (Apache/Nginx) puede resolver problemas de caché.

[INFO] Si usas Syspanel, puedes verificar la conexión desde la misma sección de Bases de Datos. Syspanel suele mostrar un mensaje de éxito si la conexión es correcta.

Paso 5: Ajustes adicionales (opcionales pero recomendados)

Una vez que la conexión básica funciona, puedes aprovechar el archivo wp-config.php para optimizar tu sitio. Aquí tienes dos configuraciones muy útiles:

Prefijo de tablas personalizado

Por defecto, WordPress usa el prefijo wp_ para todas sus tablas. Cambiarlo a algo como miwp_ añade una capa extra de seguridad. Agrega esta línea:

$table_prefix = 'miwp_';

Si ya tienes contenido instalado, no cambies el prefijo a menos que sepas cómo migrar las tablas.

Claves de seguridad (Salts)

WordPress incluye un conjunto de claves que mejoran la encriptación de las contraseñas y cookies. Puedes generarlas automáticamente en https://api.wordpress.org/secret-key/1.1/salt/. Copia el bloque que te muestre y pégalo justo después de la línea define('DB_COLLATE', '');.

define('AUTH_KEY',         '...');
define('SECURE_AUTH_KEY',  '...');
define('LOGGED_IN_KEY',    '...');
define('NONCE_KEY',        '...');
define('AUTH_SALT',        '...');
define('SECURE_AUTH_SALT', '...');
define('LOGGED_IN_SALT',   '...');
define('NONCE_SALT',       '...');

[TIP] No copies las claves de ejemplo. Siempre genera las tuyas propias.

Preguntas frecuentes (FAQ)

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

No es recomendable. Cada instalación de WordPress debe tener su propia base de datos para evitar conflictos de tablas y pérdida de datos. Si usas el mismo prefijo, los datos se mezclarían.

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

Puedes cambiarla desde el panel de control de tu hosting. En cPanel, ve a MySQL Databases y busca la opción Cambiar contraseña para el usuario correspondiente. En Syspanel, edita el usuario desde la sección Bases de Datos. Luego actualiza el valor en wp-config.php.

¿Es seguro tener la contraseña en texto plano en wp-config.php?

Sí, es la práctica estándar. El archivo wp-config.php está protegido por el servidor y no es accesible desde el navegador. Además, nunca compartas el archivo ni lo subas a repositorios públicos.

¿Qué significa el error "Too many connections"?

Significa que tu base de datos ha alcanzado el límite de conexiones simultáneas permitidas por tu hosting. Puede deberse a un plugin mal optimizado o a mucho tráfico. Contacta a tu proveedor para aumentar el límite o revisa los plugins que tengas instalados.

¿Puedo cambiar el host de la base de datos después de tener contenido?

Sí, pero debes exportar e importar la base de datos al nuevo servidor y luego actualizar el DB_HOST en wp-config.php. Es un proceso delicado; si no te sientes seguro, pide ayuda a un desarrollador.

Conclusión

Conectar WordPress con una base de datos es un proceso sencillo una vez que entiendes los pasos: crear la base de datos y el usuario desde tu panel de hosting (ya sea cPanel o Syspanel), editar el archivo wp-config.php con los datos correctos y verificar la conexión. Recuerda siempre usar contraseñas seguras y mantener tu archivo de configuración a salvo.

Ahora que tu WordPress ya está conectado, puedes empezar a instalar temas, plugins y crear contenido. Si en algún momento tienes dudas, vuelve a esta guía. ¡Tu sitio web ya está listo para brillar!