Conexión a base de datos en PrestaShop: configurar parámetros de MySQL

¿Tu tienda PrestaShop muestra un error de base de datos y no sabes qué hacer? Tranquilo, es uno de los problemas más comunes, pero también uno de los más fáciles de solucionar si sabes dónde mirar.

En esta guía completa, vamos a desgranar todo lo que necesitas saber sobre la conexión a base de datos en PrestaShop, desde qué es cada archivo hasta cómo resolver los errores más frecuentes.

Vamos a ello.

¿Qué es la conexión a base de datos en PrestaShop?

Cuando instalas PrestaShop, el sistema necesita un lugar donde guardar toda la información: productos, pedidos, clientes, configuración, etc.

Ese lugar es una base de datos MySQL.

La "conexión" es el puente que permite que tu tienda hable con esa base de datos.

Si ese puente se rompe, tu tienda no puede mostrar ni guardar nada.

Por eso, entender cómo funciona la conexión es clave para mantener tu negocio online sano.

¿Qué es MySQL y por qué PrestaShop lo usa?

MySQL es un sistema de gestión de bases de datos.

Es gratuito, muy fiable y funciona perfectamente con PHP, el lenguaje en el que está escrito PrestaShop.

Piensa en MySQL como un enorme archivador.

Cada vez que un cliente visita tu tienda, PrestaShop abre un cajón de ese archivador para buscar el precio de un producto.

Si el archivador no está bien configurado o la llave (los datos de conexión) no es la correcta, el cajón no se abre.

Los 3 datos imprescindibles para conectar PrestaShop MySQL

Antes de tocar nada, necesitas tener claros estos tres datos.

Son la base de todo.

1. El nombre de la base de datos (ejemplo: miusuario_prestashop).
2. El usuario de la base de datos (ejemplo: miusuario_admin).
3. La contraseña de ese usuario (la que pusiste al crear la BD).
4. El servidor de la base de datos (normalmente localhost, pero a veces es una IP como 127.0.0.1 o un nombre tipo mysql.midominio.com).

No confundas el usuario de la base de datos con el usuario de administración de tu panel de control.

Son cosas distintas.

El archivo mágico: parameters.php prestashop

Aquí está el corazón de toda la configuración.

PrestaShop guarda todos los datos de conexión en un archivo llamado parameters.php.

Este archivo se encuentra en la carpeta app/config/ de tu instalación.

Si alguna vez has oído hablar de "configurar prestashop bd", este es el sitio.

¿Cómo localizar y editar parameters.php?

Para verlo, necesitas acceder a los archivos de tu hosting.

Puedes hacerlo mediante el Administrador de Archivos de tu panel de control o con un cliente FTP como FileZilla.

La ruta exacta es:

/public_html/app/config/parameters.php

IMPORTANTE: Este archivo es extremadamente sensible.

Contiene las contraseñas de tu tienda.

Asegúrate de no compartirlo nunca y de no subirlo a foros públicos.

Estructura básica de parameters.php

El archivo parece un galimatías al principio, pero es muy lógico.

Busca la línea que dice 'database_host' =>.

Ahí verás algo como esto:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'miusuario_prestashop',
'database_user' => 'miusuario_presta',
'database_password' => 'TuContraseñaSuperSecreta',

Si necesitas cambiar la contraseña de tu base de datos (por ejemplo, porque la has renovado en tu hosting), este es el lugar exacto para hacerlo.

Cómo configurar la base de datos en una instalación nueva

Si estás instalando PrestaShop desde cero, el asistente de instalación te pedirá estos datos.

Es un proceso guiado, pero conviene saber qué espera cada campo.

Paso a paso en el instalador

1. Introduce el nombre de la base de datos: Asegúrate de que existe en tu hosting. Si no, créala antes desde el panel de control.
2. Introduce el usuario de la base de datos: Debe tener privilegios completos sobre esa base de datos.
3. Introduce la contraseña: Cuidado con las mayúsculas y minúsculas, es un campo sensible.
4. Prefijo de tabla: El valor por defecto es ps_. Si no sabes qué es, déjalo así.

¿Qué pasa si no recuerdo la contraseña de MySQL?

Esto es muy común.

No te preocupes, tiene solución.

