Conectar PrestaShop a MySQL | Instalación y Configuración

¿Por qué PrestaShop necesita una base de datos MySQL?

Antes de lanzarnos a la configuración, es fundamental que entiendas qué es y para qué sirve la base de datos. Piensa en MySQL como el almacén central de tu tienda online. Ahí es donde se guardan todos los productos, precios, clientes, pedidos, contraseñas (cifradas), configuraciones de módulos y el historial de ventas.

Sin una base de datos correctamente configurada, PrestaShop simplemente no puede funcionar. Es un requisito indispensable, junto con PHP y un servidor web (Apache o Nginx). Cuando hablamos de prestashop mysql nos referimos a la conexión entre el software de la tienda y este motor de bases de datos.

Muchos usuarios se bloquean en este paso durante la instalación inicial. No te preocupes: es más sencillo de lo que parece si sigues una guía ordenada. Vamos a desglosar todo el proceso, desde la creación de la base de datos hasta la resolución de los errores más frecuentes.

Requisitos previos antes de conectar PrestaShop a la base de datos

Para evitar sustos, asegúrate de tener lo siguiente a mano antes de empezar:

Datos de acceso a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).
Credenciales de administrador de tu servidor si usas un VPS o servidor dedicado.
El paquete de instalación de PrestaShop descargado y subido a tu servidor (o acceso a un instalador automático).
Un dominio o subdominio preparado para la tienda.

[INFO] Si tu hosting usa el panel Syspanel, recuerda que el acceso se realiza a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106). Este panel es una alternativa moderna y muy visual a cPanel, y te permitirá gestionar bases de datos fácilmente.

Paso 1: Crear la base de datos MySQL para PrestaShop

Lo primero es crear un espacio vacío donde PrestaShop pueda guardar sus tablas. No puedes usar la base de datos del sistema ni una que ya tenga otros datos, porque se producirán conflictos.

Opción A: Crear la BD en cPanel

Inicia sesión en tu cPanel.
Busca la sección Bases de Datos.
Haz clic en Asistente para Bases de Datos MySQL.
Crea un nombre para tu base de datos (ej: tienda_prestashop).
A continuación, crea un usuario para esa base (ej: admin_tienda).
Asigna una contraseña segura. Guárdala en un lugar seguro, la necesitarás en unos minutos.
Asigna el usuario a la base de datos y otórgale TODOS LOS PRIVILEGIOS. Esto es crucial para que la instalación pueda crear las tablas.

Opción B: Crear la BD en Syspanel (antiguo HestiaCP)

Accede a tu Syspanel usando el puerto 2106.
En el menú lateral, busca la sección Bases de Datos.
Haz clic en Añadir Base de Datos.
Introduce un nombre descriptivo (ej: prestashop_db).
El sistema te generará automáticamente un usuario y una contraseña. Copia estos datos inmediatamente, ya que no podrás ver la contraseña de nuevo.
Pulsa en Guardar.

[WARNING] Anota siempre el nombre de la base de datos, el usuario y la contraseña. La mayoría de los errores al conectar prestashop base de datos ocurren por un simple error al copiar estos datos.

Paso 2: Configurar la conexión durante la instalación de PrestaShop

Una vez que tienes la base de datos creada, el siguiente paso es indicarle a PrestaShop dónde está y cómo conectarse. Este es el momento crítico donde debes tener los datos a mano.

Abre tu navegador y ve a la URL donde has subido los archivos de PrestaShop (ej: tudominio.com/install).
Sigue el asistente hasta llegar al paso de Configuración de la base de datos.
Verás un formulario con estos campos:

Dirección del servidor de base de datos: Normalmente es localhost o 127.0.0.1. Si tu hosting usa un servidor externo, te lo indicarán en el panel. Para la mayoría de los casos, localhost funciona.
Nombre de la base de datos: El nombre que creaste en el paso anterior.
Usuario de la base de datos: El usuario que creaste.
Contraseña de la base de datos: La contraseña que asignaste.
Prefijo de las tablas: Te recomiendo cambiar el prefijo por defecto (ps_) por algo menos predecible (ej: shop_). Esto añade una capa extra de seguridad contra ataques de inyección SQL.

Haz clic en Comprobar conexión.
Si todo es correcto, verás un mensaje verde de éxito y podrás continuar con la instalación.

[TIP] Si tienes problemas de conexión y tu hosting usa un servidor MySQL remoto, prueba a cambiar localhost por la IP o el nombre del servidor que aparece en tu panel de control.

Paso 3: Configurar PrestaShop para conectar a MySQL manualmente (archivo settings.inc.php)

¿Y si ya tienes PrestaShop instalado pero necesitas cambiar la base de datos? O quizás te mudaste de hosting y quieres actualizar los datos de conexión. En ese caso, no vuelvas a ejecutar el instalador. Debes editar el archivo de configuración.

Este archivo se llama settings.inc.php y se encuentra en la carpeta config de tu instalación (ej: tu-dominio.com/config/settings.inc.php).

Conéctate a tu servidor por FTP o a través del administrador de archivos de tu hosting.
Navega hasta la carpeta config y abre el archivo settings.inc.php con un editor de texto (como Notepad++ o el editor del propio panel).
Busca las siguientes líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');

Reemplaza los valores con los nuevos datos de tu base de datos MySQL.
Guarda el archivo y súbelo de nuevo al servidor si lo editaste localmente.

[WARNING] Haz siempre una copia de seguridad del archivo settings.inc.php antes de modificarlo. Un error de sintaxis puede dejar tu tienda completamente inaccesible.

Errores comunes al conectar PrestaShop a la base de datos (y sus soluciones)

Es muy probable que en algún momento te aparezca un error. No te frustres: la mayoría tienen una solución rápida. Aquí te dejo los más habituales.

