Configurar parameters.php en PrestaShop | Guía fácil

¿Qué es parameters.php y por qué es tan importante en PrestaShop?

Si alguna vez has intentado configurar PrestaShop a nivel avanzado, seguramente has escuchado hablar del archivo parameters.php PrestaShop. Este archivo es, ni más ni menos, el corazón de la configuración técnica de tu tienda online.

Piensa en él como el "panel de control invisible" que le dice a PrestaShop cómo conectarse a la base de datos, qué claves de seguridad utilizar o incluso cómo manejar las cookies. Sin este archivo, tu tienda simplemente no podría funcionar: no sabría dónde guardar los productos, ni cómo identificar a tus clientes, ni qué idioma utilizar por defecto.

El archivo parameters.php se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Es un archivo de texto plano que contiene un array de PHP con todas las variables de configuración esenciales. Aunque generalmente se genera automáticamente durante la instalación, hay situaciones en las que necesitarás editarlo manualmente: cambiar de servidor, modificar la URL de la tienda, actualizar credenciales de la base de datos o simplemente resolver errores de conexión.

En esta guía completa, te explicaremos paso a paso cómo configurar este archivo, qué significa cada parámetro y cómo evitar errores comunes. No necesitas ser un experto en programación: con un poco de paciencia y siguiendo estas instrucciones, podrás dominar la configuración PrestaShop avanzada como todo un profesional.

Estructura básica del archivo parameters.php

Antes de empezar a editar nada, es fundamental que entiendas qué contiene este archivo y cómo está organizado. Un típico parameters.php tiene esta estructura:

<?php

return array(
    'parameters' => array(
        'database_host' => 'localhost',
        'database_port' => '3306',
        'database_name' => 'mi_tienda',
        'database_user' => 'usuario_bd',
        'database_password' => 'mi_contraseña',
        'database_prefix' => 'ps_',
        'database_engine' => 'InnoDB',
        'secret' => 'una_clave_secreta_muy_larga',
        'cookie_key' => 'otra_clave_aleatoria',
        'cookie_iv' => 'una_cadena_corta',
        'new_cookie_key' => 'una_tercera_clave',
        'mail_transport' => 'smtp',
        'mail_host' => 'smtp.midominio.com',
        'mail_port' => '465',
        'mail_user' => 'correo@midominio.com',
        'mail_password' => 'contraseña_correo',
        'mail_encryption' => 'ssl',
        'url' => 'https://www.mitienda.com',
        'timezone' => 'Europe/Madrid',
        'locale' => 'es-ES',
        'debug' => false,
        'cache' => 'CacheMemcached',
        'memcached_servers' => array(
            'server1' => array('host' => 'localhost', 'port' => 11211)
        ),
    ),
);

Como puedes ver, cada línea define un parámetro específico. Los más importantes son los relacionados con la base de datos, las claves de seguridad y la URL de la tienda. A continuación, te explicamos cada bloque en detalle.

Configuración de la base de datos en parameters.php

La sección de base de datos es, sin duda, la más crítica. Si estos datos son incorrectos, tu tienda mostrará un error de conexión y no podrás acceder ni al front office ni al back office. Vamos a desglosar cada campo:

database_host y database_port

El database_host es la dirección del servidor donde se encuentra tu base de datos. Normalmente es localhost si la tienda y la base de datos están en el mismo servidor. Si usas un servicio de hosting externo, será algo como mysql.midominio.com o una IP. El database_port casi siempre es 3306 (el puerto estándar de MySQL), pero algunos proveedores usan puertos personalizados.

database_name, database_user y database_password

Estos tres campos son los que identifican tu base de datos y te permiten acceder a ella. El database_name es el nombre exacto que le diste a tu base de datos. El database_user y database_password son las credenciales de acceso.

[WARNING] Es fundamental que el usuario de la base de datos tenga todos los privilegios necesarios sobre esa base de datos. Si solo tiene permisos de lectura, PrestaShop no podrá escribir información y fallará al guardar productos o pedidos.

database_prefix

El prefijo de la base de datos es un identificador que se añade al principio de cada tabla. El valor más común es ps_, pero algunos usuarios lo cambian por seguridad (por ejemplo, mi_tienda_). Si estás migrando una tienda, debes mantener el prefijo original o todos los datos se perderán.

database_engine

