Conectar WordPress a MySQL | Guía Paso a Paso

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

Antes de empezar, es importante que entiendas la relación entre WordPress y MySQL. WordPress es un sistema de gestión de contenidos (CMS) que utiliza MySQL como su motor de base de datos. Aquí es donde se almacenan todos tus artículos, páginas, comentarios, configuraciones de plugins, usuarios y más. Sin una conexión correcta a la base de datos, WordPress simplemente no funcionará.

Cuando instalas WordPress por primera vez, uno de los pasos más críticos es configurar el archivo wp-config.php para que sepa a qué base de datos MySQL conectarse. Si este archivo no está bien configurado, verás el temido mensaje de error: "Error al establecer una conexión con la base de datos".

En esta guía básica, te explicaré paso a paso cómo conectar WordPress a una base de datos MySQL, ya sea que estés usando un panel de control como cPanel, Syspanel (antes conocido como HestiaCP) o incluso si lo haces de forma manual.

Requisitos previos para conectar WordPress a MySQL

Antes de comenzar, asegúrate de tener lo siguiente:

Un servidor web (Apache, Nginx, LiteSpeed, etc.) con PHP y MySQL instalados.
Acceso a un panel de control como cPanel, Syspanel (puerto 2106) o phpMyAdmin.
Un nombre de dominio o una dirección IP donde alojarás tu sitio.
Los datos de tu base de datos MySQL: nombre de la base de datos, usuario, contraseña y servidor (normalmente localhost).

[INFO] Si usas Syspanel (HestiaCP), recuerda que el acceso al panel es a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Allí podrás crear bases de datos y usuarios fácilmente.

Paso 1: Crear la base de datos MySQL

Lo primero que necesitas es una base de datos vacía donde WordPress guardará toda la información. Aquí te explico cómo hacerlo en los paneles más comunes:

En cPanel

Inicia sesión en tu cPanel.
Busca la sección Bases de Datos y haz clic en MySQL Databases.
En el campo Create New Database, escribe un nombre (por ejemplo: wordpress_db).
Haz clic en Create Database.
Ve a MySQL Users y crea un nuevo usuario (por ejemplo: wp_user). Asigna una contraseña segura.
En Add User to Database, selecciona el usuario y la base de datos que acabas de crear.
Marca ALL PRIVILEGES y haz clic en Make Changes.

En Syspanel (HestiaCP)

Accede a Syspanel usando el puerto 2106: https://tudominio.com:2106.
Inicia sesión con tus credenciales de administrador.
Ve a la sección Base de datos o Databases.
Haz clic en Add Database.
Completa los campos:
- Database Name: wordpress_db
- User: wp_user
- Password: Elige una contraseña segura (o usa el generador).
Haz clic en Save. Syspanel creará automáticamente la base de datos y el usuario con todos los privilegios.

[TIP] Anota en un bloc de notas los siguientes datos: nombre de la base de datos, usuario, contraseña y servidor (normalmente localhost). Los necesitarás más adelante.

Paso 2: Descargar e instalar WordPress

Ahora que tienes tu base de datos lista, es momento de descargar WordPress. Puedes hacerlo de dos formas:

Opción A: Instalación manual desde wordpress.org

Ve a wordpress.org y descarga el archivo .zip más reciente.
Descomprime el archivo en tu computadora.
Sube todos los archivos a la raíz de tu sitio web (por ejemplo, public_html) mediante FTP (FileZilla) o el administrador de archivos de tu panel.
Una vez subidos, abre tu navegador y ve a tudominio.com. Aparecerá el asistente de instalación de WordPress.

Opción B: Instalación automática desde el panel

cPanel: Busca la sección Softaculous o Instalador de WordPress. Sigue los pasos guiados.
Syspanel: Ve a Web > Quick Installer y selecciona WordPress. Completa los campos con los datos de tu base de datos.

[WARNING] Si usas la instalación automática, asegúrate de que los datos de la base de datos que ingreses coincidan exactamente con los que creaste en el paso anterior. Un error común es escribir mal el nombre del usuario o la contraseña.

Paso 3: Configurar el archivo wp-config.php

El archivo wp-config.php es el corazón de la conexión entre WordPress y MySQL. Si no existe, puedes crearlo manualmente. Aquí te explico cómo:

Localizar o crear wp-config.php

En la carpeta raíz de tu instalación de WordPress, busca el archivo wp-config-sample.php.
Renómbralo a wp-config.php (o haz una copia y luego renómbrala).
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, VS Code, etc.).

Editar las constantes de la base de datos

