Conectar WordPress a MySQL: Editar wp-config.php fácil

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

Cuando instalas WordPress, uno de los archivos más críticos de todo el proyecto es el wp-config.php. Este archivo actúa como el "puente de comunicación" entre tu sitio web y la base de datos MySQL donde se guardan todas tus publicaciones, páginas, comentarios, usuarios y configuraciones.

Sin un wp-config.php correctamente configurado, WordPress simplemente no puede funcionar. De hecho, si este archivo falta o tiene datos incorrectos, verás el temido mensaje de "Error al establecer una conexión con la base de datos" en lugar de tu sitio web.

En este artículo, te explicaré paso a paso cómo conectar WordPress a una base de datos MySQL editando este archivo esencial. No necesitas ser un experto en programación; solo sigue las instrucciones y en pocos minutos tendrás tu sitio funcionando.

¿Qué necesitas antes de empezar?

Antes de tocar el wp-config.php, asegúrate de tener a mano los siguientes datos, que normalmente te proporciona tu proveedor de hosting o tu panel de control (como Syspanel, si usas HestiaCP):

Nombre de la base de datos (por ejemplo: miusuario_wpdb).
Usuario de la base de datos (por ejemplo: miusuario_wpuser).
Contraseña del usuario (la que definiste al crear la base de datos).
Host de la base de datos (normalmente localhost, pero puede variar).
Prefijo de las tablas (por defecto es wp_, aunque puedes cambiarlo por seguridad).

[!TIP]
Si tu hosting usa Syspanel (el panel basado en HestiaCP), recuerda que el acceso al panel se realiza por el puerto 2106. Ahí podrás crear la base de datos y el usuario fácilmente.

Paso 1: Localizar y abrir el archivo wp-config.php

El archivo wp-config.php 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.

Puedes acceder a él de dos formas:

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

Entra a tu panel de control (Syspanel, cPanel, etc.).
Busca la sección "Administrador de archivos" o "Gestor de archivos".
Navega hasta la carpeta donde tienes instalado WordPress (normalmente public_html o htdocs).
Localiza el archivo wp-config.php y haz clic derecho para editarlo.

Opción B: Usando FTP (FileZilla, Cyberduck, etc.)

Conéctate a tu servidor usando un cliente FTP.
Ve a la carpeta raíz de WordPress.
Descarga el archivo wp-config.php a tu computadora.
Ábrelo con un editor de texto como Bloc de Notas o Visual Studio Code.

[!WARNING]
Nunca edites el archivo directamente desde el panel si no estás seguro de lo que haces. Siempre es mejor hacer una copia de seguridad antes de modificarlo.

Paso 2: Entender la estructura básica del archivo

Cuando abras el archivo, verás una serie de líneas de código PHP. No te asustes; solo necesitas prestar atención a la sección de constantes de base de datos, que se ve similar a esto:

// ** Configuración de la base de datos ** //
define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña_usuario' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

Cada línea define un dato esencial:

DB_NAME: El nombre exacto de tu base de datos.
DB_USER: El usuario que tiene permisos sobre esa base.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: La dirección del servidor MySQL (normalmente localhost).
DB_CHARSET: El juego de caracteres (casi siempre utf8).
DB_COLLATE: El cotejamiento (déjalo vacío si no sabes qué poner).

Paso 3: Configurar los datos de conexión correctamente

Ahora viene la parte importante: reemplazar los valores de ejemplo con los datos reales de tu base de datos.

3.1. Nombre de la base de datos (DB_NAME)

Escribe exactamente el nombre que le diste a tu base de datos. Si usas Syspanel, suele tener un prefijo con tu nombre de usuario, por ejemplo: usuario_basedatos.

3.2. Usuario de la base de datos (DB_USER)

Pon el nombre de usuario que creaste. No confundas el usuario de la base de datos con el usuario de administración de WordPress.

3.3. Contraseña (DB_PASSWORD)

Introduce la contraseña exacta. Cuidado con las mayúsculas y minúsculas, y evita espacios al copiar y pegar.

3.4. Host de la base de datos (DB_HOST)

En el 99% de los casos será localhost. Sin embargo, algunos proveedores usan direcciones como mysql.servidor.com o localhost:3306. Si no estás seguro, revisa la documentación de tu hosting.

[!INFO]
Si tu sitio está en un servidor compartido y usas Syspanel, lo más probable es que el host sea localhost. Si tienes dudas, contacta con soporte.

