Conectar base de datos MySQL a WordPress: tutorial

¿Alguna vez te has preguntado cómo es que WordPress guarda todas tus entradas, páginas, comentarios y configuraciones? Todo ese contenido vital se almacena en una base de datos, y la más común para WordPress es MySQL. Conectar tu sitio web a su base de datos es el paso fundamental para que todo funcione, y aunque suene a cosa de hackers, es un proceso muy sencillo que puedes hacer tú mismo.

En esta guía completa, te explicaré paso a paso cómo conectar tu base de datos MySQL con WordPress. No necesitas ser un experto en programación; solo sigue estas instrucciones y en pocos minutos tu sitio estará en línea. Vamos a sumergirnos en el archivo mágico que hace posible esta conexión: el famoso wp-config.php.

¿Qué es la conexión entre WordPress y MySQL?

Imagina que WordPress es la fachada de una tienda (tu sitio web) y MySQL es el almacén donde guardas todos los productos, los precios y la información de los clientes. Sin una conexión entre ambos, la tienda no puede funcionar. La base de datos MySQL es donde se guarda:

Todo el contenido de tus páginas y entradas.
Los usuarios y sus contraseñas.
Los comentarios y ajustes del tema.
Los plugins y su configuración.

Cuando instalas WordPress por primera vez, el instalador te pide los datos de conexión a la base de datos. Si no lo hiciste en ese momento o necesitas cambiar la base de datos por algún motivo (por ejemplo, al migrar tu web a un nuevo hosting), tendrás que editarlo manualmente. No te preocupes, es pan comido.

Requisitos previos antes de empezar

Antes de tocar nada, asegúrate de tener a mano lo siguiente:

Acceso a tu panel de control de hosting. (Por ejemplo, cPanel, Syspanel, Plesk, etc.).
Los datos de tu base de datos MySQL: Nombre de la base de datos, usuario y contraseña.
Acceso a los archivos de tu web. Puedes hacerlo mediante FTP (FileZilla) o desde el administrador de archivos de tu hosting.
Un editor de texto plano. (Como Notepad++, Sublime Text o el Bloc de notas de Windows). Evita procesadores de texto como Word, ya que pueden añadir caracteres extraños.

[INFO] Si tu hosting usa Syspanel (anteriormente HestiaCP), recuerda que el acceso al panel se hace a través del puerto 2106 (ejemplo: tudominio.com:2106). Allí podrás gestionar tus bases de datos.

Paso 1: Crear o localizar tu base de datos MySQL

Lo primero es tener una base de datos lista. Si ya tienes una, puedes saltarte este paso. Si no, vamos a crearla desde tu panel de control.

Crear una base de datos en cPanel (el más común)

Inicia sesión en tu cPanel.
Busca la sección "Bases de Datos" y haz clic en "Asistente de MySQL" o "Bases de Datos MySQL".
Sigue el asistente:
- Paso 1: Crea un nombre para tu base de datos. (Ej: mipagina_wp).
- Paso 2: Crea un usuario y una contraseña segura. (Ej: usuario_wp).
- Paso 3: Asigna todos los privilegios al usuario sobre la base de datos. Marca la casilla "Todos los privilegios".
¡Listo! Anota el nombre de la base de datos, el usuario y la contraseña. Los necesitarás en el siguiente paso.

Crear una base de datos en Syspanel (HestiaCP)

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

Accede a tu Syspanel a través del puerto 2106 (ej: tudominio.com:2106).
Ve a la sección "Bases de Datos".
Haz clic en "Añadir Base de Datos".
Completa los campos:
- Base de datos: Dale un nombre descriptivo.
- Usuario: Crea un nombre de usuario.
- Contraseña: Genera una segura (puedes usar el generador que te ofrece el panel).
Haz clic en "Guardar". El sistema creará automáticamente la base de datos, el usuario y te asignará los permisos.

Paso 2: Localizar el archivo wp-config.php

