Conectar PrestaShop a MySQL - Guía paso a paso

Introducción: ¿Por qué es importante conectar PrestaShop a MySQL?

PrestaShop es una de las plataformas de comercio electrónico más populares del mundo, y su funcionamiento depende completamente de una base de datos MySQL. Cada producto, cliente, pedido y configuración se almacena en tablas dentro de esta base de datos. Si la conexión falla, tu tienda simplemente no cargará. Por eso, saber cómo conectar PrestaShop a MySQL es una habilidad básica pero crucial para cualquier administrador de tienda online.

En esta guía, te explicaremos paso a paso cómo realizar la conexión, qué datos necesitas, cómo solucionar los errores conexión más comunes y algunos consejos para mantener tu PrestaShop base de datos segura y optimizada. Todo explicado de forma sencilla, sin tecnicismos innecesarios.

¿Qué necesitas antes de empezar la configuración MySQL PrestaShop?

Antes de lanzarte a modificar archivos, asegúrate de tener a mano la siguiente información. Te hará falta durante el proceso de instalación o al editar la configuración manualmente.

Nombre del servidor de base de datos: Normalmente es localhost si tu tienda y la base de datos están en el mismo servidor. Si usas un hosting externo, será una dirección IP o un nombre como mysql.tudominio.com.
Nombre de la base de datos: El nombre que le asignaste a tu base de datos MySQL (ejemplo: prestashop_db).
Usuario de la base de datos: El usuario con permisos para acceder a esa base de datos (ejemplo: admin_presta).
Contraseña del usuario: La contraseña correspondiente al usuario anterior.
Puerto de conexión: Por defecto es el 3306, pero algunos hostings usan puertos alternativos.

[TIP] Si usas Syspanel (antes conocido como HestiaCP), recuerda que el acceso a tu panel de administración del servidor es a través del puerto 2106. Allí podrás gestionar tus bases de datos y usuarios MySQL de forma visual.

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

Si aún no tienes una base de datos creada, este es el primer paso. Puedes hacerlo desde tu panel de hosting o desde herramientas como phpMyAdmin.

Desde phpMyAdmin (la forma más común)

Accede a phpMyAdmin desde tu panel de hosting (normalmente en tudominio.com/phpmyadmin).
Inicia sesión con tu usuario root o un usuario con permisos de administración.
Ve a la pestaña Bases de datos.
Escribe un nombre para tu base de datos (por ejemplo, prestashop_ventas) y selecciona utf8_general_ci como cotejamiento. Haz clic en Crear.
Ahora ve a la pestaña Usuarios y haz clic en Agregar usuario.
Crea un nombre de usuario (ejemplo: usuario_presta) y una contraseña segura.
Marca la opción Crear base de datos con el mismo nombre y otorgar todos los privilegios si quieres simplificar, o más abajo selecciona la base de datos que creaste y asigna Todos los privilegios.
Haz clic en Ejecutar.

Desde Syspanel (HestiaCP)

Ingresa a tu Syspanel usando la URL https://tudominio.com:2106 (recuerda el puerto 2106).
Ve a la sección Bases de datos.
Haz clic en Agregar base de datos.
Completa los campos: nombre de la base de datos, usuario y contraseña.
El sistema creará automáticamente la base de datos y el usuario con todos los permisos necesarios.

[INFO] Anota los datos exactos: nombre de la base de datos, usuario y contraseña. Los necesitarás en el siguiente paso.

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

Si estás instalando PrestaShop desde cero, el proceso te guiará para conectar PrestaShop MySQL de forma sencilla.

Ejecuta el instalador de PrestaShop (normalmente accediendo a tudominio.com/install).
Sigue los pasos hasta llegar a la sección Configuración de la base de datos.
Aquí deberás ingresar los datos que preparaste:
- Servidor de base de datos: localhost o la IP que te proporcionó tu hosting.
- Nombre de la base de datos: el que creaste (ejemplo: prestashop_ventas).
- Usuario: el usuario que creaste (ejemplo: usuario_presta).
- Contraseña: la contraseña correspondiente.
- Puerto: si no es el 3306, cámbialo. De lo contrario, déjalo en blanco o 3306.
Haz clic en Probar conexión. Si todo está bien, verás un mensaje verde de éxito.
Continúa con el resto de la instalación.

Paso 3: Configurar la conexión manualmente (si ya tienes PrestaShop instalado)

Si tu tienda ya está funcionando pero necesitas cambiar la base de datos (por ejemplo, porque migraste de servidor), deberás editar el archivo app/config/parameters.php. Este archivo contiene toda la configuración MySQL PrestaShop.

Accede a tu servidor vía FTP o mediante el administrador de archivos de tu hosting.
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Busca el archivo app/config/parameters.php. Si no lo ves, asegúrate de mostrar archivos ocultos.
Ábrelo con un editor de texto (como Notepad++ o el editor integrado del panel).
Busca las líneas que comienzan con 'database_host', 'database_name', 'database_user' y 'database_password'.
Modifica los valores con los nuevos datos de tu base de datos. Por ejemplo:

'database_host' => 'localhost',
'database_name' => 'prestashop_ventas',
'database_user' => 'usuario_presta',
'database_password' => 'tu_contraseña_segura',

