Conectar PrestaShop a MySQL | Tutorial Paso a Paso

¿Por qué es importante conectar PrestaShop a MySQL correctamente?

Conectar PrestaShop a una base de datos MySQL es uno de los pasos más críticos durante la instalación o migración de tu tienda online. La base de datos almacena toda la información esencial de tu negocio: productos, pedidos, clientes, contraseñas, configuraciones y estadísticas. Si esta conexión falla, tu tienda no funcionará, mostrará errores como "Error de conexión a la base de datos" o simplemente aparecerá una página en blanco.

Entender cómo funciona esta conexión te permitirá resolver problemas comunes, migrar tu tienda de servidor sin perder datos y optimizar el rendimiento de tu PrestaShop. En esta guía paso a paso, aprenderás desde los conceptos básicos hasta la configuración avanzada, todo explicado de forma sencilla y clara.

Requisitos previos antes de empezar

Antes de lanzarnos a la configuración, asegúrate de tener lo siguiente a mano:

Acceso a tu panel de control de hosting o servidor (cPanel, Plesk, Syspanel, etc.)
Credenciales de acceso a MySQL: nombre de usuario, contraseña, nombre de la base de datos y host
Versión de PrestaShop que vas a instalar (1.6, 1.7 o 8.x)
Cliente FTP o administrador de archivos para subir los archivos de PrestaShop si es necesario
Un editor de texto simple (Bloc de notas, Sublime Text, etc.) por si necesitas modificar archivos de configuración

[!INFO] INFO: Si usas Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106. Por ejemplo: https://tu-dominio.com:2106. Este panel incluye herramientas para gestionar bases de datos MySQL de forma muy visual.

Paso 1: Crear la base de datos MySQL

Lo primero que necesitas es una base de datos vacía donde PrestaShop pueda guardar toda su información. Si ya tienes una base de datos creada, puedes saltarte este paso. Si no, aquí tienes cómo hacerlo:

Opción A: Crear base de datos desde Syspanel

Accede a Syspanel usando el puerto 2106 con tus credenciales de administrador
Busca la sección "Bases de datos" o "Database" en el menú lateral
Haz clic en "Añadir base de datos" o "Add Database"
Completa los campos: nombre de la base de datos, usuario y contraseña
Asegúrate de seleccionar MySQL como tipo de base de datos
Guarda los cambios

[!TIP] TIP: Anota en un lugar seguro el nombre de la base de datos, el usuario y la contraseña. Los necesitarás en el siguiente paso.

Opción B: Crear base de datos desde cPanel

Inicia sesión en tu cPanel
Busca la sección "Bases de datos MySQL" o "MySQL Databases"
Crea una nueva base de datos escribiendo un nombre en el campo correspondiente
Crea un usuario para la base de datos y asígnale una contraseña segura
Añade el usuario a la base de datos y otórgale todos los privilegios

[!WARNING] WARNING: Nunca utilices contraseñas débiles o fáciles de adivinar. Una base de datos comprometida puede significar la pérdida total de tu tienda y los datos de tus clientes.

Paso 2: Localizar el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php, ubicado en la carpeta app/config/ de tu instalación. Si estás haciendo una instalación nueva, este archivo se generará automáticamente durante el proceso de instalación. Si estás migrando o reparando una instalación existente, tendrás que editarlo manualmente.

¿Cómo acceder al archivo parameters.php?

A través de FTP: conéctate a tu servidor usando FileZilla o cualquier cliente FTP
A través del administrador de archivos de tu panel de control (Syspanel, cPanel, etc.)
A través de SSH si tienes conocimientos avanzados

Una vez localizado, ábrelo con un editor de texto. Verás una estructura similar a esta:

return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'tu_base_de_datos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        'database_engine' => 'InnoDB',
    ],
];

Paso 3: Configurar los datos de conexión en PrestaShop

Ahora viene la parte principal: conectar tu PrestaShop a la base de datos MySQL. Dependiendo de si estás instalando desde cero o reparando una instalación existente, el proceso varía ligeramente.

Si estás instalando PrestaShop desde cero

