Configurar conexión a base de datos en PrestaShop | Tutorial

¿Qué es la conexión a la base de datos en PrestaShop y por qué es tan importante?

Cuando instalas PrestaShop, el sistema necesita un lugar donde guardar todos los datos de tu tienda: productos, pedidos, clientes, precios, configuraciones, etc. Ese lugar es la base de datos, normalmente MySQL o MariaDB. La conexión entre PrestaShop y esa base de datos es lo que permite que tu tienda funcione correctamente en todo momento.

Si esa conexión falla, tu tienda mostrará errores del tipo "Error de conexión a la base de datos" o "PrestaShop no puede conectarse a la base de datos". Esto puede deberse a múltiples causas: credenciales incorrectas, servidor de base de datos caído, permisos mal configurados o un archivo de configuración corrupto.

En este artículo te voy a explicar paso a paso cómo configurar la conexión a la base de datos en PrestaShop, ya sea para una instalación nueva, para cambiar de servidor o para solucionar un error de conexión. No necesitas ser un experto en programación, solo seguir las instrucciones con calma.

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

El archivo clave que gestiona la conexión mysql prestashop se llama parameters.php y se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Este archivo contiene un array con todos los parámetros necesarios para que PrestaShop se comunique con tu base de datos: el nombre del servidor, el nombre de la base de datos, el usuario, la contraseña y el prefijo de las tablas.

Cuando hablamos de parameters.php prestashop, nos referimos exactamente a este archivo. Es el corazón de la conexión y el primer lugar donde debes mirar si tienes problemas de conexión.

Estructura típica de parameters.php

El archivo suele tener un aspecto similar a este:

<?php
return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_port' => '3306',
        'database_name' => 'mydatabase',
        'database_user' => 'myuser',
        'database_password' => 'mypassword',
        'database_prefix' => 'ps_',
        'database_engine' => 'InnoDB',
        'database_driver' => 'PDO',
        // ... otros parámetros
    ],
];

Cada uno de estos campos es esencial y debe coincidir con los datos reales de tu servidor de base de datos.

Requisitos previos antes de configurar la conexión

Antes de tocar nada, asegúrate de tener a mano la siguiente información:

Nombre del servidor de base de datos: normalmente es localhost si la base de datos está en el mismo servidor que tu tienda, o una IP o dominio si está en un servidor externo.
Puerto de la base de datos: por defecto, MySQL usa el puerto 3306. Si tu hosting usa un puerto diferente, deberás indicarlo.
Nombre de la base de datos: lo creas en tu panel de control del hosting.
Usuario de la base de datos: el usuario con permisos para acceder a esa base de datos.
Contraseña del usuario: la contraseña asociada a ese usuario.
Prefijo de las tablas: por defecto es ps_, pero puede variar.

Si no tienes estos datos, contacta con tu proveedor de hosting o revisa el panel de administración de tu servidor.

Paso 1: Localizar y editar el archivo parameters.php

El primer paso para configurar conexion prestashop es acceder al archivo parameters.php. Puedes hacerlo de dos maneras:

Opción A: A través del administrador de archivos del hosting

La mayoría de los paneles de control (cPanel, Plesk, Syspanel, etc.) incluyen un administrador de archivos. Si tu hosting usa Syspanel, recuerda que el acceso se realiza a través del puerto 2106. Busca la carpeta app/config/ dentro del directorio raíz de tu PrestaShop y localiza el archivo parameters.php.

Opción B: Mediante FTP o SFTP

Usa un cliente FTP como FileZilla. Conéctate a tu servidor, navega hasta la carpeta app/config/ y descarga el archivo parameters.php a tu ordenador. Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text) y modifícalo.

[WARNING] Nunca uses el Bloc de notas de Windows para editar archivos PHP, ya que puede añadir caracteres invisibles que rompan el archivo. Usa siempre un editor de texto avanzado.

Paso 2: Modificar los parámetros de conexión