Guarda los cambios y cierra el archivo.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una coma o comilla faltante) puede romper tu tienda. Si no te sientes seguro, haz una copia de seguridad antes de modificar.

Errores de conexión comunes y cómo solucionarlos

Incluso siguiendo los pasos al pie de la letra, pueden aparecer errores conexión. Aquí tienes los más frecuentes y sus soluciones.

Error 1: "Access denied for user"

Causa: El usuario o la contraseña son incorrectos, o el usuario no tiene permisos sobre la base de datos.

Solución:

Verifica que el usuario y la contraseña estén escritos exactamente igual (mayúsculas, minúsculas, sin espacios).
Desde phpMyAdmin o Syspanel, revisa que el usuario tenga todos los privilegios sobre la base de datos.
Si usas Syspanel, puedes regenerar la contraseña desde la sección de bases de datos.

Error 2: "Unknown database"

Causa: El nombre de la base de datos no existe o está mal escrito.

Solución:

Confirma que el nombre de la base de datos sea el correcto. Puedes ver la lista de bases de datos desde phpMyAdmin o Syspanel.
Si la base de datos no aparece, créala de nuevo siguiendo el Paso 1.

Error 3: "Can't connect to MySQL server"

Causa: El servidor de base de datos no está accesible. Puede ser por un puerto incorrecto, un firewall o que el servidor MySQL esté caído.

Solución:

Si tu hosting usa un puerto diferente al 3306, asegúrate de especificarlo en la configuración (campo database_port).
Contacta a tu proveedor de hosting para confirmar que el servicio MySQL está activo.
Si estás en un servidor local (como XAMPP), verifica que el módulo MySQL esté encendido.

Error 4: "Table 'ps_configuration' doesn't exist"

Causa: La base de datos está vacía o no tiene las tablas de PrestaShop.

Solución:

Si estás instalando desde cero, asegúrate de que el instalador haya creado las tablas correctamente. Vuelve a ejecutar el instalador.
Si estás migrando, necesitas importar un backup de tu base de datos anterior. Usa phpMyAdmin o la herramienta de importación de Syspanel.

Consejos para mantener tu base de datos segura

Una vez que hayas logrado conectar PrestaShop MySQL, no te olvides de la seguridad. Una base de datos mal protegida puede exponer información sensible de tus clientes.

Usa contraseñas fuertes: Combina mayúsculas, minúsculas, números y símbolos. Nada de "123456" o "admin".
Cambia el prefijo de las tablas: Durante la instalación, PrestaShop te permite cambiar el prefijo predeterminado ps_ por otro. Esto dificulta los ataques de inyección SQL.
Realiza backups periódicos: Programa copias de seguridad automáticas de tu base de datos. Muchos hostings (incluyendo Syspanel) ofrecen esta opción.
Actualiza PrestaShop y MySQL: Mantén todo actualizado para evitar vulnerabilidades conocidas.
Limita el acceso: Si usas un servidor dedicado, permite la conexión a MySQL solo desde direcciones IP específicas.

[INFO] En Syspanel, puedes programar backups automáticos desde la sección Backups. Recuerda que el acceso es por el puerto 2106.

Preguntas frecuentes (FAQ)

¿Puedo usar una base de datos remota para mi PrestaShop?

Sí, siempre que el servidor MySQL permita conexiones externas. Deberás especificar la IP o el nombre del servidor remoto en el campo database_host. Ten en cuenta que esto puede aumentar la latencia.

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

Puedes cambiarla desde phpMyAdmin (buscando el usuario y usando la opción "Cambiar contraseña") o desde Syspanel en la sección de bases de datos. Luego actualiza el archivo parameters.php con la nueva contraseña.

¿Es necesario usar UTF-8 en la base de datos?

Sí, especialmente si tu tienda vende en varios idiomas o usa caracteres especiales (acentos, ñ, etc.). El cotejamiento utf8_general_ci es el estándar para PrestaShop.

¿Puedo tener varias tiendas PrestaShop con una sola base de datos?

No es recomendable. Cada instalación de PrestaShop debe tener su propia base de datos para evitar conflictos de tablas.

¿Qué es el archivo parameters.php y por qué es tan importante?

Es el archivo que contiene la configuración de conexión a la base de datos, entre otros parámetros. Sin él, PrestaShop no puede comunicarse con MySQL. Por eso debes protegerlo y no compartirlo.

Conclusión

Conectar PrestaShop a una base de datos MySQL puede parecer técnico al principio, pero siguiendo estos pasos verás que es un proceso bastante mecánico. Ya sea que estés instalando desde cero o modificando una tienda existente, recuerda siempre tener a mano los datos de conexión, hacer copias de seguridad antes de cualquier cambio y mantener la seguridad como prioridad.

Si encuentras algún error, no entres en pánico. Revisa cada uno de los puntos que hemos visto: permisos de usuario, nombre de la base de datos, puerto y sintaxis del archivo parameters.php. Con paciencia y esta guía, tu tienda online estará funcionando en poco tiempo.

[TIP] ¿Usas Syspanel? No olvides que el acceso es por el puerto 2106, y allí puedes gestionar todas tus bases de datos de forma visual y segura. ¡Ahorrarás mucho tiempo!

Esperamos que esta guía te haya sido de ayuda. Si tienes más dudas, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting. ¡Buena suerte con tu tienda online!