Error: "No se puede conectar a la base de datos"

Este es el error más genérico y frustrante. Las causas más comunes son:

Credenciales incorrectas: Revisa que el nombre de usuario, la contraseña y el nombre de la base de datos estén escritos exactamente igual que como los creaste. Cuidado con las mayúsculas y minúsculas.
Servidor de BD incorrecto: Aunque parezca mentira, a veces localhost no es la respuesta. Si tu hosting usa un servidor de bases de datos separado (como mysql.tudominio.com), deberás usar ese.
El usuario no tiene permisos: Verifica que el usuario tenga todos los privilegios sobre la base de datos específica. Este es un error muy común en cPanel cuando olvidas asignar el usuario a la base de datos.

Error: "La base de datos no existe"

Este error es más concreto y significa que PrestaShop se está conectando al servidor MySQL correctamente, pero no encuentra la base de datos con el nombre que has indicado.

Revisa el nombre: Asegúrate de que has escrito el nombre completo. En cPanel, a menudo el nombre de la base de datos incluye el prefijo del usuario (ej: usuario_tienda).
Verifica la creación: Confirma que la base de datos se creó correctamente en tu panel de control.

Error: "El usuario no tiene acceso a la base de datos"

Aquí el problema es de permisos. Has creado el usuario y la base de datos, pero no los has vinculado.

Vuelve a la sección de bases de datos de tu panel de hosting.
Busca la opción de "Añadir usuario a la base de datos" o "Asignar privilegios".
Selecciona el usuario y la base de datos, y otorga TODOS LOS PRIVILEGIOS.

Error: "El prefijo de la tabla no es válido"

Este error es menos común, pero ocurre. El prefijo solo debe contener letras, números y guiones bajos. Evita caracteres especiales como guiones medios o puntos.

Cómo configurar PrestaShop con MySQL en un hosting compartido vs VPS

El proceso es el mismo, pero hay matices.

Hosting compartido: Todo se gestiona desde el panel de control (cPanel o Syspanel). La base de datos y el usuario se crean ahí. La conexión suele ser a localhost.
VPS o servidor dedicado: Tienes más control, pero también más responsabilidad. Debes asegurarte de que MySQL/MariaDB esté instalado y corriendo. Puedes acceder por SSH y crear la base de datos con comandos como:

CREATE DATABASE prestashop_db;
CREATE USER 'prestashop_user'@'localhost' IDENTIFIED BY 'tu_contraseña_segura';
GRANT ALL PRIVILEGES ON prestashop_db.* TO 'prestashop_user'@'localhost';
FLUSH PRIVILEGES;

[TIP] Si usas un VPS y no te sientes cómodo con la línea de comandos, instala phpMyAdmin para gestionar las bases de datos de forma visual.

Optimización inicial de la base de datos MySQL para PrestaShop

Una vez que tu tienda está conectada y funcionando, puedes hacer algunos ajustes para que el rendimiento sea óptimo desde el principio.

Motor de almacenamiento: Asegúrate de que las tablas usen InnoDB. Es el motor más fiable y soporta transacciones, lo cual es vital para la gestión de pedidos y stock.
Juego de caracteres: Configura la base de datos para usar utf8mb4. Esto te permitirá mostrar caracteres especiales, emojis y acentos correctamente. La mayoría de los instaladores lo hacen por defecto.
Índices: No toques los índices si no sabes lo que haces. PrestaShop los crea automáticamente. Solo asegúrate de no eliminarlos al hacer limpiezas manuales.

Preguntas frecuentes sobre conectar PrestaShop a MySQL

¿Puedo usar una base de datos MySQL existente para PrestaShop?

Sí, pero es altamente desaconsejable si ya tiene datos de otra aplicación. Es mucho más seguro crear una base de datos nueva y limpia para evitar conflictos de tablas y datos corruptos.

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

No podrás recuperar la contraseña, pero puedes restablecerla desde tu panel de control de hosting. Busca la opción de "Cambiar contraseña" en la sección de bases de datos. Después, deberás actualizar el archivo settings.inc.php con la nueva contraseña.

¿Puedo conectar PrestaShop a una base de datos MySQL remota?

Sí, es posible, pero no es recomendable por temas de latencia y seguridad. Si lo haces, asegúrate de que el servidor MySQL permita conexiones remotas desde la IP de tu servidor web y que uses una conexión SSL si es posible.

¿Qué versión de MySQL necesito?

PrestaShop 8 (la versión actual) requiere MySQL 5.7 o superior, o mejor aún, MariaDB 10.2 o superior. Consulta los requisitos de la versión específica que vayas a instalar.

¿Cómo sé si mi base de datos tiene el juego de caracteres correcto?

Puedes comprobarlo desde phpMyAdmin. Selecciona tu base de datos y busca la opción "Operaciones". Ahí verás el cotejamiento (collation). Debe ser algo como utf8mb4_general_ci o utf8mb4_unicode_ci.

Conclusión final

Conectar PrestaShop a una base de datos MySQL es un paso crítico, pero una vez que lo entiendes, se convierte en un procedimiento rutinario. La clave está en tener los datos de acceso preparados, seguir los pasos con calma y saber interpretar los errores.

Recuerda que la base de datos es el corazón de tu tienda. Haz copias de seguridad periódicas y mantén la configuración segura. Si has llegado hasta aquí, ya tienes los conocimientos para realizar una instalación limpia de prestashop mysql o para solucionar un error base de datos prestashop. ¡Enhorabuena, tu tienda está lista para despegar!

[INFO] Si tu base de datos crece mucho, considera contratar un hosting con mejor rendimiento de MySQL o contratar una base de datos gestionada en la nube. Esto te dará más estabilidad y velocidad para tu tienda.