Conectar base de datos MySQL con WordPress: editar wp-config.php

Has llegado al lugar indicado si estás buscando una guía clara y completa sobre cómo conectar una base de datos MySQL con WordPress editando el archivo wp-config.php. Entender este proceso es fundamental para que tu sitio web funcione correctamente, ya que WordPress necesita una base de datos para almacenar todo tu contenido: entradas, páginas, usuarios, comentarios y configuraciones.

Si alguna vez has visto el temido mensaje "Error al establecer una conexión con la base de datos", no te preocupes. Aquí te explicaremos paso a paso cómo solucionarlo y, lo más importante, cómo configurarlo desde cero para que no vuelva a ocurrir. Esta guía está pensada para usuarios sin experiencia técnica, así que iremos despacio, explicando cada término y cada acción.

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

El archivo wp-config.php es el corazón de la configuración de WordPress. Es un archivo de texto que se encuentra en la carpeta raíz de tu instalación de WordPress (normalmente en /public_html/ o /www/). Su función principal es decirle a WordPress cómo conectarse a su base de datos MySQL. Sin este archivo correctamente configurado, WordPress no puede funcionar.

Dentro de wp-config.php se definen, entre otras cosas:

El nombre de la base de datos.
El usuario de la base de datos.
La contraseña de ese usuario.
El servidor de la base de datos (normalmente localhost).
El prefijo de las tablas (por defecto wp_).
Claves de seguridad y otras optimizaciones.

[INFO] Si estás usando un panel de control como Syspanel (antes conocido como HestiaCP), recuerda que el acceso a tu panel se realiza a través del puerto 2106. Por ejemplo: https://tudominio.com:2106. Allí podrás gestionar tus bases de datos y usuarios MySQL.

Requisitos previos antes de empezar

Antes de lanzarnos a editar el archivo, asegúrate de tener a mano la siguiente información. Te será más fácil si la anotas en un papel o en un bloc de notas:

Nombre de la base de datos MySQL (ejemplo: miusuario_wordpress).
Nombre de usuario de la base de datos (ejemplo: miusuario_wpuser).
Contraseña del usuario de la base de datos (la que elegiste al crearla).
Servidor de la base de datos (normalmente localhost, aunque en algunos hosting compartidos puede ser algo como mysql.tudominio.com).
Acceso a tu panel de control (cPanel, Syspanel, Plesk, etc.) para crear la base de datos si aún no la tienes.

Si no tienes una base de datos creada, no te preocupes. Te explicamos cómo hacerlo en los siguientes pasos.

Paso 1: Crear la base de datos MySQL y un usuario

WordPress no puede funcionar sin una base de datos. Si ya tienes una, puedes saltar al Paso 2. Si no, sigue estos pasos desde tu panel de control. Usaremos Syspanel como ejemplo, pero el proceso es similar en cPanel o Plesk.

Crear la base de datos en Syspanel (HestiaCP)

Accede a tu panel Syspanel a través del puerto 2106: https://tudominio.com:2106.
Inicia sesión con tus credenciales de administrador.
Busca la sección "Base de datos" o "MySQL".
Haz clic en "Añadir base de datos".
Completa los campos:
- Nombre de la base de datos: elige un nombre descriptivo, por ejemplo miblog_db.
- Usuario: puede ser el mismo nombre o uno diferente, por ejemplo miblog_user.
- Contraseña: genera una segura o escribe una que recuerdes. Guárdala bien.
Haz clic en "Guardar" o "Crear".

[TIP] Anota el nombre de la base de datos, el usuario y la contraseña exactamente como los escribiste. Los necesitarás para el archivo wp-config.php.

Crear la base de datos en cPanel

Inicia sesión en tu cPanel.
Busca la sección "Bases de datos" y haz clic en "MySQL Databases".
En "Create New Database", escribe un nombre (ejemplo: wordpress_db) y haz clic en "Create Database".
Ve a "MySQL Users" y crea un nuevo usuario (ejemplo: wp_user) con una contraseña segura.
Luego, en "Add User to Database", selecciona el usuario y la base de datos que acabas de crear, y otórgale todos los privilegios.

