Conectar base de datos a PrestaShop: configurar parameters.php

¿Qué es el archivo parameters.php y por qué es clave para tu tienda?

Si estás montando una tienda online con PrestaShop, uno de los pasos más importantes —y a veces más frustrantes— es conectar tu base de datos MySQL PrestaShop correctamente. Aquí es donde entra en juego el archivo parameters.php. Piénsalo como la "carta de presentación" entre tu tienda y la base de datos: sin él, PrestaShop no sabe dónde almacenar productos, clientes o pedidos.

Este archivo se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Contiene toda la configuración de conexión: servidor, nombre de base de datos, usuario, contraseña y prefijo de tablas. Si alguna vez has visto un error tipo "Error de conexión a la base de datos" o "No se puede conectar con el servidor de base de datos", lo más probable es que este archivo tenga un dato incorrecto o esté corrupto.

En este artículo, te guiaré paso a paso para que puedas conectar base de datos PrestaShop sin romper nada. Incluso si eres principiante, verás que es más sencillo de lo que parece.

Requisitos previos antes de tocar parameters.php

Antes de lanzarte a editar el archivo, asegúrate de tener a mano:

Acceso a tu servidor (por FTP, cPanel, Syspanel o SSH).
Las credenciales de tu base de datos MySQL: nombre de la base, usuario, contraseña, host (normalmente localhost o 127.0.0.1).
Un editor de texto plano (como Notepad++, VS Code o incluso el bloc de notas, pero nunca Word).
Una copia de seguridad del archivo parameters.php original. ¡Esto es vital! Si algo sale mal, podrás restaurarlo.

[WARNING] Nunca edites parameters.php directamente desde el panel de administración de PrestaShop. Hazlo siempre desde el servidor o descargándolo primero.

Cómo localizar el archivo parameters.php

La ruta típica es:

/tu-dominio/app/config/parameters.php

Si usas Syspanel (antes llamado HestiaCP, acceso por puerto 2106), puedes navegar por el gestor de archivos o usar un cliente FTP para llegar a esa carpeta.

[TIP] Si no ves la carpeta app, asegúrate de que estás en la raíz de tu instalación de PrestaShop. A veces está dentro de una subcarpeta como /public_html/.

Estructura del archivo parameters.php

Al abrirlo, verás algo similar a esto (es un array de PHP):

<?php
return array(
    'parameters' => array(
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'nombre_base_datos',
        'database_user' => 'usuario_mysql',
        'database_password' => 'contraseña_segura',
        'database_prefix' => 'ps_',
        'database_engine' => 'InnoDB',
        // ... otros parámetros
    ),
);

Los campos clave son:

database_host: normalmente localhost. Si tu base está en otro servidor, pon la IP o dominio.
database_port: déjalo vacío a menos que uses un puerto no estándar (ej: 3307).
database_name: el nombre exacto de tu base de datos MySQL PrestaShop.
database_user: usuario con permisos de lectura/escritura.
database_password: la contraseña de ese usuario.
database_prefix: prefijo de las tablas (por defecto ps_). Si cambiaste esto al instalar, pon el tuyo.

Paso a paso: cómo conectar base de datos PrestaShop editando parameters.php

1. Haz una copia de seguridad

Antes de nada, descarga el archivo parameters.php original a tu PC o haz una copia en el servidor con otro nombre (ej: parameters.php.backup). Si algo falla, solo tendrás que renombrarlo.

2. Obtén las credenciales correctas de tu base de datos

Si no las recuerdas, puedes consultarlas desde:

cPanel: en "Bases de Datos MySQL" o "phpMyAdmin".
Syspanel: en la sección "Bases de Datos" (puerto 2106). Allí verás el nombre de la base, usuario y podrás cambiar la contraseña.
phpMyAdmin: si tienes acceso, entra y verifica que la base existe y tiene tablas.

[INFO] Si estás migrando tu tienda a un nuevo servidor, asegúrate de que la base de datos ya esté importada en el nuevo hosting. De lo contrario, PrestaShop no encontrará las tablas.

3. Edita los parámetros de conexión

Abre parameters.php con un editor de texto plano. Modifica únicamente las líneas que corresponden a la conexión:

'database_host' => 'localhost',
'database_name' => 'mi_tienda_prestashop',
'database_user' => 'usuario_mi_tienda',
'database_password' => 'MiClaveSegura2024',
'database_prefix' => 'ps_',