PrestaShop permite dos motores de base de datos: InnoDB y MyISAM. El primero es más moderno y recomendado, ya que soporta transacciones y es más seguro. El segundo es más antiguo pero algo más rápido en lecturas simples. Si no sabes cuál usar, déjalo como InnoDB.

Claves de seguridad y cifrado

Este es un apartado que muchos pasan por alto, pero es esencial para la seguridad de tu tienda. Las claves (secret, cookie_key, cookie_iv y new_cookie_key) se utilizan para cifrar contraseñas, tokens de sesión y datos sensibles de los clientes.

¿Qué significan cada una?

secret: Es la clave maestra que se usa para cifrar otros datos.
cookie_key y cookie_iv: Se utilizan para cifrar las cookies de sesión de los usuarios.
new_cookie_key: Se genera cuando cambias la clave anterior, útil si sospechas que alguien ha accedido a tu archivo.

[TIP] Si alguna vez has perdido estas claves o las has borrado por error, puedes regenerarlas. Sin embargo, ten en cuenta que al cambiarlas, todos los usuarios serán desconectados de sus sesiones y deberán volver a iniciar sesión.

Para generar una clave aleatoria segura, puedes usar herramientas online como random.org o simplemente ejecutar el siguiente comando en tu terminal:

openssl rand -base64 32

Configuración del correo electrónico

PrestaShop necesita enviar correos electrónicos para notificaciones de pedidos, recuperación de contraseñas, boletines, etc. Puedes configurar el envío de dos maneras: usando la función mail() de PHP o mediante SMTP (más fiable y recomendado).

Parámetros de SMTP

'mail_transport' => 'smtp',
'mail_host' => 'smtp.gmail.com',
'mail_port' => '465',
'mail_user' => 'tu_correo@gmail.com',
'mail_password' => 'tu_contraseña',
'mail_encryption' => 'ssl',

Si usas Gmail, deberás generar una "contraseña de aplicación" en lugar de usar tu contraseña normal. Para otros proveedores, consulta sus guías de configuración SMTP.

[INFO] Si prefieres usar la función mail() de PHP, simplemente cambia mail_transport a php. Sin embargo, esta opción es menos fiable y muchos servidores de hosting la tienen deshabilitada por problemas de spam.

URL de la tienda y zona horaria

Parámetro 'url'

Este es un campo muy importante. Debe contener la URL completa de tu tienda, incluyendo el protocolo (http o https) y la barra final. Por ejemplo:

'url' => 'https://www.mitienda.com/',

Si cambias de dominio o de subdirectorio, deberás actualizar este campo manualmente. De lo contrario, PrestaShop generará enlaces rotos y no podrás acceder correctamente.

Parámetro 'timezone' y 'locale'

El timezone define la zona horaria de tu tienda (por ejemplo, Europe/Madrid para España). El locale define el idioma y formato regional (por ejemplo, es-ES). Ambos afectan a la visualización de fechas, horas y formatos de moneda.

Parámetros avanzados: caché, depuración y rendimiento

Si tu tienda es lenta o quieres activar el modo de depuración para encontrar errores, estos parámetros son lo que necesitas.

Parámetro 'debug'

'debug' => true,

Cuando está en true, PrestaShop muestra mensajes de error detallados en pantalla. Es muy útil para resolver problemas, pero debe estar en false en producción para no mostrar información sensible a los visitantes.

Parámetro 'cache'

PrestaShop soporta varios sistemas de caché: CacheMemcached, CacheApc, CacheXcache o simplemente CacheFs (archivos). El más común es CacheFs, que no requiere configuración adicional. Si usas Memcached, deberás especificar los servidores:

'cache' => 'CacheMemcached',
'memcached_servers' => array(
    'server1' => array('host' => 'localhost', 'port' => 11211)
),

[WARNING] Activar un sistema de caché incorrecto o mal configurado puede hacer que tu tienda deje de funcionar. Si no estás seguro, deja el valor por defecto o consulta con tu proveedor de hosting.

Cómo editar parameters.php de forma segura

Ahora que ya sabes qué significa cada parámetro, es hora de ponerse manos a la obra. Pero antes, debes seguir estos pasos para evitar errores catastróficos:

Paso 1: Haz una copia de seguridad

Antes de tocar nada, copia el archivo original y guárdalo en un lugar seguro. Puedes descargarlo por FTP o hacer una copia con el nombre parameters.php.bak. Esto te permitirá restaurar la configuración si algo sale mal.

