Conectar PrestaShop a MySQL: Configuración y Solución de Problemas

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

Antes de ponernos manos a la obra, es fundamental que entiendas por qué tu tienda online depende de una base de datos. Piensa en MySQL como el almacén central de tu negocio digital. Aquí es donde se guardan los productos, los precios, los clientes, los pedidos, las contraseñas cifradas y toda la configuración de tu tienda.

Cuando un visitante entra en tu web, PrestaShop consulta esta base de datos para mostrarle la información correcta. Si la conexión falla o está mal configurada, tu tienda no cargará o mostrará un error crítico. Por eso, saber conectar PrestaShop a tu base de datos PrestaShop es una habilidad imprescindible, tanto para una instalación inicial como para una migración o una recuperación tras un fallo.

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

El corazón de la configuración de tu conexión a la base de datos se encuentra en un archivo llamado parameters.php. Este archivo se localiza en la carpeta app/config/ de tu instalación de PrestaShop. Contiene las credenciales y los parámetros necesarios para que el sistema se comunique con MySQL.

Dentro de este archivo encontrarás información como el nombre de la base de datos, el usuario, la contraseña, el servidor y el prefijo de las tablas. Es un archivo sensible, por lo que debes protegerlo y no compartirlo. Si alguna vez ves un error PrestaShop relacionado con la conexión a la base de datos, el 90% de las veces la solución pasa por revisar y corregir este archivo.

Requisitos previos antes de conectar PrestaShop a MySQL

Para evitar sustos, asegúrate de tener todo esto preparado antes de empezar:

Acceso a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).
Las credenciales de tu base de datos MySQL (nombre, usuario y contraseña).
El nombre del servidor de la base de datos (normalmente localhost, pero puede ser otro si usas un hosting externo).
Acceso por FTP o al administrador de archivos de tu hosting para editar el parameters.php.
Una copia de seguridad de tu base de datos y de los archivos de PrestaShop, por si acaso.

[WARNING]
Antes de tocar nada, haz una copia de seguridad completa. Un error al editar el parameters.php puede dejar tu tienda inaccesible. Es mejor prevenir que lamentar.

Paso a paso: Cómo conectar PrestaShop a una base de datos MySQL

Vamos a dividir el proceso en dos escenarios: cuando estás haciendo una instalación nueva y cuando ya tienes una tienda funcionando y necesitas cambiar la conexión.

Escenario 1: Instalación nueva de PrestaShop

Si estás instalando PrestaShop desde cero, el asistente de instalación te pedirá los datos de la base de datos. Aquí te explicamos cómo rellenar cada campo:

Nombre de la base de datos: Introduce el nombre exacto que creaste en tu hosting. Por ejemplo, mistienda_prestashop.
Usuario de la base de datos: El usuario que tiene permisos para acceder a esa base de datos. Por ejemplo, mistienda_admin.
Contraseña: La contraseña asociada a ese usuario.
Prefijo de tablas: En la mayoría de los casos, déjalo como ps_. Si no estás seguro, no lo cambies.
Servidor de la base de datos: Normalmente es localhost. Si tu hosting usa un servidor externo, te lo indicará en el panel de control.

El asistente comprobará la conexión y, si todo es correcto, continuará con la instalación. Si te da un error PrestaShop en este punto, revisa que las credenciales sean exactas y que el usuario tenga permisos sobre la base de datos.

Escenario 2: Modificar la conexión en una tienda existente

Si tu tienda ya está funcionando y necesitas cambiar la base de datos (por ejemplo, tras una migración), tendrás que editar el archivo parameters.php. Sigue estos pasos:

Localiza el archivo: Conéctate por FTP a tu hosting y navega hasta app/config/parameters.php. También puedes usar el administrador de archivos de tu panel de control.
Descarga una copia: Antes de editarlo, descarga el archivo original a tu ordenador. Así podrás restaurarlo si algo sale mal.
Edita el archivo: Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text). Busca las líneas que contienen los parámetros de la base de datos. Normalmente verás algo así:

'database_host' => 'localhost',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'contraseña_base_datos',
'database_prefix' => 'ps_',

Sustituye los valores: Cambia los valores por los de tu nueva base de datos. Asegúrate de no dejar espacios adicionales y de mantener las comillas.
Guarda y sube el archivo: Guarda los cambios y sube el archivo modificado a tu servidor, sobrescribiendo el original.
Comprueba tu tienda: Abre tu web en el navegador. Si la conexión es correcta, tu tienda cargará con normalidad. Si no, revisa los pasos anteriores.

[TIP]
Si tu hosting usa Syspanel, recuerda que el acceso al panel de control se realiza a través del puerto 2106. Desde allí podrás gestionar tus bases de datos y usuarios MySQL de forma sencilla.

Errores comunes al conectar PrestaShop a MySQL y cómo solucionarlos

Es muy probable que en algún momento te encuentres con un error PrestaShop relacionado con la base de datos. Aquí tienes los más frecuentes y sus soluciones.

Error: "Link to database cannot be established"

