Conectar WordPress a MySQL: Guía paso a paso para principiantes

Conectar WordPress a una base de datos MySQL es el paso fundamental para que tu sitio web funcione. Sin esta conexión, WordPress no puede almacenar tus artículos, páginas, comentarios o configuraciones. Si eres principiante, no te preocupes: este proceso es más sencillo de lo que parece. En esta guía, te explicaré todo lo que necesitas saber, desde los conceptos básicos hasta la solución de errores comunes.

¿Qué es una base de datos MySQL y por qué WordPress la necesita?

Imagina que tu sitio web es una tienda. WordPress sería el mostrador y los estantes, mientras que la base de datos MySQL es el almacén donde guardas todos tus productos (artículos, imágenes, usuarios, etc.). Cada vez que alguien visita tu web, WordPress consulta esa base de datos para mostrar la información correcta.

Sin una conexión estable entre WordPress y MySQL, tu sitio no puede funcionar. Por eso, conectar base de datos es el primer paso después de instalar WordPress.

Componentes clave de la conexión

Para que WordPress se comunique con MySQL, necesitas cuatro datos básicos:

Nombre de la base de datos: El identificador único donde se guardará tu contenido.
Usuario de la base de datos: Quién tiene permiso para acceder a ella.
Contraseña: La clave secreta del usuario.
Servidor de base de datos: Normalmente es "localhost", pero puede variar si usas un hosting externo.

Paso 1: Preparar la base de datos MySQL antes de conectar WordPress

Antes de tocar cualquier archivo, asegúrate de que la base de datos exista. Si usas un panel de control como cPanel o Syspanel, el proceso es visual y sencillo.

Crear la base de datos en cPanel

Inicia sesión en cPanel (normalmente en tudominio.com/cpanel).
Busca la sección Bases de datos MySQL.
Haz clic en Asistente para bases de datos MySQL.
Introduce un nombre para tu base de datos (ej: mipagina_wp).
Crea un usuario y una contraseña segura. Guárdalos en un lugar seguro (los necesitarás después).
Asigna el usuario a la base de datos marcando Todos los privilegios.

Crear la base de datos en Syspanel (anteriormente HestiaCP)

Si tu hosting usa Syspanel, el proceso es igual de simple:

Accede a Syspanel a través del puerto 2106 (ej: tudominio.com:2106).
Ve a Bases de datos > Añadir base de datos.
Introduce el nombre de la base de datos, el usuario y la contraseña.
Haz clic en Guardar. Syspanel creará automáticamente la base de datos y el usuario con todos los permisos.

[INFO] En Syspanel, el usuario suele tener el mismo nombre que la base de datos, pero con un prefijo (ej: admin_mipagina). No olvides anotar el nombre completo.

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

El archivo wp-config.php es el corazón de la conexión entre WordPress y MySQL. Se encuentra en la carpeta raíz de tu instalación de WordPress (normalmente public_html o www).

¿Cómo acceder al archivo?

Mediante FTP: Usa un cliente como FileZilla. Conéctate a tu servidor y navega hasta la carpeta raíz.
Mediante el panel de archivos: En cPanel, usa el Administrador de archivos. En Syspanel, ve a Archivos > Administrador de archivos.

Una vez localizado, descarga una copia de seguridad antes de editarlo. Luego, ábrelo con un editor de texto plano (como Notepad++ o el editor integrado del panel).

Las líneas mágicas para conectar WordPress

Dentro del archivo, busca las siguientes líneas (suelen estar al principio):

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');

Reemplaza los valores con los datos que creaste en el paso anterior:

DB_NAME: El nombre exacto de tu base de datos (ej: mipagina_wp).
DB_USER: El usuario que creaste (ej: mipagina_admin).
DB_PASSWORD: La contraseña que elegiste.
DB_HOST: Normalmente es localhost. Si tu hosting te indica un servidor diferente (como sql.tudominio.com), úsalo.

