Conectar PrestaShop a MySQL: Tutorial Completo y Actualizado

Antes de Empezar: ¿Qué Necesitas Saber?

Conectar PrestaShop a una base de datos MySQL es uno de los pasos más importantes durante la instalación o migración de tu tienda online. Sin una conexión correcta, tu tienda no podrá mostrar productos, gestionar pedidos ni procesar pagos. En este prestashop tutorial, te guiaremos paso a paso para que configures esta conexión de forma segura y sin errores, incluso si no tienes experiencia técnica avanzada.

Para entenderlo fácilmente, imagina que PrestaShop es un coche y MySQL es el motor. El coche necesita estar bien conectado al motor para funcionar. Si la conexión falla, el coche no arranca. Lo mismo ocurre con tu tienda: si la conexión entre PrestaShop y MySQL no es correcta, verás errores como "Error de conexión a la base de datos" o "No se puede establecer conexión con la base de datos".

Antes de comenzar, asegúrate de tener a mano los siguientes datos:

Nombre de la base de datos (ejemplo: tienda_prestashop).
Usuario de la base de datos (ejemplo: usuario_tienda).
Contraseña del usuario (la que hayas configurado).
Host de la base de datos (normalmente localhost o 127.0.0.1 si está en el mismo servidor).
Puerto (por defecto MySQL usa el 3306, pero puede variar en configuraciones avanzadas).