Ya tienes tu base de datos lista.

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

Ahora viene la parte práctica. Necesitas acceder a los archivos de tu sitio web. Puedes hacerlo mediante FTP (con FileZilla, por ejemplo) o a través del administrador de archivos de tu panel de control.

Opción A: Usando el administrador de archivos de Syspanel

Accede a Syspanel (puerto 2106).
Ve a la sección "Archivos" o "File Manager".
Navega hasta la carpeta donde instalaste WordPress (normalmente public_html o una subcarpeta como blog).
Busca el archivo llamado wp-config.php. Si no existe, puedes copiar el archivo wp-config-sample.php y renombrarlo como wp-config.php. Luego edítalo.

Opción B: Usando FTP

Conéctate a tu servidor con un cliente FTP (FileZilla, Cyberduck, etc.).
Navega hasta la carpeta raíz de tu sitio (normalmente /public_html/).
Busca el archivo wp-config.php. Si no está, busca wp-config-sample.php y renómbralo.
Descarga el archivo a tu computadora para editarlo con un editor de texto plano (como Notepad++, Sublime Text o incluso el Bloc de notas).

Paso 3: Configurar los datos de conexión a la base de datos

Abre el archivo wp-config.php con tu editor. Verás muchas líneas de código PHP. No te asustes. Solo necesitas modificar las primeras líneas, donde se definen las constantes de la base de datos.

Busca esta sección:

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

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

/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );

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

Ahora reemplaza los valores de ejemplo con la información que guardaste antes:

DB_NAME: escribe el nombre de tu base de datos (ejemplo: miblog_db).
DB_USER: el usuario que creaste (ejemplo: miblog_user).
DB_PASSWORD: la contraseña de ese usuario.
DB_HOST: normalmente localhost. Si tu hosting te proporciona un host diferente (como mysql.tudominio.com), escríbelo exactamente.

[WARNING] Asegúrate de no dejar espacios adicionales ni comillas incorrectas. El formato debe ser exactamente igual al ejemplo, solo cambiando el texto entre comillas simples.

¿Qué pasa si no recuerdas el host?

En la mayoría de los hosting compartidos, el host es localhost. Si no funciona, contacta con tu proveedor de hosting o revisa el panel de control. En Syspanel, por ejemplo, suele ser localhost. Si usas servicios como DreamHost o SiteGround, a veces es un valor diferente, pero lo encontrarás en la sección de bases de datos de tu panel.

Paso 4: Configurar el prefijo de las tablas (opcional pero recomendado)

Justo debajo de las líneas anteriores, verás:

$table_prefix = 'wp_';

Este es el prefijo que WordPress añade a todas sus tablas en la base de datos. Por defecto es wp_. Por seguridad, es recomendable cambiarlo a algo único, como miwp_ o blog2025_. Esto dificulta los ataques de inyección SQL. Simplemente cambia el texto entre comillas.

Paso 5: Guardar y subir el archivo

Una vez que hayas modificado los datos, guarda el archivo.

Si lo editaste localmente, súbelo de nuevo al servidor mediante FTP, reemplazando el archivo existente.
Si lo editaste desde el administrador de archivos, simplemente haz clic en "Guardar".

[TIP] Siempre es buena idea hacer una copia de seguridad del archivo original antes de modificarlo, por si algo sale mal.

Paso 6: Probar la conexión

Ahora viene el momento de la verdad. Abre tu navegador y visita la URL de tu sitio web (por ejemplo, tudominio.com o tudominio.com/wp-admin).

Si todo está correcto, verás la pantalla de instalación de WordPress (si es la primera vez) o tu panel de administración.
Si ves el mensaje "Error al establecer una conexión con la base de datos", no entres en pánico. Revisa los pasos anteriores: asegúrate de que el nombre de la base de datos, usuario y contraseña sean exactamente los que creaste. También verifica que el host sea el correcto.