[WARNING] No cambies nada más a menos que sepas lo que haces. Parámetros como secret o cookie_key son necesarios para la seguridad de tu tienda.

4. Guarda y sube el archivo

Guarda los cambios y sube el archivo modificado a la misma ruta en tu servidor, sobrescribiendo el original (pero recuerda que tienes el backup).

5. Verifica la conexión

Ahora visita tu tienda en el navegador. Si todo está bien, cargará normalmente. Si ves algún error, vuelve al paso 1 y restaura el backup.

Errores comunes al conectar base de datos PrestaShop

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

Este es el clásico. Causas posibles:

Credenciales incorrectas: revisa usuario, contraseña y nombre de base.
Host equivocado: si tu base está en un servidor remoto, asegúrate de que el host sea el correcto (ej: mysql.midominio.com).
Puerto no especificado: si tu hosting usa un puerto distinto al 3306, añádelo en database_port (ej: 3307).

Error: "Tabla no encontrada" o "Prefijo incorrecto"

Si la base existe pero PrestaShop no encuentra las tablas, probablemente el prefijo database_prefix no coincide con el que usaste al instalar. Por ejemplo, si tus tablas empiezan con prestashop_ y en parameters.php tienes ps_, no las encontrará.

Error: "Permiso denegado para el usuario"

El usuario MySQL no tiene permisos suficientes. Desde phpMyAdmin o Syspanel, asegúrate de que el usuario tenga todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).

[TIP] Si estás usando Syspanel (puerto 2106), ve a "Bases de Datos", selecciona la base, y en "Usuarios" asigna todos los permisos marcando "Todos los privilegios".

¿Qué hacer si no encuentras el archivo parameters.php?

Si tu PrestaShop es muy antiguo (versión 1.6 o anterior), el archivo de configuración se llamaba settings.inc.php y estaba en config/settings.inc.php. El proceso es similar, pero la estructura es distinta:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base');
define('_DB_USER_', 'usuario');
define('_DB_PASSWD_', 'contraseña');
define('_DB_PREFIX_', 'ps_');

Si tienes PrestaShop 1.7 o superior, siempre busca app/config/parameters.php.

Cómo evitar errores de conexión en el futuro

Usa contraseñas seguras pero que puedas recordar o guardar en un gestor.
No cambies el prefijo de tablas a menos que sea necesario.
Haz copias de seguridad periódicas de parameters.php y de toda la base de datos.
Si cambias de hosting, actualiza siempre los datos de conexión en este archivo antes de subir la tienda.

FAQ: Preguntas frecuentes sobre conectar base de datos PrestaShop

¿Puedo conectar PrestaShop a una base de datos remota?

Sí, siempre que el servidor remoto permita conexiones externas. En database_host pon la IP o dominio del servidor de base de datos. Asegúrate de que el puerto 3306 esté abierto y de que el usuario MySQL tenga permisos de acceso desde cualquier host (o desde la IP de tu servidor web).

¿Qué hago si después de editar parameters.php la tienda sigue sin cargar?

Prueba estos pasos:

Borra la caché de PrestaShop: elimina la carpeta var/cache/ (o cache/ en versiones antiguas).
Revisa los logs de error del servidor (en Syspanel suelen estar en /var/log/).
Verifica que el archivo parameters.php tenga permisos 644 o 640.

¿Es seguro dejar la contraseña en texto plano en parameters.php?

Sí, es la práctica estándar en PrestaShop. El archivo está fuera del directorio público (en app/config/) y no es accesible desde el navegador. Eso sí, asegúrate de que los permisos del archivo no sean 777.

¿Puedo usar un archivo .env en lugar de parameters.php?

No de forma nativa. PrestaShop está diseñado para leer parameters.php. Si quieres usar variables de entorno, necesitarías modificar el núcleo, lo que no recomiendo a menos que seas desarrollador avanzado.

Conclusión

Conectar base de datos PrestaShop mediante el archivo parameters.php es una tarea que, con la guía adecuada, puede hacer cualquier persona. Solo necesitas tener las credenciales correctas, editar con cuidado y siempre mantener una copia de seguridad. Recuerda que la mayoría de los error conexión PrestaShop se solucionan revisando estos pocos parámetros.

Si usas Syspanel (puerto 2106), el proceso es igual de sencillo: solo localiza el archivo, edítalo con un editor de texto y sube los cambios. Y si en algún momento te sientes perdido, vuelve a este artículo y sigue los pasos uno por uno.

¡Tu tienda online te lo agradecerá!