Conectar MySQL a PrestaShop | Configuración Sencilla

¿Qué necesitas saber antes de conectar MySQL a PrestaShop?

Conectar tu base de datos MySQL a PrestaShop 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 simplemente no puede funcionar, ya que todos los productos, pedidos, clientes y configuraciones se almacenan en esa base de datos.

Piensa en MySQL como el cerebro de tu PrestaShop: guarda absolutamente todo. Si la conexión falla, tu tienda mostrará errores como "Error de conexión a la base de datos" o "Link to database cannot be established".

En este artículo te voy a explicar paso a paso cómo configurar esa conexión, tanto si estás instalando PrestaShop desde cero como si necesitas modificar el archivo parameters.php de PrestaShop para corregir problemas o migrar tu tienda a otro servidor.

Vamos a ello, sin tecnicismos innecesarios y con instrucciones claras.

¿Qué es el archivo parameters.php en PrestaShop?

El archivo parameters.php es el corazón de la configuración de tu base de datos en PrestaShop. Se encuentra en la carpeta app/config/ de tu instalación y contiene los datos de conexión que tu tienda utiliza para comunicarse con MySQL.

Este archivo se genera automáticamente durante la instalación, pero también puedes editarlo manualmente si necesitas cambiar la contraseña de la base de datos, el servidor, el nombre de la base, o si estás migrando tu tienda a un hosting nuevo.

En versiones antiguas de PrestaShop (1.6 y anteriores) este archivo se llamaba settings.inc.php, pero desde PrestaShop 1.7 en adelante, el archivo correcto es parameters.php.

Cómo conectar MySQL a PrestaShop durante la instalación

Si estás instalando PrestaShop por primera vez, el asistente de instalación te pedirá los datos de conexión a MySQL. Es un proceso sencillo si sabes qué datos necesitas.

Paso 1: Crea la base de datos MySQL

Antes de instalar PrestaShop, necesitas tener una base de datos creada. Puedes hacerlo desde el panel de control de tu hosting, como cPanel, Plesk o Syspanel (recuerda que Syspanel se accede por el puerto 2106).

Desde tu panel de hosting, busca la sección de Bases de Datos MySQL y crea una nueva. Anota estos datos:

Nombre de la base de datos: por ejemplo, miprestashop_db
Usuario de la base de datos: por ejemplo, usuario_presta
Contraseña: elige una segura y guárdala bien
Servidor MySQL: normalmente es localhost, aunque en algunos hosting puede ser una dirección IP o un nombre como mysql.midominio.com

[TIP] Crea siempre un usuario específico para tu base de datos en lugar de usar el usuario root. Es más seguro y la mayoría de los hosting lo recomiendan.

Paso 2: Ejecuta el instalador de PrestaShop

Sube los archivos de PrestaShop a tu servidor (normalmente en la carpeta public_html o htdocs) y abre tu dominio en el navegador. El asistente de instalación te guiará por varios pasos y llegará un momento en que te pedirá los datos de la base de datos.

Paso 3: Introduce los datos de conexión MySQL

En la pantalla de configuración de la base de datos, deberás rellenar los campos:

Dirección del servidor: localhost o el que te haya indicado tu hosting
Nombre de la base de datos: el que creaste
Usuario: el usuario que creaste
Contraseña: la contraseña de ese usuario
Prefijo de las tablas: por defecto es ps_, puedes dejarlo así

Haz clic en Comprobar conexión y, si todo es correcto, verás un mensaje verde indicando que la conexión es exitosa.

[WARNING] Si el instalador te avisa de que no puede conectarse, revisa que hayas escrito bien el usuario y la contraseña. Un simple espacio o una mayúscula mal puesta puede romper la conexión.

Cómo configurar MySQL en PrestaShop editando parameters.php

Si tu tienda ya está instalada pero necesitas cambiar la configuración de la base de datos (por ejemplo, porque cambiaste de hosting o porque el proveedor te pidió modificar la contraseña), tendrás que editar el archivo parameters.php.

Paso 1: Localiza el archivo parameters.php

Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting. La ruta habitual es:

/public_html/app/config/parameters.php

Si tu PrestaShop está instalado en una subcarpeta, la ruta cambiará. Por ejemplo:

/public_html/tienda/app/config/parameters.php

Paso 2: Abre el archivo con un editor de texto

Puedes usar el editor de texto del panel de control de tu hosting, o descargar el archivo y editarlo con un editor local como Notepad++ o VS Code.

Paso 3: Identifica los parámetros de conexión

Dentro del archivo verás una estructura PHP con los parámetros de configuración de la base de datos. Los campos que te interesan son:

database_host: la dirección del servidor MySQL (normalmente localhost)
database_name: el nombre de tu base de datos
database_user: el usuario de la base de datos
database_password: la contraseña del usuario
database_prefix: el prefijo de las tablas (normalmente ps_)

Paso 4: Edita los datos

Cambia los valores por los nuevos datos de conexión. Por ejemplo:

'database_host' => 'localhost',
'database_name' => 'nueva_base_datos',
'database_user' => 'nuevo_usuario',
'database_password' => 'nueva_contraseña',
'database_prefix' => 'ps_',

[INFO] Asegúrate de no borrar las comillas simples ni las comas al final de cada línea, ya que podrías romper el archivo y provocar un error fatal en tu tienda.

Paso 5: Guarda y sube el archivo

Guarda los cambios y sube el archivo de vuelta al servidor si lo habías descargado. Luego, accede a tu tienda para comprobar que todo funciona correctamente.

Errores comunes al conectar MySQL con PrestaShop