Dentro del archivo, busca las siguientes líneas y reemplázalas con tus datos:

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'nombre_de_tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' ); // Normalmente es localhost, pero puede variar

Ejemplo real:

define( 'DB_NAME', 'wordpress_db' );
define( 'DB_USER', 'wp_user' );
define( 'DB_PASSWORD', 'MiContraseñaSegura123' );
define( 'DB_HOST', 'localhost' );

[INFO] El DB_HOST suele ser localhost, pero en algunos servidores compartidos o configuraciones especiales puede ser una dirección IP o un nombre de host como mysql.tudominio.com. Si no estás seguro, consulta con tu proveedor de hosting.

Guardar y subir el archivo

Guarda los cambios y sube el archivo wp-config.php a la raíz de tu sitio web (si lo estás editando localmente). Si ya está en el servidor, simplemente sobreescribe el archivo.

Paso 4: Ejecutar la instalación de WordPress

Una vez que el archivo wp-config.php está configurado y la base de datos está creada, es momento de completar la instalación:

Abre tu navegador y ve a tudominio.com.
Verás la pantalla de bienvenida de WordPress. Selecciona tu idioma y haz clic en Continuar.
Completa los siguientes campos:
- Título del sitio: El nombre de tu sitio web.
- Nombre de usuario: El administrador de WordPress (elige uno seguro, no "admin").
- Contraseña: Una contraseña fuerte.
- Correo electrónico: Tu dirección de email.
Haz clic en Instalar WordPress.

Si todo está correcto, verás un mensaje de éxito y podrás iniciar sesión en el panel de administración (tudominio.com/wp-admin).

[TIP] Si aparece el error "Error al establecer una conexión con la base de datos", verifica que los datos en wp-config.php sean correctos. También asegúrate de que el servidor MySQL esté funcionando.

Solución de problemas comunes (FAQ)

¿Por qué aparece "Error al establecer una conexión con la base de datos"?

Este es el error más común. Las causas principales son:

Datos incorrectos en wp-config.php: Revisa que DB_NAME, DB_USER, DB_PASSWORD y DB_HOST sean exactamente los que creaste.
El servidor MySQL está caído: Contacta a tu proveedor de hosting.
El usuario no tiene permisos: En tu panel, asegúrate de que el usuario tenga todos los privilegios sobre la base de datos.
El servidor de base de datos no es localhost: Algunos hosts usan direcciones como mysql.tudominio.com. Pregunta a tu soporte técnico.

¿Cómo cambio la contraseña de la base de datos después de instalarla?

Ve a tu panel (cPanel, Syspanel, etc.) y cambia la contraseña del usuario MySQL.
Luego, actualiza el archivo wp-config.php con la nueva contraseña.
Guarda los cambios y recarga tu sitio.

¿Puedo usar una base de datos existente para WordPress?

Sí, pero ten cuidado. Si la base de datos ya tiene tablas, WordPress podría sobrescribirlas o causar conflictos. Es mejor usar una base de datos vacía o con un prefijo de tabla diferente (por ejemplo, wp_).

¿Qué hago si no tengo acceso a un panel de control?

Puedes crear la base de datos y el usuario mediante comandos SQL si tienes acceso a la línea de comandos de MySQL. Por ejemplo:

CREATE DATABASE wordpress_db;
CREATE USER 'wp_user'@'localhost' IDENTIFIED BY 'MiContraseñaSegura123';
GRANT ALL PRIVILEGES ON wordpress_db.* TO 'wp_user'@'localhost';
FLUSH PRIVILEGES;

Luego, configura wp-config.php con esos datos.

Consejos finales para una conexión exitosa

Usa contraseñas seguras: Tanto para el usuario de la base de datos como para el administrador de WordPress.
Haz copias de seguridad: Antes de hacer cambios importantes, respalda tu base de datos.
Actualiza regularmente: Mantén WordPress, plugins y temas actualizados para evitar vulnerabilidades.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y que la gestión de bases de datos es muy intuitiva.

Conectar WordPress a una base de datos MySQL no es complicado si sigues estos pasos. Una vez que lo hagas una o dos veces, verás que es un proceso sencillo y rápido. ¡Ahora ya tienes todo lo necesario para lanzar tu sitio web!

[WARNING] Nunca compartas tu archivo wp-config.php ni los datos de acceso a tu base de datos. Es información sensible que podría comprometer tu sitio.

Si te quedó alguna duda, revisa la sección de FAQ o consulta con tu proveedor de hosting. ¡Buena suerte con tu instalación!