Este es el archivo más importante de tu instalación de WordPress. Es como el cerebro que le dice a tu sitio cómo conectarse con la base de datos. Se encuentra en la carpeta raíz de tu web (normalmente llamada public_html o www).

Para acceder a él, tienes dos opciones:

Opción A: Desde el administrador de archivos de tu hosting

Ingresa a tu panel de control (cPanel, Syspanel, etc.).
Busca la herramienta "Administrador de Archivos".
Navega hasta la carpeta raíz de tu sitio (generalmente public_html o www).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de que estás mostrando archivos ocultos (suele haber un botón para ello).

Opción B: A través de FTP (FileZilla)

Conéctate a tu servidor usando un cliente FTP (FileZilla, Cyberduck, etc.).
Introduce los datos de conexión FTP que te proporcionó tu hosting (servidor, usuario, contraseña y puerto, normalmente 21).
Una vez conectado, navega hasta la carpeta raíz de tu web.
Localiza el archivo wp-config.php.

Paso 3: Editar el archivo wp-config.php

Una vez que tengas el archivo localizado, ábrelo con tu editor de texto plano. Verás un montón de código PHP, pero no te asustes. Solo necesitas modificar una pequeña sección.

Encuentra la sección de configuración de la base de datos

Busca las siguientes líneas dentro del archivo. Deberían verse algo así:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'nombre_de_tu_bd' );

/** MySQL database username */
define( 'DB_USER', 'tu_usuario' );