Aunque el proceso parece sencillo, es normal encontrarse con algunos errores. Te dejo los más habituales y cómo solucionarlos.

Error: "Link to database cannot be established"

Este es el error más común. Significa que PrestaShop no puede conectarse a la base de datos. Las causas más frecuentes son:

Datos incorrectos: revisa que el usuario, la contraseña y el nombre de la base sean correctos
Servidor MySQL incorrecto: algunos hosting usan un servidor distinto a localhost. Consulta con tu proveedor
Usuario sin permisos: asegúrate de que el usuario de la base de datos tiene permisos de lectura y escritura sobre la base

Error: "Cannot connect to the database. The database does not exist"

Este error indica que PrestaShop encuentra el servidor MySQL pero no encuentra la base de datos. Verifica que el nombre de la base de datos esté bien escrito y que exista realmente en tu servidor.

Error 500 después de editar parameters.php

Si después de editar el archivo te aparece un error 500, es muy probable que hayas cometido un error de sintaxis en el archivo. Revisa que todas las líneas terminan con coma cuando corresponde y que no hayas eliminado ninguna llave } o ).

[WARNING] Antes de editar parameters.php, descarga una copia de seguridad del archivo original. Si algo sale mal, podrás restaurarlo fácilmente.

Cómo conectar PrestaShop a MySQL en Syspanel

Si tu hosting utiliza Syspanel como panel de control (recuerda que se accede por el puerto 2106), el proceso de creación de bases de datos es ligeramente distinto pero igual de sencillo.

Paso 1: Accede a Syspanel

Escribe en tu navegador https://tu-dominio:2106 e inicia sesión con tus credenciales.

Paso 2: Crea la base de datos

Busca la sección de Bases de Datos o MySQL. Allí podrás crear una nueva base de datos, un usuario y asignar permisos. Algunos paneles te permiten hacerlo en un solo paso, indicando que el usuario tendrá todos los privilegios sobre la base.

Paso 3: Configura PrestaShop

Una vez creada la base de datos, utiliza esos datos en el instalador de PrestaShop o en el archivo parameters.php, tal como hemos explicado antes.

[TIP] En Syspanel, el servidor MySQL suele ser localhost. Si no funciona, revisa la documentación del panel o contacta con el soporte de tu hosting.

Migrar tu base de datos PrestaShop a otro servidor

Si vas a cambiar de hosting, tendrás que migrar tanto los archivos como la base de datos. La conexión MySQL es una parte crítica de este proceso.

Paso 1: Exporta la base de datos original

Accede a tu hosting actual y exporta la base de datos. Puedes hacerlo desde phpMyAdmin o desde Syspanel. El resultado será un archivo .sql.

Paso 2: Crea la base de datos en el nuevo servidor

En tu nuevo hosting, crea una base de datos y un usuario con permisos. Anota los nuevos datos.

Paso 3: Importa el archivo .sql

Desde phpMyAdmin o el panel de tu nuevo hosting, importa el archivo .sql que exportaste. Esto restaurará todas tus tablas y datos.

Paso 4: Actualiza parameters.php

Edita el archivo parameters.php de PrestaShop en el nuevo servidor con los nuevos datos de conexión (host, nombre de base, usuario y contraseña).

Paso 5: Comprueba tu tienda

Accede a tu tienda y verifica que los productos, clientes y pedidos están correctamente cargados.

Preguntas frecuentes sobre la configuración MySQL en PrestaShop

¿Qué es el prefijo de las tablas en PrestaShop?

El prefijo es un texto que se añade al nombre de cada tabla de la base de datos. Por defecto es ps_, pero puedes cambiarlo al instalar por motivos de seguridad. Si tu base de datos tiene un prefijo distinto, tendrás que indicarlo en parameters.php.

¿Puedo usar MySQL y MariaDB indistintamente?

Sí. PrestaShop funciona perfectamente con ambos sistemas, ya que MariaDB es compatible con MySQL. La configuración es exactamente la misma.

¿Cada cuánto debo revisar la conexión a la base de datos?

No hay una frecuencia establecida. Solo tendrás que revisarla si experimentas errores de conexión o si cambias de proveedor de hosting.

¿Es seguro editar parameters.php manualmente?

Es seguro siempre que hagas una copia de seguridad antes y edites el archivo con cuidado. Si no te sientes seguro, puedes usar el instalador de PrestaShop para reparar la conexión, aunque el método manual es el más rápido y directo.

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

Puedes cambiar la contraseña desde tu panel de hosting (cPanel, Syspanel, Plesk). Después, simplemente actualiza el valor en parameters.php y listo.

Resumen final: conectar MySQL a PrestaShop no es complicado

Ya seas un usuario principiante o tengas algo de experiencia, conectar tu base de datos MySQL a PrestaShop es un proceso muy manejable. Los puntos clave que debes recordar son:

La base de datos debe existir y tener un usuario con permisos
El archivo parameters.php es donde se guardan los datos de conexión
Si algo falla, revisa primero los datos de conexión y los permisos del usuario
Siempre haz copias de seguridad antes de editar archivos de configuración

Con esta guía, podrás configurar PrestaShop MySQL sin problemas, ya sea en una instalación nueva o migrando tu tienda a otro servidor. Si sigues los pasos y te tomas tu tiempo para verificar cada dato, tu tienda online funcionará sin errores de conexión.

[INFO] Si tu hosting utiliza Syspanel, recuerda que el acceso es a través del puerto 2106. No lo confundas con otros paneles de control.

Espero que este artículo te haya sido de ayuda. Si tienes dudas, revisa la documentación oficial de PrestaShop o contacta con el soporte de tu hosting. ¡Buena suerte con tu tienda online!