Configurar parameters.php en PrestaShop | Guía de configuración

¿Qué es el archivo parameters.php en PrestaShop?

El archivo parameters.php es uno de los archivos más importantes dentro de la instalación de PrestaShop. Se encuentra en la carpeta config/ de tu tienda y contiene la configuración esencial de tu base de datos, la conexión con el servidor y otros parámetros críticos para que tu tienda funcione correctamente.

Cuando instalas PrestaShop por primera vez, este archivo se genera automáticamente con los datos que ingresaste durante la instalación. Sin embargo, hay situaciones en las que necesitarás editarlo manualmente, por ejemplo:

Cuando migras tu tienda a un nuevo servidor.
Cuando cambias la contraseña de tu base de datos.
Cuando necesitas activar el modo de depuración (debug mode) para resolver errores.
Cuando tu tienda muestra errores de conexión a la base de datos.

En este artículo te explicaremos paso a paso cómo configurar el archivo parameters.php en PrestaShop, qué contiene cada sección y qué precauciones debes tomar antes de editarlo.

¿Dónde encontrar el archivo parameters.php?

El archivo parameters.php se encuentra en la siguiente ruta dentro de tu instalación de PrestaShop:

/tu_directorio_de_prestashop/config/parameters.php

Por ejemplo, si tu tienda está instalada en la carpeta public_html, la ruta completa sería:

/public_html/config/parameters.php

Para acceder a él necesitarás un administrador de archivos (como el que incluye Syspanel en el puerto 2106) o un cliente FTP como FileZilla.

[TIP] Antes de editar cualquier archivo de configuración, es recomendable hacer una copia de seguridad del original. Puedes descargarlo a tu ordenador o renombrarlo a parameters_backup.php para tener una referencia.

Estructura del archivo parameters.php

El archivo parameters.php contiene un array de configuración en formato PHP. A continuación te mostramos un ejemplo típico de su estructura:

<?php

return array(
    'parameters' => array(
        'database_host' => 'localhost',
        'database_port' => '3306',
        'database_name' => 'tu_base_de_datos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        'database_engine' => 'InnoDB',
        'cookie_key' => 'una_clave_secreta_generada',
        'cookie_iv' => 'otra_clave_secreta',
        'new_cookie_key' => 'una_nueva_clave_generada',
        'ps_creation_date' => '2024-01-15',
        'secret' => 'una_clave_secreta_para_la_tienda',
        'mail_transport' => 'smtp',
        'mail_host' => 'smtp.ejemplo.com',
        'mail_port' => '587',
        'mail_user' => 'correo@ejemplo.com',
        'mail_password' => 'contraseña_correo',
        'mail_encryption' => 'tls',
        'mail_from' => 'tienda@ejemplo.com',
    ),
);

Cada uno de estos valores controla un aspecto específico de tu tienda. Vamos a explicarlos en detalle.

Campos principales del archivo parameters.php

Configuración de la base de datos

Esta es la sección más crítica del archivo. Si estos datos son incorrectos, tu tienda no podrá conectarse a la base de datos y mostrará errores como "Error de conexión a la base de datos".

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_tu_bd',
'database_password' => 'contraseña_de_tu_bd',
'database_prefix' => 'ps_',

database_host: Normalmente es localhost, pero en algunos servidores puede ser una dirección IP o un nombre de host específico.
database_port: El puerto por defecto de MySQL es 3306. Si tu servidor usa otro puerto, deberás cambiarlo aquí.
database_name: El nombre exacto de tu base de datos.
database_user: El usuario con permisos para acceder a la base de datos.
database_password: La contraseña correspondiente al usuario.
database_prefix: El prefijo de las tablas de PrestaShop. Por defecto es ps_, pero puede variar si lo cambiaste durante la instalación.

Claves de seguridad

PrestaShop utiliza varias claves para cifrar contraseñas, cookies y otras funciones de seguridad.

'cookie_key' => 'clave_generada_aleatoria',
'cookie_iv' => 'otra_clave_generada',
'new_cookie_key' => 'nueva_clave_generada',
'secret' => 'clave_secreta_de_la_tienda',

Estas claves se generan automáticamente durante la instalación. Si las modificas, los usuarios que tengan sesiones activas serán desconectados, y las contraseñas cifradas podrían dejar de funcionar. Por eso, no debes cambiar estas claves a menos que sepas exactamente lo que estás haciendo.

