Conectar PrestaShop a MySQL: Parámetros de conexión y solución de errores

¿Qué necesitas para conectar PrestaShop a MySQL?

Antes de lanzarte a editar archivos, es importante que entiendas qué piezas necesitas tener a mano. Conectar PrestaShop a una base de datos MySQL no es magia, es simplemente indicarle a la tienda dónde y cómo debe guardar sus productos, pedidos y clientes.

Para ello, necesitarás:

Nombre de la base de datos (ejemplo: tienda_prestashop)
Usuario de la base de datos (ejemplo: usuario_tienda)
Contraseña del usuario (la que hayas definido al crear el usuario)
Servidor de la base de datos (normalmente localhost o una IP como 127.0.0.1, aunque en hosting compartido puede ser algo como mysql.tudominio.com)
Prefijo de tablas (por defecto es ps_, pero puede variar)
Puerto de conexión (casi siempre es el 3306, pero si usas Syspanel, a veces puede estar personalizado)

Tener estos datos a mano te ahorrará dolores de cabeza. Si no los tienes, contacta con tu proveedor de hosting o revisa el panel de control de tu servidor (por ejemplo, Syspanel, al que accedes por el puerto 2106).

¿Dónde se guarda la configuración de conexión en PrestaShop?

PrestaShop guarda todos los parámetros de conexión a la base de datos en un archivo llamado parameters.php. Este archivo se encuentra en la carpeta app/config/ de tu instalación.

Ese archivo es el "corazón" de la conexión. Si está mal configurado, tu tienda no arranca o te muestra errores de conexión a la base de datos.

Estructura del archivo parameters.php

El archivo contiene un array con todas las credenciales. Algo parecido a esto:

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

Cada línea es un dato que debes revisar y ajustar según tu servidor.

Pasos para conectar PrestaShop a MySQL correctamente

1. Localiza el archivo parameters.php

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

/tu_dominio/app/config/parameters.php

Si tu instalación está en una subcarpeta, ajusta la ruta en consecuencia.

2. Haz una copia de seguridad del archivo original

Antes de tocar nada, copia el archivo a tu ordenador o renómbralo como parameters.php.bak. Así, si algo sale mal, puedes restaurarlo fácilmente.

3. Edita los parámetros de conexión

Abre el archivo con un editor de texto plano (nada de Word) y modifica los valores que necesites:

database_host: normalmente localhost, pero si tu base de datos está en otro servidor, pon la IP o el nombre del servidor.
database_port: casi siempre 3306. Si tu hosting usa otro, te lo habrán indicado.
database_name: el nombre exacto de tu base de datos.
database_user: el usuario con permisos sobre esa base de datos.
database_password: la contraseña de ese usuario.
database_prefix: el prefijo de las tablas. Si no sabes cuál es, revisa en tu base de datos actual.

[WARNING] No cambies el prefijo si ya tienes una tienda funcionando con datos. Hacerlo romperá todas las tablas y perderás el acceso a tus productos y pedidos.

4. Guarda los cambios y sube el archivo

Guarda el archivo con los nuevos valores y súbelo a tu servidor reemplazando el original.

5. Comprueba la conexión

Accede a tu tienda en el navegador. Si todo está bien, verás tu tienda funcionando con normalidad. Si hay algún error, te aparecerá un mensaje indicando que no se puede conectar a la base de datos.

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

Si estás instalando PrestaShop desde cero, el proceso es más sencillo porque el asistente de instalación te guía paso a paso.

Paso 1: Llega a la pantalla de configuración de base de datos

Durante la instalación, llegarás a un paso llamado "Configuración de la base de datos". Ahí tendrás que rellenar los campos con los datos de tu MySQL.

Paso 2: Rellena los campos correctamente

Los campos que verás son:

Servidor de base de datos: localhost o el que te indique tu hosting.
Puerto: 3306 normalmente.
Nombre de la base de datos: el que hayas creado previamente.
Usuario: el usuario con permisos.
Contraseña: la contraseña del usuario.
Prefijo de tablas: déjalo como ps_ si es una instalación nueva.

[TIP] Si no sabes qué puerto usar, prueba primero con 3306. Es el estándar en la gran mayoría de servidores. Si falla, revisa la documentación de tu hosting o de Syspanel.

Paso 3: PrestaShop comprueba la conexión

El instalador verificará automáticamente si los datos son correctos. Si todo está bien, continuará con la instalación. Si no, te avisará del error para que corrijas los datos.

Errores comunes al conectar PrestaShop a MySQL

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

Este es el error más habitual. Suele deberse a:

Datos incorrectos: revisa usuario, contraseña y nombre de la base de datos.
Permisos insuficientes: el usuario no tiene acceso a la base de datos. Ve a tu panel de control y otorga todos los privilegios.
Servidor bloqueado: a veces el hosting bloquea conexiones externas. Si tu base de datos está en un servidor diferente al de PrestaShop, asegúrate de que el acceso remoto esté habilitado.

Error: "Tabla no encontrada"