Si no tienes estos datos, contacta con tu proveedor de hosting o revisa el panel de control de tu servidor. En Syspanel (antes HestiaCP), puedes encontrarlos en la sección de bases de datos. Recuerda que para acceder a Syspanel debes usar el puerto 2106 (por ejemplo: https://tu-dominio.com:2106).

Paso 1: Crear la Base de Datos en tu Servidor

Lo primero es tener una base de datos creada. Si ya la tienes, puedes saltar este paso. Si no, aquí te explicamos cómo hacerlo en los paneles más comunes.

En Syspanel (HestiaCP)

Accede a tu panel de control Syspanel usando el puerto 2106.
Inicia sesión con tu usuario y contraseña de administrador.
Busca la sección "Bases de Datos" o "Databases" en el menú lateral.
Haz clic en "Añadir Base de Datos" o "Add Database".
Completa los campos:
- Nombre de la base: elige un nombre descriptivo, por ejemplo tienda_prestashop.
- Usuario: se creará automáticamente con el nombre de tu usuario de hosting + el nombre que pongas (ejemplo: admin_tienda_prestashop).
- Contraseña: genera una segura o usa la que te proponga el sistema.
Guarda los cambios. El sistema te mostrará los datos de conexión. Guárdalos en un lugar seguro porque los necesitarás en los siguientes pasos.

En cPanel

Inicia sesión en cPanel con tus credenciales.
Busca la sección "Bases de Datos MySQL".
Crea una nueva base de datos con un nombre que recuerdes.
Crea un usuario para esa base de datos (o usa uno existente si tienes permisos).
Asigna el usuario a la base de datos con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Anota el nombre de la base, el usuario y la contraseña.

[INFO]
Los nombres de usuario y base de datos suelen llevar un prefijo (por ejemplo, tuusuario_basededatos). Asegúrate de escribir el nombre completo cuando configures PrestaShop.

Paso 2: Localizar el Archivo de Configuración de PrestaShop

PrestaShop guarda la configuración de conexión a la base de datos en un archivo llamado parameters.php. Este archivo se encuentra en la carpeta app/config/ de tu instalación.

Si estás instalando PrestaShop por primera vez, el instalador te pedirá los datos de la base de datos y generará este archivo automáticamente.
Si ya tienes PrestaShop instalado y necesitas cambiar la conexión (por ejemplo, porque cambiaste de servidor), deberás editar este archivo manualmente.

Cómo acceder al archivo

Puedes acceder al archivo de dos formas:

Desde el administrador de archivos de tu hosting (Syspanel, cPanel, etc.).
Usando FTP con un cliente como FileZilla.

Una vez que lo tengas localizado, ábrelo con un editor de texto plano (no uses Word ni editores enriquecidos). En Syspanel, puedes usar el editor integrado.

Paso 3: Configurar la Conexión en el Archivo parameters.php

El archivo parameters.php contiene un array con los datos de conexión. Busca la sección que dice 'database_host', 'database_name', 'database_user' y 'database_password'. Deberías ver algo similar a esto:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'tu_contraseña',

Ahora, modifica estos valores con los datos de tu base de datos:

database_host: normalmente localhost. Si tu base de datos está en otro servidor, escribe la IP o el nombre del servidor (ejemplo: mysql.tudominio.com).
database_port: deja 3306 salvo que sepas que tu servidor usa otro puerto.
database_name: el nombre exacto de tu base de datos (incluyendo el prefijo si lo tiene).
database_user: el usuario exacto que creaste (incluyendo el prefijo).
database_password: la contraseña de ese usuario.

[WARNING]
Ten mucho cuidado al editar este archivo. Un error de sintaxis (una comilla mal puesta, un carácter extra) puede romper tu tienda por completo. Haz una copia de seguridad del archivo antes de editarlo.

Paso 4: Configurar la Conexión Durante la Instalación de PrestaShop

Si estás instalando PrestaShop desde cero, el proceso es más sencillo porque el instalador te guía visualmente. Sigue estos pasos:

Ejecuta el instalador de PrestaShop en tu navegador (por ejemplo, https://tu-dominio.com/install).
Selecciona el idioma y acepta los términos.
Cuando llegues al paso de "Configuración de la base de datos", introduce los datos que tienes:
- Dirección del servidor: localhost (o el host que corresponda).
- Puerto: 3306.
- Nombre de la base de datos: el nombre completo.
- Usuario: el usuario completo.
- Contraseña: la contraseña correspondiente.
El instalador probará la conexión. Si todo es correcto, te lo indicará con un mensaje verde.
Continúa con el resto de la instalación (tienda, administrador, etc.).

[TIP]
Si el instalador te da un error de conexión, revisa que el usuario tenga permisos sobre la base de datos. En algunos hosting, debes añadir el usuario a la base de datos manualmente desde el panel.

Paso 5: Probar la Conexión de Forma Manual

Si tienes dudas de que la configuración sea correcta, puedes probar la conexión directamente con un script PHP. Crea un archivo llamado testdb.php en la raíz de tu instalación de PrestaShop con el siguiente contenido:

<?php
$host = 'localhost';
$dbname = 'nombre_base_datos';
$user = 'usuario_base_datos';
$pass = 'tu_contraseña';

try {
    $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8", $user, $pass);
    echo 'Conexión exitosa a la base de datos MySQL';
} catch (PDOException $e) {
    echo 'Error de conexión: ' . $e->getMessage();
}
?>

Guarda el archivo y accede a él desde tu navegador: https://tu-dominio.com/testdb.php. Si ves el mensaje de éxito, la conexión funciona. Borra este archivo después de la prueba por seguridad.

Solución de Problemas Comunes en la Conexión PrestaShop MySQL

Aunque sigas todos los pasos, a veces pueden aparecer errores. Aquí tienes los más frecuentes y cómo solucionarlos.

"Error de conexión a la base de datos" al instalar

Este error suele indicar que los datos introducidos son incorrectos o que el usuario no tiene permisos. Verifica:

Que el nombre de la base y el usuario estén completos (con el prefijo).
Que la contraseña no tenga espacios al copiarla.
Que el usuario esté asignado a la base de datos con todos los privilegios.

"Tabla no encontrada" o "Base de datos vacía"

Esto significa que la conexión se establece pero no hay tablas. Puede ocurrir si:

La base de datos está vacía y no has ejecutado la instalación completa.
La base de datos es de otra instalación y no es compatible con tu versión de PrestaShop.

Solución: asegúrate de que la base de datos contenga las tablas de PrestaShop. Si no, ejecuta de nuevo el instalador o importa una copia de seguridad.

"Acceso denegado para el usuario"

Este error indica problemas de permisos o credenciales incorrectas. Revisa:

El usuario y la contraseña (prueba a cambiarla desde el panel).
Que el usuario tenga permisos sobre la base de datos específica.
Si el hosting usa localhost o una IP concreta para el host.

[WARNING]
Nunca uses la contraseña de administrador de tu hosting para la base de datos. Crea un usuario específico con permisos limitados solo a esa base de datos.

Consejos para Optimizar la Conexión PrestaShop MySQL

Una vez que la conexión funciona, puedes hacer algunos ajustes para mejorar el rendimiento de tu tienda.

Usa el prefijo de tabla adecuado

Durante la instalación, PrestaShop te pregunta por un prefijo para las tablas (por defecto ps_). Si cambias de base de datos, asegúrate de que el prefijo coincida. En el archivo parameters.php, busca 'database_prefix' y verifica que sea el correcto.

Activa la caché de MySQL

PrestaShop tiene un sistema de caché que reduce las consultas a la base de datos. Puedes activarlo en el panel de administración:

Ve a Parámetros avanzados > Rendimiento.
Activa la Caché y elige el método "Memcached" o "APCu" si tu servidor lo soporta.
Guarda los cambios.

Mantén tu versión de MySQL actualizada

Las versiones antiguas de MySQL pueden ser más lentas y menos seguras. Consulta con tu hosting si puedes actualizar a MySQL 8 o MariaDB, que son las versiones recomendadas para las últimas versiones de PrestaShop.

Preguntas Frecuentes (FAQ)

¿Puedo cambiar el host de la base de datos después de instalar PrestaShop?

Sí, puedes editar el archivo parameters.php con los nuevos datos. Recuerda hacer una copia de seguridad antes y borrar la caché de PrestaShop después del cambio.

¿Qué hago si no recuerdo la contraseña de la base de datos?

Puedes restablecerla desde tu panel de control (Syspanel, cPanel, etc.). En Syspanel, ve a Bases de Datos, selecciona la base y cambia la contraseña del usuario.

¿Es seguro usar `localhost` como host?

Sí, es lo más común y seguro si la base de datos está en el mismo servidor que tu tienda. Si la base está en un servidor externo, usa una conexión SSL si es posible.

¿Puedo conectar PrestaShop a una base de datos remota?

Sí, siempre que el servidor remoto permita conexiones externas y tengas los permisos necesarios. Deberás indicar la IP o el nombre del servidor en el campo database_host.

¿Qué es el puerto 2106 y para qué sirve?

El puerto 2106 es el puerto de acceso al panel de control Syspanel (antes HestiaCP). Es una herramienta de administración de hosting que te permite gestionar bases de datos, dominios y archivos. Para acceder, escribe https://tu-dominio.com:2106 en tu navegador.

¿Cómo sé si mi base de datos está optimizada para PrestaShop?

Puedes usar herramientas como phpMyAdmin para revisar el tamaño de las tablas y el rendimiento de las consultas. También puedes activar el registro de consultas lentas en MySQL para identificar problemas.

Conclusión y Siguientes Pasos

Conectar PrestaShop a una base de datos MySQL es un proceso sencillo si sigues estos pasos con calma y atención a los detalles. Recuerda siempre hacer copias de seguridad antes de modificar archivos de configuración y mantener tus credenciales en un lugar seguro.

Una vez que la conexión esté funcionando, te recomendamos:

Verificar tu tienda desde el front-end y el back-end para asegurarte de que todo carga correctamente.
Configurar las copias de seguridad automáticas de tu base de datos para evitar pérdidas de información.
Optimizar las consultas con módulos de caché y un buen mantenimiento del servidor.

Si sigues este prestashop tutorial, no tendrás problemas para conectar tu tienda a la base de datos. Y recuerda: si en algún momento te pierdes, vuelve a revisar los datos de conexión y los permisos del usuario. La mayoría de los errores se solucionan con una configuración cuidadosa.

[TIP]
Guarda este artículo como referencia para futuras migraciones o cambios de servidor. La conexión PrestaShop MySQL es un proceso que repetirás cada vez que muevas tu tienda de hosting.

Ahora que ya sabes cómo conectar PrestaShop a tu base de datos MySQL, ¡ponte manos a la obra y asegura el funcionamiento de tu tienda online!