Una vez que tengas el archivo abierto, modifica los campos correspondientes:

database_host: pon la dirección del servidor de base de datos. Si es local, localhost. Si es remoto, la IP o el dominio.
database_port: el puerto, normalmente 3306.
database_name: el nombre exacto de tu base de datos.
database_user: el usuario con permisos.
database_password: la contraseña de ese usuario.
database_prefix: el prefijo de las tablas, normalmente ps_.

Guarda los cambios y sube el archivo de nuevo al servidor si lo habías descargado.

[TIP] Si no estás seguro del prefijo de tus tablas, revisa si las tablas de tu base de datos empiezan por ps_ o por otro texto. Puedes verlo desde el panel de administración de tu base de datos.

Paso 3: Verificar los permisos del archivo

Después de editar parameters.php, es importante que el archivo tenga permisos de lectura para el servidor web. Normalmente, los permisos correctos son 644 (lectura y escritura para el propietario, lectura para el grupo y para los demás). En algunos casos, puede que necesites 444 (solo lectura) para evitar modificaciones accidentales.

Si el archivo tiene permisos demasiado restrictivos, como 600, puede que PrestaShop no pueda leerlo y muestre errores de conexión.

Paso 4: Probar la conexión a la base de datos

Una vez que hayas modificado el archivo, es hora de comprobar si la conexión funciona. Puedes hacerlo de varias maneras:

Opción 1: Acceder a tu tienda

Simplemente abre tu tienda en el navegador. Si la conexión es correcta, la tienda cargará con normalidad. Si no, verás un mensaje de error.

Opción 2: Usar un script de prueba

Crea un archivo PHP temporal en la raíz de tu instalación con el siguiente contenido:

<?php
try {
    $pdo = new PDO('mysql:host=localhost;dbname=your_database_name', 'your_user', 'your_password');
    echo 'Conexión exitosa';
} catch (PDOException $e) {
    echo 'Error: ' . $e->getMessage();
}

Reemplaza los datos de conexión con los tuyos y guárdalo como test_db.php. Ábrelo en tu navegador. Si ves "Conexión exitosa", todo está bien. Si ves un error, te indicará cuál es el problema.

[WARNING] Borra este archivo de prueba inmediatamente después de usarlo. Dejarlo en tu servidor es un riesgo de seguridad grave.

Solución de problemas comunes en la conexión mysql prestashop

Aunque hayas seguido los pasos, a veces las cosas no funcionan a la primera. Aquí tienes los problemas más frecuentes y cómo solucionarlos.

Error "Database connection error" o "Error de conexión a la base de datos"

Este es el error más común y suele deberse a credenciales incorrectas. Verifica que:

El nombre de la base de datos no tenga errores tipográficos.
El usuario tenga permisos completos sobre la base de datos.
La contraseña sea exacta, incluyendo mayúsculas y minúsculas.

Error "Unknown database" o "Base de datos desconocida"

Esto indica que el nombre de la base de datos que has puesto en parameters.php no existe. Revisa en tu panel de control del hosting que la base de datos esté creada y que el nombre sea exacto.

Error "Access denied for user" o "Acceso denegado para el usuario"

El usuario no tiene permisos para acceder a la base de datos o la contraseña es incorrecta. Vuelve a generar la contraseña desde tu panel de control o asegúrate de que el usuario esté asociado a la base de datos.

Error "Connection refused" o "Conexión rechazada"

Este error suele aparecer cuando el servidor de base de datos no está accesible desde el servidor donde está PrestaShop. Si tu base de datos está en un servidor remoto, verifica:

Que el servidor de base de datos permita conexiones remotas.
Que el puerto esté abierto en el firewall.
Que estés usando el puerto correcto.

El prefijo de las tablas no coincide

Si PrestaShop se queja de que no encuentra tablas, es posible que el prefijo en parameters.php no coincida con el real. Revisa las tablas en tu base de datos y ajusta el prefijo.