Sube los archivos de PrestaShop a tu servidor (normalmente en la carpeta public_html o www)
Abre tu navegador y escribe la URL de tu dominio
El asistente de instalación te guiará paso a paso
En la pantalla de "Configuración de la base de datos", introduce los siguientes datos:
- Dirección del servidor: normalmente localhost, pero si tu hosting usa un servidor externo, te lo indicarán (por ejemplo, mysql.tudominio.com)
- Puerto: generalmente vacío o 3306 (el puerto por defecto de MySQL)
- Nombre de la base de datos: el que creaste en el paso 1
- Usuario de la base de datos: el usuario que creaste
- Contraseña: la contraseña asociada a ese usuario
- Prefijo de tablas: por defecto es ps_, pero puedes cambiarlo si quieres

[!TIP] TIP: Si no estás seguro del host de tu base de datos, contacta con tu proveedor de hosting o revisa la documentación del panel. En Syspanel, suele ser localhost para la mayoría de los casos.

Si ya tienes PrestaShop instalado y necesitas corregir la conexión

Accede al archivo parameters.php como te explicamos antes
Modifica los valores de database_host, database_name, database_user y database_password
Guarda los cambios y sube el archivo de vuelta al servidor si lo editaste localmente
Borra la carpeta var/cache de tu instalación para que PrestaShop cargue los nuevos valores

[!WARNING] WARNING: Antes de modificar cualquier archivo de configuración, haz una copia de seguridad del original. Un error en este archivo puede dejar tu tienda inaccesible.

Paso 4: Verificar que la conexión funciona correctamente

Una vez configurada la conexión, es importante verificar que todo funciona correctamente. Aquí tienes algunas comprobaciones:

Comprobación básica

Abre tu tienda en el navegador
Si ves la página principal sin errores, la conexión es correcta
Prueba a acceder al panel de administración (/admin o la URL que configuraste)
Realiza una acción sencilla como editar un producto o cambiar una configuración

Comprobación avanzada

Si tienes acceso a phpMyAdmin o a una herramienta similar, puedes verificar que las tablas se han creado correctamente:

Accede a tu base de datos
Verás una lista de tablas con el prefijo que configuraste (por ejemplo, ps_product, ps_order, etc.)
Si no ves tablas, significa que la instalación no se completó correctamente

[!INFO] INFO: La cantidad de tablas que crea PrestaShop varía según la versión, pero normalmente supera las 200 tablas. Esto es completamente normal.

Problemas comunes y soluciones

Aunque hayas seguido todos los pasos, pueden surgir problemas. Aquí tienes los más habituales y cómo solucionarlos:

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

Este es el error más común. Las causas pueden ser:

Credenciales incorrectas: revisa que el usuario y contraseña son correctos
Host incorrecto: si tu base de datos está en un servidor diferente, asegúrate de usar el host correcto
Puerto incorrecto: MySQL usa el puerto 3306 por defecto, pero algunos servidores usan otros

Error "Tabla no encontrada"

Si ves errores sobre tablas que no existen, puede ser que:

La instalación no se completó correctamente
El prefijo de las tablas no coincide con el configurado
La base de datos está vacía

Página en blanco al cargar la tienda

Este problema puede deberse a:

Archivo parameters.php mal configurado
Permisos incorrectos en los archivos de configuración
Problemas de caché: borra la carpeta var/cache

[!TIP] TIP: Activa el modo depuración de PrestaShop para ver errores más detallados. Para ello, edita el archivo defines.inc.php en la carpeta config y cambia _PS_MODE_DEV_ a true.

Optimización de la conexión a MySQL

Una vez que tu PrestaShop está conectado correctamente a la base de datos, puedes optimizar la conexión para mejorar el rendimiento:

Usar conexiones persistentes

PrestaShop permite usar conexiones persistentes a la base de datos, lo que reduce la sobrecarga de crear nuevas conexiones para cada petición. Para activarlo:

Edita el archivo parameters.php
Añade la línea 'database_persistent' => true,
Guarda los cambios y borra la caché

Configurar el motor de base de datos