Paso 2: Usa un editor de texto apropiado

No uses el Bloc de notas de Windows para editar archivos PHP, ya que puede añadir caracteres invisibles que rompan el código. Utiliza un editor como Visual Studio Code, Sublime Text o Notepad++.

Paso 3: Edita solo lo necesario

No cambies valores que no entiendes. Si solo necesitas actualizar la contraseña de la base de datos, cambia únicamente esa línea y guarda el archivo.

Paso 4: Sube el archivo modificado

Conecta tu servidor por FTP y sube el archivo editado, reemplazando el original. Asegúrate de que los permisos del archivo sean los correctos (generalmente 644).

Paso 5: Comprueba tu tienda

Accede a tu tienda y verifica que todo funciona correctamente. Si ves un error, revisa el archivo de logs de PrestaShop (var/logs/) para identificar el problema.

Errores comunes y cómo solucionarlos

Incluso los usuarios más experimentados cometen errores. Aquí te dejamos los problemas más frecuentes con el archivo configuración PrestaShop y sus soluciones:

Error: "Cannot connect to database"

Este error suele aparecer por tres motivos: datos de conexión incorrectos, servidor de base de datos caído o permisos insuficientes. Verifica que el host, usuario y contraseña sean correctos y que el usuario tenga acceso a la base de datos.

Error: "Access denied for user"

Si ves este mensaje, el usuario de la base de datos no tiene permisos suficientes. Deberás acceder a tu panel de control de hosting (por ejemplo, Syspanel, al que se accede por el puerto 2106) y otorgar los permisos necesarios.

[INFO] En Syspanel (puerto 2106), puedes gestionar tus bases de datos fácilmente: crear usuarios, asignar privilegios y verificar conexiones. Es una herramienta muy útil para resolver este tipo de problemas.

Error: "Invalid secret key"

Este error ocurre cuando la clave secret no coincide con la que se usó para cifrar los datos. Si has restaurado una copia de seguridad de la base de datos, asegúrate de que el parameters.php corresponda a esa copia.

Error: "Too many redirects"

Suele deberse a una configuración incorrecta de la URL en parameters.php. Verifica que la URL incluya el protocolo correcto (https:// o http://) y que no haya espacios ni caracteres extraños.

Preguntas frecuentes sobre parameters.php

¿Puedo eliminar el archivo parameters.php?

No, nunca lo elimines. Sin él, PrestaShop no puede funcionar. Si lo pierdes, deberás reinstalar la tienda desde cero.

¿Cómo sé si necesito editar parameters.php?

Si tu tienda funciona correctamente, no necesitas tocarlo. Solo deberías editarlo cuando cambies de servidor, de dominio, de base de datos o si recibes errores relacionados con la conexión o la seguridad.

¿Es seguro compartir mi archivo parameters.php?

Rotundamente no. Este archivo contiene credenciales de acceso y claves de seguridad. Si alguien lo obtiene, podría acceder a tu base de datos y robar información sensible. Nunca lo compartas en foros, soporte técnico no oficial o por correo electrónico sin cifrar.

¿Puedo usar variables de entorno en lugar de valores fijos?

Sí, PrestaShop permite usar variables de entorno. Por ejemplo, puedes definir getenv('DATABASE_HOST') en lugar de 'localhost'. Esto es útil si usas Docker o entornos de desarrollo con diferentes configuraciones.

Consejos finales para una configuración exitosa

Configurar el parameters.php PrestaShop puede parecer intimidante al principio, pero con esta guía y un poco de práctica, verás que es un proceso sencillo. Recuerda siempre:

Hacer copias de seguridad antes de editar.
Cambiar solo los valores que necesitas.
Probar la tienda después de cada modificación.
Mantener las claves de seguridad en secreto.

Si tienes dudas sobre dónde está alojado tu servidor o cómo acceder a las bases de datos, contacta con tu proveedor de hosting. Si usas Syspanel, recuerda que puedes acceder a través del puerto 2106 para gestionar todos los aspectos de tu servidor, incluyendo bases de datos, correos y archivos.

[TIP] Si estás migrando tu tienda a un nuevo servidor, te recomendamos primero hacer una copia completa de los archivos y la base de datos, y luego probar la configuración en un entorno de desarrollo antes de ponerla en producción.

Ahora ya estás listo para dominar la configuración PrestaShop avanzada. ¡Manos a la obra y mucha suerte con tu tienda online!