¿Cómo configurar la conexión durante la instalación de PrestaShop?

Si estás instalando PrestaShop desde cero, el propio instalador te pedirá los datos de conexión. Es un proceso guiado y sencillo:

Introduce el nombre del servidor de base de datos.
El puerto (normalmente 3306).
El nombre de la base de datos.
El usuario y la contraseña.
El prefijo de las tablas (deja ps_ por defecto).

El instalador comprobará automáticamente si los datos son correctos y creará el archivo parameters.php con los valores que hayas indicado.

Migrar tu tienda a otro servidor: cómo actualizar la conexión

Si cambias de hosting, tendrás que actualizar la conexión en parameters.php con los nuevos datos. El proceso es el mismo que hemos visto, pero ten en cuenta que además deberás exportar e importar la base de datos completa al nuevo servidor.

[INFO] Al migrar, asegúrate de que la versión de MySQL/MariaDB del nuevo servidor sea compatible con tu versión de PrestaShop. Las versiones muy antiguas de PrestaShop pueden tener problemas con versiones modernas de MySQL.

Buenas prácticas de seguridad para tu base de datos

Configurar la conexión no es solo hacer que funcione, también es hacerlo de forma segura. Sigue estas recomendaciones:

No uses la contraseña del administrador del servidor para la base de datos. Crea un usuario específico con permisos solo sobre la base de datos de PrestaShop.
Cambia las contraseñas periódicamente y actualiza parameters.php después de cada cambio.
No compartas el archivo parameters.php con nadie. Contiene credenciales sensibles.
Mantén la carpeta app/config protegida mediante el archivo .htaccess o los permisos adecuados.
Haz copias de seguridad de tu base de datos y del archivo parameters.php con regularidad.

Preguntas frecuentes sobre la configuración de la conexión

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

Técnicamente puedes, pero no es recomendable. El prefijo de las tablas puede diferenciar las tablas de cada tienda, pero compartir base de datos aumenta el riesgo de conflictos y problemas de rendimiento. Mejor usa bases de datos separadas.

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

Puedes restablecerla desde el panel de control de tu hosting. Si usas Syspanel, accede a través del puerto 2106, busca la sección de bases de datos y cambia la contraseña del usuario. Después, actualiza parameters.php con la nueva contraseña.

¿Por qué PrestaShop muestra un error después de cambiar el servidor de base de datos?

Lo más probable es que el archivo parameters.php siga teniendo los datos del servidor anterior. Actualízalo con los nuevos datos y limpia la caché de PrestaShop. Puedes hacerlo eliminando los archivos de la carpeta var/cache/ (en versiones modernas) o cache/ (en versiones antiguas).

¿Puedo configurar la conexión sin editar el archivo parameters.php?

Si tienes acceso al panel de administración de PrestaShop y la tienda funciona, puedes usar el módulo de "Parámetros avanzados" para cambiar algunos datos, pero la configuración de la base de datos siempre requiere editar el archivo parameters.php. No hay alternativa segura.

Conclusión

Configurar la conexión a la base de datos en PrestaShop es un proceso sencillo si sabes qué archivo editar y qué datos necesitas. El archivo parameters.php es el encargado de guardar toda la información de conexión y, con los pasos que te he explicado, podrás solucionar cualquier problema que surja.

Recuerda siempre verificar los permisos del archivo, probar la conexión después de cualquier cambio y mantener tus credenciales seguras. Si tienes dudas, consulta la documentación oficial de PrestaShop o contacta con tu proveedor de hosting.

[TIP] Guarda una copia de seguridad de parameters.php en un lugar seguro. Si algo sale mal, puedes restaurar la configuración anterior rápidamente.

Espero que esta guía te haya sido útil. Si has seguido todos los pasos y sigues teniendo problemas, revisa los logs de error de PrestaShop y de tu servidor. A veces, el mensaje de error contiene la solución exacta.