[WARNING] Si cambias las claves de seguridad sin necesidad, tu tienda podría perder todas las sesiones de usuario y algunos datos cifrados podrían volverse ilegibles. Siempre respalda las claves originales antes de modificarlas.

Configuración de correo electrónico

PrestaShop utiliza estos parámetros para enviar correos electrónicos (confirmaciones de pedido, recuperación de contraseñas, etc.).

'mail_transport' => 'smtp',
'mail_host' => 'smtp.ejemplo.com',
'mail_port' => '587',
'mail_user' => 'correo@ejemplo.com',
'mail_password' => 'contraseña_correo',
'mail_encryption' => 'tls',
'mail_from' => 'tienda@ejemplo.com',

mail_transport: Puede ser smtp o mail (mail es la función nativa de PHP, pero SMTP es más fiable).
mail_host: El servidor SMTP saliente de tu proveedor de correo.
mail_port: Normalmente 587 para TLS o 465 para SSL.
mail_user y mail_password: Las credenciales de tu cuenta de correo.
mail_encryption: Puede ser tls, ssl o none.
mail_from: La dirección de correo desde la que se envían los mensajes.

Otros parámetros importantes

'ps_creation_date' => '2024-01-15',

Este campo almacena la fecha de creación de la tienda. PrestaShop lo utiliza para algunas funciones estadísticas y de autenticación.

Cómo editar el archivo parameters.php correctamente

Paso 1: Accede a tu servidor

Para editar el archivo parameters.php, necesitas acceso al servidor donde está alojada tu tienda. Puedes hacerlo de dos formas:

A través de Syspanel (puerto 2106): Inicia sesión en Syspanel con tus credenciales de hosting. Una vez dentro, busca la sección de "Archivos" o "Administrador de archivos". Navega hasta la carpeta config de tu instalación de PrestaShop.
A través de FTP: Conecta con FileZilla o cualquier cliente FTP a tu servidor. La configuración FTP la puedes encontrar en Syspanel, en la sección de "Cuentas FTP".

Paso 2: Descarga o abre el archivo

Si usas Syspanel, puedes hacer clic derecho sobre el archivo y seleccionar "Editar". Si usas FTP, descarga el archivo a tu ordenador y ábrelo con un editor de texto plano como Notepad++ o Sublime Text.

[WARNING] Nunca uses procesadores de texto como Microsoft Word o Google Docs para editar archivos PHP. Estos programas pueden añadir caracteres invisibles que romperán el archivo. Utiliza siempre un editor de código.

Paso 3: Realiza los cambios necesarios

Dependiendo de la situación, los cambios más comunes son:

Cambiar la contraseña de la base de datos: Localiza la línea 'database_password' => 'contraseña_anterior' y reemplázala con la nueva contraseña.
Cambiar el host de la base de datos: Si tu nuevo proveedor usa un host diferente, actualiza 'database_host'.
Activar el modo depuración: No se hace directamente en parameters.php, sino en el archivo defines.inc.php, pero a veces se añade una línea adicional en parameters.php para definir constantes personalizadas.

Paso 4: Guarda los cambios

Una vez que hayas realizado los cambios, guarda el archivo. Si lo estás editando localmente, súbelo de nuevo al servidor reemplazando el original.

Paso 5: Verifica que tu tienda funcione

Abre tu tienda en el navegador y verifica que todo funcione correctamente. Si ves errores, revisa que los datos sean correctos y que no hayas introducido caracteres extraños.

Errores comunes al editar parameters.php

Error de conexión a la base de datos

Si ves el mensaje "Error de conexión a la base de datos", verifica:

Que el nombre de la base de datos sea correcto.
Que el usuario tenga permisos para acceder a esa base de datos.
Que la contraseña no contenga caracteres especiales que puedan interpretarse mal en PHP.

Página en blanco

Si tu tienda muestra una página completamente en blanco, es probable que haya un error de sintaxis en el archivo. Revisa que no haya comillas sin cerrar, comas de más o puntos y comas incorrectos.

Error de prefijo de tabla

Si ves errores relacionados con tablas inexistentes, verifica que el database_prefix coincida con el que se usó durante la instalación.