Este es el error más típico. Significa que PrestaShop no puede comunicarse con MySQL. Las causas más comunes son:

Credenciales incorrectas: Revisa el usuario, la contraseña y el nombre de la base de datos en el parameters.php.
Servidor incorrecto: Si tu base de datos no está en localhost, asegúrate de usar el nombre del servidor que te proporciona tu hosting.
El usuario no tiene permisos: Verifica en tu panel de control que el usuario tenga todos los privilegios sobre la base de datos.

Error: "Table 'ps_shop' doesn't exist"

Este error suele aparecer cuando el prefijo de las tablas no coincide con el que se configuró originalmente. Revisa el database_prefix en el parameters.php y asegúrate de que sea el mismo que se usó al instalar.

Error: "Access denied for user"

Este error indica que el usuario no tiene permiso para conectarse a la base de datos. Puede ser por una contraseña incorrecta o porque el usuario no está asociado a la base de datos. Ve a tu panel de control y verifica la configuración del usuario.

[INFO]
Si has cambiado la contraseña de tu base de datos recientemente, no olvides actualizarla también en el parameters.php. Es una de las causas más habituales de errores de conexión.

Cómo crear una base de datos MySQL desde tu panel de control

Si todavía no tienes una base de datos creada, aquí te mostramos cómo hacerlo en los paneles más comunes.

En cPanel

Entra en cPanel y busca la sección Bases de Datos MySQL.
Crea una nueva base de datos con un nombre descriptivo.
Crea un usuario y asigna una contraseña segura.
Añade el usuario a la base de datos y otórgale Todos los privilegios.

En Syspanel (puerto 2106)

Accede a Syspanel a través de https://tu-dominio:2106.
Busca la sección de Bases de Datos o MySQL.
Sigue el asistente para crear una nueva base de datos y un usuario asociado.
Asigna los permisos necesarios al usuario.

[TIP]
Anota siempre el nombre de la base de datos, el usuario y la contraseña en un lugar seguro. Los necesitarás no solo para la instalación, sino también para futuras migraciones o recuperaciones.

Buenas prácticas para mantener tu base de datos PrestaShop segura y optimizada

Una vez que tu tienda está conectada correctamente, es importante mantener la base de datos en buen estado.

Usa contraseñas fuertes

La contraseña de tu base de datos no debe ser fácil de adivinar. Combina letras mayúsculas, minúsculas, números y símbolos. Evita usar la misma contraseña que para el acceso al panel de administración.

Realiza copias de seguridad periódicas

Configura copias de seguridad automáticas de tu base de datos. La mayoría de los paneles de control ofrecen esta opción. Si algo sale mal, podrás restaurar tu tienda rápidamente.

Limpia los datos innecesarios

PrestaShop acumula datos temporales, carritos abandonados y registros antiguos. De vez en cuando, usa los módulos de limpieza o ejecuta consultas SQL para eliminar información obsoleta. Esto mantendrá la base de datos ágil y rápida.

Mantén PrestaShop actualizado

Cada actualización de PrestaShop incluye mejoras de seguridad y correcciones de errores relacionados con la base de datos. Mantén tu versión al día para evitar vulnerabilidades.

Preguntas frecuentes (FAQ) sobre PrestaShop y MySQL

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

Puedes restablecerla desde tu panel de control. En Syspanel (puerto 2106), busca la opción de cambiar contraseña del usuario de la base de datos. Después, actualiza el parameters.php con la nueva contraseña.

¿Puedo usar una base de datos remota para PrestaShop?

Sí, es posible. Solo necesitas el nombre del servidor remoto y asegurarte de que el puerto 3306 esté abierto. Sin embargo, esto puede ralentizar la conexión, por lo que se recomienda usar una base de datos en el mismo servidor siempre que sea posible.

¿Qué es el prefijo de las tablas y por qué es importante?

El prefijo es un texto que se añade al inicio del nombre de cada tabla (por ejemplo, ps_productos). Permite que varias aplicaciones compartan la misma base de datos sin conflicto. Si cambias el prefijo, debes actualizarlo en el parameters.php.

Mi tienda da error después de moverla a otro hosting, ¿qué hago?

Lo más probable es que el parameters.php tenga las credenciales antiguas. Edítalo con los datos del nuevo hosting y asegúrate de haber importado correctamente la base de datos. Si el problema persiste, revisa los permisos del usuario y la ruta del servidor.

Conclusión

Conectar PrestaShop MySQL no tiene por qué ser una pesadilla. Con esta guía, ya sabes cómo funciona el archivo parameters.php, cómo crear una base de datos y cómo solucionar los errores más comunes. Recuerda siempre trabajar con copias de seguridad y mantener tus credenciales a mano.

Si sigues los pasos con calma y atención, tu tienda estará funcionando en poco tiempo. Y si te surge cualquier duda, no dudes en consultar la documentación oficial de PrestaShop o contactar con el soporte de tu hosting.

[WARNING]
Nunca compartas tus credenciales de acceso a la base de datos por correo electrónico o en foros públicos. La seguridad de tu tienda depende de ello.