Conectar base de datos MySQL a tu web: Guía universal

¿Qué significa conectar una base de datos MySQL y por qué es tan importante?

Imagina que tu sitio web es una tienda física.
La base de datos MySQL es el almacén donde guardas todos tus productos (artículos, precios, clientes, pedidos).
Sin conexión a ese almacén, tu tienda no puede mostrar nada.

Conectar base de datos MySQL es el proceso de decirle a tu aplicación (WordPress, PrestaShop, etc.) dónde está ese almacén, cómo se llama, quién tiene la llave (usuario y contraseña) y por qué puerta entrar (host y puerto).

Sin esta conexión, tu web no funciona: verás errores como "Error al conectar con la base de datos" o una pantalla en blanco.
Por eso, dominar este paso es fundamental para cualquier persona que gestione un sitio web, aunque no sea desarrollador.

A lo largo de esta guía, te explicaré, paso a paso y sin tecnicismos, cómo realizar esta conexión en los gestores más populares (WordPress y PrestaShop), qué datos necesitas y cómo resolver los problemas más comunes.

Vamos a ello.

Los 4 datos de conexión que necesitas (sí o sí)

Antes de tocar nada, necesitas tener a mano estos 4 datos. Son como las coordenadas GPS de tu base de datos.

Host de la base de datos: Es la dirección del servidor donde vive la base de datos.
Normalmente es localhost si el sitio y la base de datos están en el mismo servidor.
Si usas un hosting externo, suele ser algo como mysql.tudominio.com o db.mihosting.com.
Nombre de la base de datos: Es el nombre del "almacén".
Ejemplo: mipagina_wp o bd_prestashop.
Usuario de la base de datos: Es el usuario que tiene permiso para entrar y gestionar el almacén.
Ejemplo: admin_bd o usuario_mysql.
Contraseña: La llave de acceso. Debe ser segura, con mayúsculas, números y símbolos.
Puerto (opcional pero importante): El puerto por defecto de MySQL es el 3306.
A veces no aparece en los datos que te da tu hosting porque usan el estándar, pero si te indican un puerto diferente (por ejemplo 3307), deberás especificarlo.