Si tienes acceso a tu panel de control de hosting, puedes resetear la contraseña de la base de datos desde la sección "Bases de Datos MySQL".

Una vez la cambies, deberás actualizar el archivo parameters.php con la nueva contraseña.

Si no lo haces, tu tienda dará error.

[WARNING] Si cambias la contraseña de la BD en el hosting, tu tienda se caerá en el mismo instante.
Ten el archivo parameters.php preparado para editarlo inmediatamente después.

Errores conexion prestashop: Los 5 problemas más habituales

Vamos a lo que de verdad te interesa: solucionar errores.

Estos son los fallos que vemos a diario en soporte.

1. Error "Link to database cannot be established"

Este es el error clásico.

Suele aparecer justo después de mover la tienda a un nuevo hosting o al cambiar la contraseña de la BD.

Solución:

Revisa el parameters.php.

Comprueba que database_host, database_user y database_password son exactamente los que tienes en tu nuevo hosting.

2. Error "Access denied for user"

Este error indica que el usuario no tiene permisos para acceder a la base de datos.

Solución:

Entra en tu panel de control de hosting y verifica que el usuario está vinculado a la base de datos correcta.

En muchos paneles (como cPanel o Syspanel), debes añadir el usuario a la base de datos y otorgarle TODOS los privilegios.

3. Error "Unknown database"

Este error dice que la base de datos que indicas en parameters.php no existe en el servidor.

Solución:

Verifica que has escrito bien el nombre.

A veces, el hosting añade un prefijo con tu nombre de usuario, por ejemplo: usuario123_prestashop.

No pongas solo prestashop.

4. Error "Too many connections"

Este es un problema de recursos.

Tu base de datos tiene un límite de conexiones simultáneas y lo has superado.

Solución:

Esto suele pasar por plugins mal configurados o por un pico de tráfico.

Reinicia la base de datos desde tu panel de control si es posible.

Si es recurrente, contacta con tu proveedor de hosting para aumentar el límite.

5. Error de puerto

A veces, el puerto no es el 3306 (el estándar).

Si tu hosting usa un puerto personalizado, debes indicarlo.

Solución:

En parameters.php, busca la línea 'database_port' y cámbiala al puerto correcto.

Tu proveedor de hosting te dirá cuál es.

¿Cómo editar parameters.php de forma segura?

No uses el Bloc de Notas de Windows para editar este archivo.

Puede guardar caracteres extraños que rompan la conexión.

Usa un editor de texto plano como Notepad++ o Visual Studio Code.

Pasos para editar sin romper nada

1. Descarga el archivo parameters.php a tu ordenador.
2. Haz una copia de seguridad del archivo original (por si acaso).
3. Ábrelo con Notepad++.
4. Modifica solo los valores que necesites.
5. Guarda el archivo con la codificación UTF-8 sin BOM.
6. Sube el archivo de vuelta a la carpeta app/config/, sobrescribiendo el anterior.

[TIP] Antes de subir el archivo modificado, comprueba que la sintaxis PHP es correcta.
Un simple error de coma o comilla puede dejar tu tienda en blanco.

La importancia del prefijo de tabla (ps_)

En parameters.php también verás la línea 'database_prefix' => 'ps_'.

Este prefijo se añade al principio de cada tabla de la base de datos.

¿Por qué es útil?

Si tienes varias aplicaciones en la misma base de datos, el prefijo evita que se mezclen.

Si alguna vez has visto tablas como ps_product o ps_order, ya sabes de qué hablo.

Consejo: Si estás migrando una tienda, asegúrate de que el prefijo en parameters.php coincide con el que tienen las tablas en la base de datos.

Si no, PrestaShop no encontrará sus tablas y dará error.

Cómo conectar PrestaShop a una base de datos remota

A veces, la base de datos no está en el mismo servidor que tu tienda.

Esto es común en arquitecturas de hosting más avanzadas.

Requisitos para conexión remota

1. El servidor MySQL debe estar configurado para aceptar conexiones remotas.
2. El usuario de la BD debe tener permisos para conectarse desde la IP de tu tienda.
3. Debes abrir el puerto 3306 en el firewall.

En parameters.php, en lugar de 'localhost', pondrías la IP del servidor de la base de datos.

'database_host' => '192.168.1.100',