Esto ocurre cuando el prefijo de tablas no coincide con el que usa la base de datos. Revisa el valor de database_prefix en parameters.php.

Error: "Acceso denegado para el usuario"

El usuario no tiene permisos sobre la base de datos. Entra en tu panel de control (por ejemplo, Syspanel), busca la base de datos y asegúrate de que el usuario esté vinculado con todos los privilegios.

Error: "Puerto no válido"

Si tu servidor MySQL usa un puerto diferente al 3306, debes indicarlo en el campo database_port. En Syspanel, por ejemplo, puedes ver el puerto exacto en la sección de bases de datos.

[INFO] En Syspanel, el acceso al panel se realiza a través del puerto 2106. Una vez dentro, podrás gestionar tus bases de datos MySQL y ver los puertos y credenciales exactos.

Configurar la conexión desde Syspanel (antes HestiaCP)

Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el proceso es muy visual y sencillo.

1. Accede a Syspanel

Abre tu navegador y entra en:

https://tu-dominio:2106

Introduce tu usuario y contraseña de administrador.

[TIP] Si no recuerdas la contraseña, puedes recuperarla desde el correo electrónico que recibiste al crear el hosting o contactando con tu proveedor.

2. Crea la base de datos

En el panel lateral, busca la sección Bases de datos y haz clic en Añadir base de datos.

Rellena los campos:

Nombre de la base de datos
Usuario
Contraseña (o genera una automática)

3. Copia los datos de conexión

Syspanel te mostrará los datos de conexión: servidor, puerto, nombre de la base, usuario y contraseña. Copia estos datos porque los necesitarás para configurar PrestaShop.

4. Usa esos datos en PrestaShop

Tanto si estás instalando PrestaShop como si ya lo tienes instalado y vas a editar parameters.php, usa los datos que te proporciona Syspanel.

[WARNING] Syspanel puede usar un puerto de base de datos distinto al 3306. Revisa siempre el dato que te muestra el panel para evitar errores de conexión.

Cómo cambiar la contraseña de la base de datos sin romper PrestaShop

A veces necesitas cambiar la contraseña de tu base de datos por seguridad. Si lo haces, debes actualizar también el archivo parameters.php.

Pasos:

Cambia la contraseña en tu panel de control (Syspanel o el que uses).
Edita parameters.php y actualiza el valor de database_password.
Guarda el archivo y sube los cambios.
Comprueba que tu tienda sigue funcionando.

[INFO] Si tu tienda da error después del cambio, es que no has actualizado bien el archivo o que hay caché. Borra la carpeta var/cache/ de PrestaShop para forzar la recarga de la configuración.

Buenas prácticas al conectar PrestaShop a MySQL

Usa contraseñas fuertes: evita contraseñas como "123456" o "admin". Una buena contraseña tiene letras, números y símbolos.
No uses el usuario root: crea un usuario específico para tu base de datos con solo los permisos necesarios.
Haz copias de seguridad antes de tocar nada: tanto del archivo parameters.php como de la base de datos completa.
Mantén el prefijo por defecto: salvo que tengas una razón muy concreta, ps_ es perfecto.
Revisa los logs: si algo falla, mira los logs de error de PrestaShop en var/logs/ para entender qué está pasando.

Preguntas frecuentes (FAQ)

¿Puedo usar una base de datos MySQL de otro servidor?

Sí, siempre que el servidor permita conexiones remotas. Tendrás que configurar database_host con la IP o nombre del servidor remoto y asegurarte de que el puerto esté abierto.

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

Puedes resetearla desde tu panel de control. En Syspanel, entra en la sección de bases de datos, selecciona la que necesites y cambia la contraseña. Luego actualiza parameters.php con la nueva.

¿Es normal que PrestaShop tarde en conectar?

Si la conexión es lenta, puede ser porque el servidor de base de datos está lejos o saturado. También puede deberse a un puerto incorrecto que hace reintentos. Revisa que el puerto sea el correcto.

¿Puedo cambiar el prefijo de las tablas después de instalar?

No es recomendable. Cambiar el prefijo implica renombrar todas las tablas y actualizar muchas referencias en el código. Es un proceso muy propenso a errores.

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

Es el archivo de configuración principal de PrestaShop. Contiene las credenciales de la base de datos, la URL de la tienda y otros parámetros esenciales. Si se corrompe, la tienda deja de funcionar.

Conclusión

Conectar PrestaShop a una base de datos MySQL es un proceso sencillo si tienes claros los datos de conexión y sabes dónde mirar. La clave está en el archivo parameters.php y en tener a mano las credenciales correctas de tu servidor.

Recuerda:

Revisa siempre el puerto, especialmente si usas Syspanel.
Haz copias de seguridad antes de modificar nada.
Si algo falla, los logs de PrestaShop son tus mejores aliados.
Y si te pierdes, vuelve a este artículo paso a paso.

Con un poco de paciencia, tu tienda estará conectada a su base de datos y lista para funcionar. ¡Manos a la obra!