/** MySQL database password */
define( 'DB_PASSWORD', 'tu_contraseña' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

/** Database Charset to use in creating database tables. */
define( 'DB_CHARSET', 'utf8' );

/** The Database Collate type. Don't change this if in doubt. */
define( 'DB_COLLATE', '' );

Modifica los valores con tus datos

Ahora es el momento de reemplazar los valores de ejemplo con los datos reales de tu base de datos MySQL.

DB_NAME: Aquí pones el nombre exacto de tu base de datos. Por ejemplo: define( 'DB_NAME', 'mipagina_wp' );
DB_USER: El nombre del usuario que creaste. Ejemplo: define( 'DB_USER', 'usuario_wp' );
DB_PASSWORD: La contraseña que asignaste a ese usuario. Ejemplo: define( 'DB_PASSWORD', 'MiContraseñaSegura123!' );
DB_HOST: Este valor casi siempre es localhost. Sin embargo, en algunos hostings compartidos o avanzados, puede ser una dirección IP o un nombre de servidor. Si no estás seguro, déjalo como 'localhost'. Si tu hosting te proporciona un host específico, sustitúyelo.
DB_CHARSET y DB_COLLATE: No los toques a menos que sepas lo que haces. Por defecto, 'utf8' es perfecto.

[WARNING] Guarda siempre una copia de seguridad del archivo original antes de modificarlo. Si algo sale mal, puedes restaurarlo fácilmente.

Guarda los cambios

Una vez que hayas reemplazado todos los valores, guarda el archivo desde tu editor de texto. Asegúrate de que el nombre del archivo siga siendo wp-config.php y que la extensión sea .php, no .txt.

Paso 4: Subir el archivo modificado (si lo editaste localmente)

Si editaste el archivo desde tu ordenador (por ejemplo, descargándolo por FTP), ahora tienes que subirlo de vuelta al servidor.

Abre tu cliente FTP (FileZilla).
Conéctate a tu servidor.
Ve a la carpeta raíz de tu web (public_html o www).
Arrastra el archivo wp-config.php modificado desde tu ordenador a esa carpeta.
Cuando te pregunte si quieres sobrescribir el archivo existente, haz clic en "Sobrescribir" o "Reemplazar".

Si lo editaste directamente desde el administrador de archivos de tu hosting, no necesitas subir nada; los cambios ya están guardados.

Paso 5: Verificar la conexión

Ahora viene la parte emocionante: comprobar si todo funciona.

Abre tu navegador web.
Escribe la URL de tu sitio web (por ejemplo, tudominio.com o tudominio.com/wp-admin).
Si la conexión es correcta, WordPress cargará tu sitio sin problemas. Si ya tenías contenido, lo verás tal cual. Si es una instalación nueva, te pedirá que configures el sitio.
Si ves un error como "Error establishing a database connection", algo salió mal. No te preocupes, es el error más común y suele ser fácil de solucionar.

Solución de problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes y sus respuestas para que puedas resolver cualquier problema.

¿Por qué veo "Error establishing a database connection"?

Este es el error más común y significa que WordPress no puede comunicarse con MySQL. Las causas más probables son:

Datos incorrectos en wp-config.php: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste. Un error tipográfico es la causa número 1.
El host de la base de datos no es 'localhost': Algunos hostings usan un servidor de base de datos separado. Contacta a tu soporte técnico para obtener el valor correcto de DB_HOST.
La base de datos no existe: Asegúrate de haberla creado correctamente en tu panel de control.
El usuario no tiene permisos: Vuelve a la sección de bases de datos de tu hosting y verifica que el usuario tenga todos los privilegios sobre la base de datos.

¿Qué hago si el error persiste después de revisar los datos?

Prueba lo siguiente:

Verifica el archivo wp-config.php: Asegúrate de que no tenga espacios en blanco o caracteres extraños al principio o al final del archivo.
Comprueba el servidor MySQL: A veces el servidor de base de datos puede estar caído o sobrecargado. Espera unos minutos y vuelve a intentarlo.
Reinicia el servidor web (si tienes acceso): En algunos paneles como Syspanel, puedes reiniciar Apache o Nginx desde la sección de servicios.
Contacta a tu proveedor de hosting: Ellos pueden verificar el estado del servidor MySQL y ayudarte con la configuración.

¿Puedo cambiar la base de datos después de haber creado el sitio?

¡Sí! De hecho, es un proceso común al migrar un sitio web a un nuevo hosting. Solo tienes que:

Exportar tu base de datos antigua desde el panel de control (por ejemplo, usando phpMyAdmin).
Crear una nueva base de datos en el nuevo hosting.
Importar el archivo .sql de la base de datos antigua a la nueva.
Editar el archivo `wp-config.php con los nuevos datos de conexión (nombre de base de datos, usuario, contraseña y host).

¿Qué es 'localhost' en DB_HOST?

'localhost' es la dirección estándar que indica que la base de datos MySQL está en el mismo servidor que tu sitio web. En la mayoría de los hostings compartidos, este es el valor correcto. Si tu hosting tiene una arquitectura más compleja, el valor de DB_HOST te lo proporcionará tu proveedor.

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

Sí, es la forma estándar y segura de hacerlo. El archivo wp-config.php está protegido por el propio WordPress y no es accesible desde el navegador (si está bien configurado). Además, la carpeta donde se encuentra suele tener permisos restringidos. Eso sí, nunca compartas este archivo con nadie.

Consejos finales para una conexión exitosa

[TIP] Siempre utiliza contraseñas fuertes para tu base de datos MySQL. Combina mayúsculas, minúsculas, números y símbolos. Una buena práctica es usar un generador de contraseñas desde tu panel de control.

[INFO] Si tu web usa Syspanel, recuerda que el acceso a phpMyAdmin (para gestionar la base de datos) suele estar disponible desde el mismo panel, en la sección de bases de datos. El puerto de acceso al panel es el 2106.

[WARNING] Nunca modifiques el archivo wp-config.php mientras tu sitio esté recibiendo tráfico intenso o si estás en medio de una actualización. Siempre es mejor hacerlo en un momento de baja actividad.

Conectar tu base de datos MySQL con WordPress es uno de esos procesos que, una vez que lo haces, te das cuenta de lo sencillo que es. Con esta guía, ya tienes todo lo necesario para hacerlo tú mismo, solucionar problemas y mantener tu sitio funcionando sin depender de un técnico. ¡Adelante, tú puedes!