[WARNING] No uses comillas curvas o tipográficas. Asegúrate de que las comillas sean rectas (') para evitar errores de sintaxis.

Ejemplo completo

define('DB_NAME', 'mipagina_wp');
define('DB_USER', 'mipagina_admin');
define('DB_PASSWORD', 'ClaveSuperSegura2024');
define('DB_HOST', 'localhost');

Guarda el archivo y súbelo de nuevo al servidor si lo editaste localmente.

Paso 3: Probar la conexión y solucionar errores comunes

Una vez que hayas configurado wp-config.php, intenta acceder a tu sitio web. Si todo está bien, verás la pantalla de instalación de WordPress (o tu sitio ya funcionando). Si no, aparecerán mensajes de error. Aquí tienes los más frecuentes y cómo solucionarlos.

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

Este es el error más común. Significa que WordPress no puede comunicarse con MySQL.

Posibles causas y soluciones:

Datos incorrectos: Revisa que el nombre, usuario y contraseña sean exactos. Un espacio extra o una mayúscula pueden romper la conexión.
Servidor de base de datos erróneo: Si tu hosting usa un servidor remoto (no localhost), cámbialo en DB_HOST. Pregunta a tu proveedor de hosting.
Base de datos no creada: Asegúrate de que la base de datos exista y tenga al menos una tabla. Si creaste la base de datos pero está vacía, WordPress la llenará durante la instalación.

Error 2: "No se encuentra la base de datos"

Este error indica que el nombre de la base de datos no existe en el servidor MySQL.

Solución:

Verifica que el nombre en DB_NAME coincida con el que creaste. En algunos paneles (como Syspanel), el nombre puede tener un prefijo (ej: admin_mipagina).
Si usas Syspanel, revisa en la sección Bases de datos que el nombre esté escrito correctamente.

Error 3: "Permiso denegado para el usuario"

El usuario no tiene permisos para acceder a la base de datos.

Solución:

En cPanel o Syspanel, ve a la sección de bases de datos y asegúrate de que el usuario esté asignado a la base de datos con Todos los privilegios.
Si ya estaba asignado, intenta eliminar y volver a asignar el usuario.

[TIP] Si después de corregir los datos sigues viendo el error, espera unos minutos. A veces los cambios en los permisos tardan en propagarse.

Paso 4: Configuraciones avanzadas (opcional pero útil)

Si eres más aventurero, puedes añadir líneas adicionales en wp-config.php para mejorar el rendimiento o la seguridad.

Prefijo de tabla

Por defecto, las tablas de WordPress empiezan con wp_. Puedes cambiarlo por seguridad:

$table_prefix = 'wp_';  // Cámbialo a algo único, como 'miweb_'

Modo de depuración

Si estás desarrollando o resolviendo errores, activa el modo debug:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Esto creará un archivo debug.log en la carpeta wp-content con información detallada de los errores.

Salts de seguridad

WordPress incluye claves de seguridad (salts) que protegen las cookies y sesiones. Si no las ves, añádelas:

define('AUTH_KEY',         'frase aleatoria larga');
define('SECURE_AUTH_KEY',  'frase aleatoria larga');
define('LOGGED_IN_KEY',    'frase aleatoria larga');
define('NONCE_KEY',        'frase aleatoria larga');
define('AUTH_SALT',        'frase aleatoria larga');
define('SECURE_AUTH_SALT', 'frase aleatoria larga');
define('LOGGED_IN_SALT',   'frase aleatoria larga');
define('NONCE_SALT',       'frase aleatoria larga');

Puedes generar claves únicas en el sitio oficial de WordPress: https://api.wordpress.org/secret-key/1.1/salt/.

Preguntas frecuentes (FAQ)

¿Qué hago si no encuentro el archivo wp-config.php?

Si no existe, puedes crearlo. Descarga una copia de wp-config-sample.php (que viene con WordPress), renómbrala a wp-config.php y edítala con tus datos.

¿Puedo usar una base de datos remota (como Amazon RDS)?

Sí. Solo cambia DB_HOST por la dirección del servidor remoto (ej: mibase.xyz.rds.amazonaws.com). Asegúrate de que tu servidor web tenga permisos de conexión a esa IP.

¿Cómo sé si mi hosting usa Syspanel?

Pregunta a tu proveedor o intenta acceder a tudominio.com:2106. Si ves una pantalla de inicio de sesión, es Syspanel.

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

Deberás actualizar el valor de DB_PASSWORD en wp-config.php y guardar el archivo. Tu sitio dejará de funcionar hasta que lo hagas.

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

Sí, es la práctica estándar. El archivo está fuera del directorio público de WordPress (por seguridad), y solo el servidor puede leerlo. Además, nunca compartas tu archivo wp-config.php.

Conclusión: Tu primer paso hacia un sitio funcional

Conectar WordPress a una base de datos MySQL es un proceso que, una vez entendido, se vuelve automático. Ahora sabes que solo necesitas cuatro datos, un archivo y un poco de paciencia para solucionar errores. Recuerda:

Siempre haz una copia de seguridad de wp-config.php antes de editarlo.
Verifica dos veces los nombres y contraseñas.
Si te atascas, usa el modo debug para obtener pistas.

Con esta guía, ya estás listo para montar tu propio sitio WordPress desde cero. ¡Manos a la obra y a crear contenido!