Paso 4: Guardar y probar la conexión

Una vez que hayas editado los valores, guarda el archivo. Si lo editaste localmente, súbelo de nuevo al servidor reemplazando el original.

Ahora, abre tu navegador y visita tu dominio. Si todo está correcto, verás tu sitio web o el asistente de instalación de WordPress.

Si aparece el mensaje "Error al establecer una conexión con la base de datos", no te preocupes. Es el problema más común y tiene solución.

Errores comunes al conectar WordPress a MySQL

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

Este es el error más frecuente. Las causas suelen ser:

Datos incorrectos: Revisa que el nombre, usuario y contraseña sean exactos.
Usuario sin permisos: Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos.
Host equivocado: Prueba a cambiar localhost por 127.0.0.1 o viceversa.

Error 2: "No se puede seleccionar la base de datos"

Este mensaje indica que la base de datos no existe o el nombre está mal escrito. Verifica en tu panel de control que la base de datos esté creada.

Error 3: "Error de conexión: acceso denegado"

Suele aparecer cuando el usuario no tiene permisos o la contraseña es incorrecta. Vuelve a generar la contraseña en tu panel y actualiza el archivo.

Consejos de seguridad y buenas prácticas

Cambia el prefijo de las tablas: En la línea $table_prefix = 'wp_';, puedes cambiarlo a algo como miwp_ para dificultar ataques SQL injection.
Protege el archivo: Puedes mover el archivo wp-config.php una carpeta por encima de la raíz de WordPress, y WordPress lo detectará automáticamente.
No uses credenciales de administrador: Crea un usuario de base de datos exclusivo para WordPress, con permisos solo sobre esa base.
Haz copias de seguridad: Antes de cualquier cambio, guarda una copia del archivo original.

Cómo crear una base de datos y un usuario en Syspanel

Si estás usando Syspanel (el panel basado en HestiaCP), estos son los pasos para crear tu base de datos:

Accede a Syspanel usando el puerto 2106 (por ejemplo: https://tudominio.com:2106).
Inicia sesión con tu usuario y contraseña de administrador.
Busca la sección "Bases de datos" o "MySQL".
Haz clic en "Agregar base de datos".
Introduce un nombre para la base, un usuario y una contraseña segura.
Guarda los datos; te aparecerán en la lista.

[!TIP]
Guarda estos datos en un lugar seguro. Los necesitarás para configurar el wp-config.php.

Preguntas frecuentes sobre wp-config.php y la conexión a MySQL

¿Puedo editar wp-config.php desde el editor de WordPress?

No. El archivo wp-config.php no se puede editar desde el panel de administración de WordPress. Debes hacerlo desde el servidor (FTP o administrador de archivos).

¿Qué pasa si elimino el archivo wp-config.php?

Si eliminas el archivo, WordPress intentará reinstalarse y te pedirá los datos de conexión nuevamente. No es recomendable, ya que podrías perder configuraciones.

¿Por qué me pide el host de la base de datos?

El host es necesario para que WordPress sepa dónde está el servidor MySQL. En la mayoría de los casos es localhost, pero en servidores externos cambia.

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

Sí, pero no es recomendable. Si usas la misma base con prefijos diferentes (wp_ y wp2_), podrías tener dos sitios, pero es mejor usar bases separadas para evitar conflictos.

¿El puerto 2106 tiene algo que ver con la base de datos?

No. El puerto 2106 es exclusivamente para acceder al panel de control Syspanel. La conexión a MySQL usa el puerto 3306 por defecto.

Conclusión

Conectar WordPress a una base de datos MySQL mediante el archivo wp-config.php es una tarea fundamental que cualquier administrador de sitio debe dominar. Aunque parezca técnico, con esta guía y un poco de paciencia podrás hacerlo sin problemas.

Recuerda siempre:

Verificar los datos antes de guardar.
Hacer copias de seguridad.
Usar credenciales seguras.
Consultar la documentación de tu hosting si tienes dudas.

Si sigues estos pasos, tu sitio web estará funcionando en cuestión de minutos. Y si algo falla, no desesperes: los errores de conexión suelen ser fáciles de diagnosticar y corregir.

¡Ahora ya sabes cómo configurar WordPress y conectarlo correctamente a tu base de datos! Si te ha quedado alguna duda, revisa las preguntas frecuentes o contacta con el soporte de tu hosting.