Solución de errores comunes (FAQ)

Aquí tienes las preguntas más frecuentes que recibimos en soporte técnico. Si algo no funciona, revisa esta lista.

1. "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: Revisa DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. Un simple error tipográfico (una letra mayúscula o un espacio) puede causar este fallo.
El usuario no tiene permisos: Asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos. En Syspanel, al crear la base de datos, esto se hace automáticamente. En cPanel, debes agregar el usuario a la base de datos y asignarle privilegios.
El servidor de base de datos no responde: Si tu hosting tiene problemas, contacta con soporte. También puedes probar cambiando localhost por 127.0.0.1 en DB_HOST.

2. "No se encuentra la base de datos"

Esto suele ocurrir si el nombre de la base de datos es incorrecto o si no se ha creado. Vuelve a tu panel y verifica que la base de datos exista.

3. "La conexión fue rechazada"

Puede deberse a que el usuario no tiene permisos para conectarse desde tu IP o a que el servidor MySQL está configurado para aceptar solo conexiones locales. En hosting compartido, esto es raro. Si usas un VPS, puede que necesites ajustar la configuración de MySQL.

4. ¿Cómo puedo saber si mi archivo wp-config.php está bien escrito?

Una forma rápida es abrirlo y buscar errores de sintaxis. Por ejemplo, asegúrate de que cada línea termine con punto y coma (;). También verifica que las comillas estén correctamente cerradas. Si no estás seguro, puedes usar un validador de PHP online.

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

Si es una instalación nueva, es posible que solo tengas el archivo wp-config-sample.php. Simplemente renómbralo a wp-config.php y luego edítalo. Si ya tienes WordPress instalado y no ves el archivo, puede que esté oculto. En tu cliente FTP, activa la opción "Mostrar archivos ocultos".

Consejos adicionales para una configuración segura

Además de conectar la base de datos, hay algunas buenas prácticas que te recomendamos seguir:

Cambia el prefijo de las tablas como mencionamos antes.
Añade claves de seguridad: En el archivo wp-config.php hay una sección con define('AUTH_KEY', ...). Si no ves valores, puedes generarlos automáticamente desde la página oficial de WordPress (https://api.wordpress.org/secret-key/1.1/salt/). Copia y pega todo el bloque.
No uses el usuario "root" de MySQL para WordPress. Siempre crea un usuario específico para tu sitio.
Haz copias de seguridad periódicas de tu base de datos. Puedes usar plugins como UpdraftPlus o hacerlo manualmente desde Syspanel o cPanel.

Resumen rápido

Crea una base de datos MySQL y un usuario con todos los privilegios.
Localiza o crea el archivo wp-config.php en la raíz de tu WordPress.
Edita las líneas DB_NAME, DB_USER, DB_PASSWORD y DB_HOST con tus datos.
Cambia el prefijo de tablas por seguridad.
Guarda el archivo y prueba tu sitio.
Si aparece un error, revisa los datos y los permisos del usuario.

[INFO] Recuerda que si usas Syspanel (HestiaCP), el acceso a tu panel es a través del puerto 2106. Allí podrás gestionar todas tus bases de datos de manera sencilla.

Conclusión

Conectar una base de datos MySQL con WordPress editando el archivo wp-config.php es un proceso sencillo una vez que entiendes qué datos necesitas y dónde colocarlos. Esperamos que esta guía te haya sido de gran ayuda y que ahora puedas resolver cualquier problema de conexión por ti mismo.

Si después de seguir todos los pasos sigues teniendo problemas, no dudes en contactar con el soporte técnico de tu hosting. Ellos podrán verificar la configuración del servidor y ayudarte a solucionar cualquier incidencia.

¡Ahora ya tienes el conocimiento para que tu WordPress y su base de datos trabajen en perfecta armonía!