[WARNING] Conectar a una BD remota es más lento que una local.
Solo hazlo si es estrictamente necesario y tu hosting lo recomienda.

Solución rápida: ¿Y si no quiero tocar código?

Entiendo que editar un archivo PHP puede dar miedo.

Hay una alternativa más visual.

Usando el instalador de PrestaShop

Puedes usar el propio instalador de PrestaShop para arreglar la conexión.

1. Descarga el archivo install de PrestaShop desde tu cuenta de descargas.
2. Sube la carpeta install a la raíz de tu hosting.
3. Accede a tudominio.com/install.
4. Sigue los pasos hasta la sección de base de datos.
5. Introduce los datos correctos.
6. El instalador actualizará el parameters.php por ti.

Este método es muy útil si no te sientes cómodo editando archivos.

Consejos de seguridad para tu base de datos

Una base de datos mal protegida es una puerta abierta a los hackers.

Toma nota de estos consejos.

Cambia el prefijo por defecto

Si tu tienda aún no tiene muchos datos, considera usar un prefijo distinto a ps_.

Por ejemplo: mistienda_.

Esto dificulta los ataques de inyección SQL automatizados.

Usa contraseñas fuertes

La contraseña de la base de datos debe ser larga y compleja.

Combina mayúsculas, minúsculas, números y símbolos.

No uses el usuario "root" de MySQL

Crea un usuario específico para PrestaShop con solo los permisos necesarios.

Así, si alguien roba esa contraseña, no tendrá acceso al resto de tus bases de datos.

Preguntas frecuentes (FAQ) sobre conexión a BD

Aquí tienes las dudas que más nos llegan al soporte.

¿Dónde encuentro los datos de mi base de datos?

En el panel de control de tu hosting.

Si usas cPanel, busca la sección "Bases de datos MySQL".

Si usas Syspanel (recuerda, el puerto de acceso es el 2106), busca la sección equivalente.

Allí verás el nombre de la BD, el usuario y podrás cambiar la contraseña.

¿Puedo usar la misma base de datos para dos tiendas PrestaShop?

Técnicamente sí, pero no es recomendable.

Usarían las mismas tablas y se sobrescribirían los datos.

Si insistes, usa prefijos diferentes (por ejemplo, tienda1_ y tienda2_), pero es una mala práctica.

¿Qué hago si mi tienda da error tras actualizar la contraseña de MySQL?

Es porque el parameters.php sigue teniendo la contraseña antigua.

Edita el archivo y pon la nueva contraseña.

Guarda y sube.

¿Por qué mi hosting usa un puerto distinto al 3306?

Por seguridad, algunos proveedores de hosting personalizan los puertos.

Es una medida para evitar ataques masivos.

Revisa la documentación de tu proveedor o contacta con su soporte.

¿Qué es el "database_engine" en parameters.php?

Es el motor de almacenamiento.

Por defecto usa InnoDB, que es el más fiable y soporta transacciones.

No lo cambies a menos que sepas muy bien lo que haces.

Resumen: Checklist para una conexión exitosa

Antes de despedirme, te dejo una lista rápida para que verifiques tu configuración.

• ¿El nombre de la base de datos es correcto?
• ¿El usuario de la BD tiene todos los privilegios?
• ¿La contraseña está bien escrita (sin espacios)?
• ¿El host es localhost o el que te indica tu proveedor?
• ¿El puerto es el correcto (normalmente 3306)?
• ¿El prefijo de tabla coincide con el de la BD?
• ¿Has guardado el parameters.php en UTF-8 sin BOM?
• ¿Has subido el archivo a la carpeta app/config/?

Si has respondido "sí" a todo, tu conexión debería funcionar.

Conclusión

Configurar la conexión a base de datos en PrestaShop no tiene por qué ser una pesadilla.

Con entender qué es el archivo parameters.php y saber qué significan los errores más comunes, puedes resolver la mayoría de los problemas en minutos.

Recuerda siempre hacer una copia de seguridad antes de tocar nada y, si te pierdes, no dudes en pedir ayuda a tu proveedor de hosting.

La gestión de tu prestashop base de datos es una habilidad esencial para cualquier dueño de tienda online.

Dominarla te ahorrará muchos dolores de cabeza en el futuro.

Espero que esta guía te haya sido de gran ayuda.

¡Nos vemos en el próximo artículo!