PrestaShop usa InnoDB por defecto, que es más robusto que MyISAM. Verifica que tu base de datos usa InnoDB:

Accede a phpMyAdmin
Selecciona tu base de datos
En la pestaña "Operaciones", revisa el motor de las tablas

Optimizar las consultas

Mantén tu PrestaShop actualizado a la última versión
Usa un plugin de caché como PrestaShop Cache
Limpia regularmente las tablas de logs y sesiones antiguas

Migración de PrestaShop con base de datos MySQL

Si necesitas mover tu tienda a otro servidor, la conexión a la base de datos es clave. El proceso general es:

Exporta tu base de datos: usa phpMyAdmin o la herramienta de backup de tu panel
Exporta los archivos: sube todos los archivos de tu PrestaShop al nuevo servidor
Crea una base de datos nueva en el servidor de destino
Importa la base de datos en el nuevo servidor
Modifica el archivo parameters.php con los nuevos datos de conexión
Actualiza las URLs en la base de datos si cambiaste de dominio

[!WARNING] WARNING: Durante la migración, asegúrate de que las versiones de MySQL y PHP del servidor de destino sean compatibles con tu versión de PrestaShop. Una incompatibilidad puede causar errores graves.

Preguntas frecuentes sobre la conexión PrestaShop-MySQL

¿Puedo usar MySQL y MariaDB indistintamente?

Sí, PrestaShop funciona perfectamente con MariaDB, que es un fork de MySQL. De hecho, muchos servidores usan MariaDB por defecto. La configuración es exactamente la misma.

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

Puedes restablecerla desde tu panel de control. En Syspanel, ve a la sección de bases de datos, selecciona la base de datos y cambia la contraseña del usuario. Luego actualiza el archivo parameters.php con la nueva contraseña.

¿Es seguro usar el usuario root para la conexión?

No, es una mala práctica. Siempre crea un usuario específico para PrestaShop con los privilegios mínimos necesarios. Esto limita los daños en caso de que tu tienda sea comprometida.

¿Puedo cambiar el prefijo de las tablas después de la instalación?

Técnicamente es posible, pero muy arriesgado. Tendrías que renombrar todas las tablas y actualizar las referencias en el código. Mejor decide el prefijo antes de instalar.

¿Cuántas conexiones simultáneas necesita PrestaShop?

Depende del tráfico de tu tienda. Un sitio pequeño con 100 visitas diarias funciona bien con 10-20 conexiones. Para tiendas grandes, considera un servidor dedicado o una base de datos en la nube.

Conclusión y buenas prácticas finales

Conectar PrestaShop a una base de datos MySQL es un proceso que, aunque parece técnico, es bastante sencillo si sigues los pasos correctamente. La clave está en tener las credenciales correctas, configurar el archivo parameters.php adecuadamente y verificar que todo funciona antes de lanzar tu tienda.

Buenas prácticas para mantener tu conexión saludable:

Realiza backups periódicos de tu base de datos, al menos una vez por semana
Mantén tu PrestaShop actualizado para evitar vulnerabilidades de seguridad
Monitoriza el rendimiento de tu base de datos con herramientas como MySQL Workbench o las estadísticas de tu panel
Documenta tus credenciales en un lugar seguro, pero nunca las compartas por email o mensajes no cifrados
Prueba la conexión después de cualquier cambio en la configuración del servidor

Recuerda que la base de datos es el corazón de tu tienda online. Sin ella, PrestaShop no puede funcionar. Si tienes problemas durante el proceso, no dudes en contactar con tu proveedor de hosting o con el soporte técnico de PrestaShop.

[!INFO] INFO: Si estás usando Syspanel, recuerda que tienes acceso a herramientas de gestión de bases de datos muy completas, incluyendo phpMyAdmin, backups automáticos y monitorización de rendimiento. Todo accesible a través del puerto 2106.

Esperamos que esta guía te haya sido de utilidad. Ahora ya sabes cómo conectar PrestaShop a tu base de datos MySQL de forma segura y eficiente. ¡Tu tienda online está lista para despegar!