[INFO]
En Syspanel (nuestro panel de control, antes conocido como HestiaCP), puedes encontrar estos datos en la sección Bases de Datos.
El acceso a Syspanel es a través del puerto 2106 (por ejemplo: https://tu-servidor:2106).
Ahí verás listadas tus bases de datos y podrás copiar fácilmente los datos de conexión.

Cómo conectar una base de datos MySQL a WordPress

WordPress es el gestor de contenidos (CMS) más usado del mundo.
Conectarlo a una base de datos es un proceso muy sencillo, pero requiere precisión.

Opción A: Instalación desde cero (WordPress aún no instalado)

Si estás instalando WordPress por primera vez, la conexión se hace durante el proceso de instalación.

Descarga e instala WordPress en tu servidor (sube los archivos a tu dominio).
Ve a tu dominio en el navegador (por ejemplo, www.tudominio.com).
Aparecerá el asistente de instalación de WordPress.
Selecciona tu idioma y haz clic en Continuar.
Te pedirá los datos de la base de datos. Aquí es donde debes tener a mano los 4 datos que te mencioné antes.
Rellena los campos:
- Nombre de la base de datos: Escribe el nombre exacto.
- Usuario de la base de datos: El usuario con permisos.
- Contraseña: La contraseña correspondiente.
- Servidor de la base de datos: localhost (o el host que te indique tu hosting).
- Prefijo de tabla: Por defecto es wp_. Puedes cambiarlo por seguridad (por ejemplo, tuprefijo_), pero no es obligatorio.
Haz clic en Enviar.
WordPress comprobará la conexión. Si es correcta, continuarás con la instalación (crear tu usuario administrador, título del sitio, etc.).

[TIP]
Si tu hosting usa un puerto específico para MySQL, en el campo Servidor de la base de datos escribe algo como: localhost:3307.
Así WordPress sabrá que debe conectarse a ese puerto.

Opción B: WordPress ya instalado (cambio de base de datos o migración)

Si tu WordPress ya está funcionando y necesitas cambiar la base de datos (por ejemplo, porque migras de hosting), editarás el archivo wp-config.php.

Accede a tu servidor por FTP (FileZilla, por ejemplo) o desde el administrador de archivos de tu hosting.
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca las líneas que empiezan por define('DB_NAME'..., define('DB_USER'..., etc.
Modifica los valores con los nuevos datos de conexión:

define('DB_NAME', 'nuevo_nombre_bd');
define('DB_USER', 'nuevo_usuario');
define('DB_PASSWORD', 'nueva_contraseña');
define('DB_HOST', 'localhost');

Guarda el archivo y súbelo de nuevo al servidor (reemplazando el anterior).

[WARNING]
Antes de editar wp-config.php, haz una copia de seguridad del archivo original.
Si cometes un error al guardar, tu web dejará de funcionar.
Además, asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre esa base de datos (SELECT, INSERT, UPDATE, DELETE, etc.).

Cómo conectar PrestaShop a una base de datos MySQL

PrestaShop es un CMS muy popular para tiendas online.
Al igual que WordPress, la conexión a la base de datos se realiza durante la instalación o editando un archivo de configuración.

Opción A: Instalación de PrestaShop desde cero

Sube los archivos de PrestaShop a tu servidor (carpeta public_html o similar).
Abre tu dominio en el navegador.
Se iniciará el asistente de instalación.
Acepta los términos y elige tu idioma.
Llegarás a la sección "Configuración de la base de datos".
Rellena los campos:
- Motor de base de datos: Selecciona MySQL.
- Dirección del servidor: localhost o el host indicado.
- Nombre de la base de datos: El nombre exacto.
- Usuario: El usuario con permisos.
- Contraseña: La contraseña.
- Prefijo de las tablas: Por defecto ps_. Puedes cambiarlo.
Haz clic en "Comprobar la conexión" o directamente en "Siguiente".
Si todo es correcto, PrestaShop continuará con la instalación (creación de la tienda, cuenta de administrador, etc.).

Opción B: Cambiar la base de datos en PrestaShop ya instalado

PrestaShop guarda los datos de conexión en el archivo app/config/parameters.php (en versiones modernas) o en config/settings.inc.php (en versiones antiguas).

Para PrestaShop 1.7 y superiores:

Accede a tu servidor por FTP.
Ve a la carpeta app/config/ y descarga el archivo parameters.php.
Ábrelo con un editor y busca las líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_bd',
'database_user' => 'usuario_bd',
'database_password' => 'contraseña',

Cambia los valores por los nuevos.
Guarda y sube el archivo de nuevo a su ubicación.

Para PrestaShop 1.6 y anteriores:

Busca el archivo config/settings.inc.php.
Edita las líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_bd');
define('_DB_USER_', 'usuario_bd');
define('_DB_PASSWD_', 'contraseña');

Guarda y sube.

[INFO]
En Syspanel (puerto 2106), puedes crear la base de datos y el usuario desde la sección Bases de Datos.
Una vez creada, te mostrará los datos de conexión exactos que debes usar en la instalación de PrestaShop.
Es recomendable crear una base de datos nueva y vacía para cada instalación, así evitas conflictos con otros sitios.

¿Dónde encuentro los datos de conexión de mi hosting?

Esta es una de las dudas más frecuentes.
Los datos conexion mysql no son secretos, pero están en lugares diferentes según tu proveedor de hosting.

Si usas cPanel (el panel clásico):

Inicia sesión en cPanel.
Busca la sección Bases de Datos.
Haz clic en "Bases de datos MySQL".
Ahí verás una lista de tus bases de datos y los usuarios asociados.
Para crear una nueva, usa "Crear nueva base de datos" y luego "Agregar usuario a la base de datos" (asignándole todos los privilegios).

Si usas Syspanel (nuestro panel, anteriormente HestiaCP):

Accede a https://tu-servidor:2106 (el puerto es obligatorio).
Inicia sesión con tu usuario y contraseña.
Busca la sección Bases de Datos en el menú lateral.
Verás todas tus bases de datos.
Haz clic en el icono de "Editar" (lápiz) para ver el usuario y el host.
Para crear una nueva, haz clic en "Agregar base de datos".
Completa el nombre, el usuario y la contraseña.
Syspanel te mostrará las credenciales exactas.

[TIP]
Siempre que tu web y la base de datos estén en el mismo servidor, el host base de datos será localhost.
Solo tendrás que usar una dirección externa si la base de datos está en un servidor diferente (por ejemplo, un servidor MySQL dedicado).

Errores comunes al conectar MySQL y cómo solucionarlos

Aunque sigas los pasos al pie de la letra, pueden aparecer errores.
Estos son los más habituales y sus soluciones:

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

Es el error más típico en WordPress.
Causas posibles:

Usuario o contraseña incorrectos: Revisa que no haya espacios o caracteres extra.
Nombre de la base de datos mal escrito: A veces tiene un prefijo (ej. usuario_bd).
Host incorrecto: Si no es localhost, prueba con la IP del servidor.

Solución: Revisa los datos en tu panel de hosting y vuelve a intentarlo.

2. "Acceso denegado para el usuario"

Este error indica que el usuario no tiene permisos sobre la base de datos.

Solución:

En cPanel o Syspanel, asegúrate de que el usuario está asociado a la base de datos y tiene todos los privilegios.
A veces hay que "agregar" el usuario a la base de datos aunque ya exista.

3. "Número máximo de conexiones alcanzado"

Significa que hay demasiadas conexiones simultáneas al servidor MySQL.

Solución:

Espera unos minutos y vuelve a intentarlo.
Optimiza tu web (usa caché) para reducir el número de conexiones.
Contacta con tu proveedor para aumentar el límite.

4. "Tabla no encontrada"

Este error aparece cuando la base de datos existe pero está vacía o incompleta.

Solución:

Si estás instalando WordPress o PrestaShop, asegúrate de que la base de datos esté vacía (sin tablas previas).
Si migraste el sitio, importa correctamente el archivo .sql con phpMyAdmin.

Preguntas frecuentes (FAQ) sobre conexión MySQL

¿Qué es mejor: `localhost` o una dirección IP?

Si tu web y tu base de datos están en el mismo servidor, usa localhost.
Es más rápido y seguro.
Si la base de datos está en otro servidor, deberás usar la IP o el dominio del servidor MySQL.

¿Puedo usar la misma base de datos para WordPress y PrestaShop?

No es recomendable.
Cada CMS crea sus propias tablas con prefijos distintos, pero compartir base de datos puede generar conflictos y problemas de rendimiento.
Es mejor una base de datos por sitio web.

¿Qué son los prefijos de tabla y por qué cambiarlos?

Los prefijos (como wp_ o ps_) se añaden al nombre de cada tabla.
Cambiarlos por defecto (por ejemplo, miwp_) añade una capa de seguridad contra ataques de inyección SQL.
Es un cambio sencillo que puedes hacer durante la instalación.

¿Cómo sé si mi conexión MySQL está funcionando?

La forma más fácil es acceder a tu web.
Si carga correctamente y no ves errores, la conexión funciona.
También puedes iniciar sesión en el panel de administrador (wp-admin o tu-admin-prestashop).

¿Qué es phpMyAdmin y para qué sirve?

Es una herramienta web que te permite gestionar tu base de datos de forma visual.
Desde ahí puedes crear, borrar o modificar tablas, importar archivos .sql, etc.
Suele estar disponible en todos los paneles de hosting (cPanel, Syspanel, etc.).

Consejos finales para una conexión segura

Usa contraseñas robustas para el usuario de la base de datos.
Evita fechas, nombres o palabras comunes.
No compartas tus datos de conexión por correo electrónico o chat.
Realiza copias de seguridad periódicas de tu base de datos.
Así, si algo falla, podrás restaurarla fácilmente.
Mantén tu CMS actualizado (WordPress, PrestaShop, etc.).
Las actualizaciones corrigen vulnerabilidades de seguridad.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106.
Si no recuerdas tu contraseña, puedes restablecerla desde el panel.

[WARNING]
Nunca edites los archivos de configuración (wp-config.php, parameters.php) directamente en el servidor sin descargarlos antes.
Un error de sintaxis puede dejar tu sitio completamente inaccesible.
Siempre trabaja con una copia local y luego sube el archivo corregido.

Resumen final

Conectar base de datos MySQL a tu sitio web es un proceso que parece complicado, pero con los datos correctos y siguiendo los pasos adecuados, es muy sencillo.

Recuerda lo esencial:

Necesitas 4 datos: host, nombre de base de datos, usuario y contraseña.
En WordPress, editas wp-config.php o rellenas el asistente de instalación.
En PrestaShop, editas parameters.php (o settings.inc.php en versiones antiguas) o usas el asistente.
Si tienes dudas, consulta la documentación de tu hosting o contacta con soporte técnico.

Con esta guía, ya tienes todo lo necesario para que tu web y tu base de datos trabajen juntas sin problemas.

Si tienes más preguntas, no dudes en dejar un comentario o contactar con nuestro equipo de soporte.

¡Buena suerte con tu proyecto web!

¿Qué significa conectar una base de datos MySQL y por qué es tan importante?

Los 4 datos de conexión que necesitas (sí o sí)

Cómo conectar una base de datos MySQL a WordPress

Opción A: Instalación desde cero (WordPress aún no instalado)

Opción B: WordPress ya instalado (cambio de base de datos o migración)

Cómo conectar PrestaShop a una base de datos MySQL

Opción A: Instalación de PrestaShop desde cero

Opción B: Cambiar la base de datos en PrestaShop ya instalado

Para PrestaShop 1.7 y superiores:

Para PrestaShop 1.6 y anteriores:

¿Dónde encuentro los datos de conexión de mi hosting?

Si usas cPanel (el panel clásico):

Si usas Syspanel (nuestro panel, anteriormente HestiaCP):

Errores comunes al conectar MySQL y cómo solucionarlos

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

2. "Acceso denegado para el usuario"

3. "Número máximo de conexiones alcanzado"

4. "Tabla no encontrada"

Preguntas frecuentes (FAQ) sobre conexión MySQL

¿Qué es mejor: localhost o una dirección IP?

¿Puedo usar la misma base de datos para WordPress y PrestaShop?

¿Qué son los prefijos de tabla y por qué cambiarlos?

¿Cómo sé si mi conexión MySQL está funcionando?

¿Qué es phpMyAdmin y para qué sirve?

Consejos finales para una conexión segura

Resumen final

¿Qué es mejor: `localhost` o una dirección IP?