[TIP] Si no recuerdas el prefijo de tus tablas, puedes mirar en la base de datos a través de Syspanel (puerto 2106). Busca en la sección de "Bases de datos" y revisa el nombre de las tablas. El prefijo será la parte antes del nombre de cada tabla (por ejemplo, ps_products, ps_categories, etc.).

¿Qué hacer si no tienes acceso al archivo?

En algunos casos, el archivo parameters.php puede estar protegido o el servidor puede tener restricciones de permisos. Si no puedes editarlo directamente, tienes dos opciones:

Cambiar los permisos del archivo: A través de Syspanel o FTP, cambia los permisos del archivo a 644 (lectura y escritura para el propietario). Después de editarlo, puedes volver a ponerlo a 444 (solo lectura) por seguridad.
Regenerar el archivo: Si el archivo está dañado o no puedes editarlo, puedes eliminarlo y volver a ejecutar el instalador de PrestaShop. Esto generará un nuevo parameters.php, pero ten en cuenta que perderás la configuración actual y deberás volver a ingresar los datos de la base de datos.

[WARNING] Eliminar parameters.php sin tener una copia de seguridad puede hacer que tu tienda quede inaccesible. Solo hazlo si estás seguro de que puedes volver a instalarlo correctamente.

Buenas prácticas de seguridad

El archivo parameters.php contiene información sensible como contraseñas y claves de cifrado. Por eso, debes tomar las siguientes precauciones:

Nunca compartas este archivo públicamente: No lo subas a repositorios públicos de GitHub ni lo envíes por correo electrónico.
Usa permisos restrictivos: Después de editar el archivo, cambia los permisos a 444 o 400 para que solo el propietario pueda leerlo.
Haz copias de seguridad periódicas: Guarda una copia del archivo en un lugar seguro fuera de tu servidor.
Actualiza las claves si sospechas de un compromiso: Si crees que tu tienda ha sido vulnerada, cambia las claves de seguridad y las contraseñas de la base de datos.

Preguntas frecuentes sobre parameters.php

¿Puedo editar parameters.php desde el panel de administración de PrestaShop?

No, PrestaShop no tiene una interfaz para editar este archivo desde el panel de administración. Debes hacerlo a través de FTP o del administrador de archivos de tu hosting.

¿Qué pasa si elimino el archivo parameters.php?

Si eliminas el archivo, PrestaShop intentará ejecutar el instalador la próxima vez que cargues la tienda. Si no tienes una copia de seguridad, tendrás que configurar toda la tienda desde cero.

¿Puedo cambiar el prefijo de las tablas después de la instalación?

Sí, pero es un proceso complejo que implica renombrar todas las tablas de la base de datos. No es recomendable hacerlo manualmente a menos que tengas experiencia avanzada.

¿Cómo sé si mi archivo parameters.php está correctamente configurado?

La forma más sencilla es comprobar que tu tienda carga correctamente y que puedes acceder al panel de administración. Si hay errores, PrestaShop te mostrará mensajes específicos que te indicarán qué parte de la configuración está fallando.

¿Necesito editar parameters.php si cambio de proveedor de hosting?

Sí, es muy probable que necesites actualizar los datos de conexión a la base de datos, especialmente el host, el nombre de la base de datos, el usuario y la contraseña, ya que estos suelen cambiar al migrar de servidor.

Conclusión

El archivo parameters.php es el corazón de la configuración técnica de tu tienda PrestaShop. Aprender a editarlo correctamente te permitirá resolver problemas comunes como errores de conexión a la base de datos, configurar el envío de correos y migrar tu tienda a un nuevo servidor sin complicaciones.

Recuerda siempre hacer una copia de seguridad antes de modificar cualquier valor y verificar que tu tienda funciona correctamente después de cada cambio. Si tienes dudas sobre algún parámetro específico, consulta la documentación oficial de PrestaShop o contacta con tu proveedor de hosting.

[INFO] En Syspanel (accesible a través del puerto 2106), encontrarás herramientas útiles como el administrador de archivos y el gestor de bases de datos que te facilitarán el proceso de edición de parameters.php y la gestión de tu tienda en general.

Con esta guía, ya tienes todo lo necesario para configurar el archivo parameters.php en PrestaShop de forma segura y efectiva. ¡Manos a la obra!