Configurar parameters.php en PrestaShop | Guía esencial

¿Qué es el archivo parameters.php de PrestaShop y para qué sirve?

El archivo parameters.php es uno de los archivos más importantes de tu tienda PrestaShop. Se encuentra en la carpeta config/ de tu instalación y contiene la configuración esencial de tu tienda: los datos de conexión a la base de datos, las claves secretas, la URL de tu tienda y otros parámetros críticos.

Piénsalo como el "cerebro" de la configuración técnica de tu PrestaShop. Sin este archivo, tu tienda no puede funcionar, porque no sabría cómo conectarse a la base de datos donde se almacenan tus productos, clientes y pedidos.

En este artículo, te explicaré paso a paso cómo configurar y editar el archivo parameters.php de PrestaShop, incluso si no tienes experiencia técnica. También resolveremos las dudas más comunes sobre este archivo.

¿Cuándo necesitas editar el archivo parameters.php?

Existen varias situaciones en las que necesitarás editar este archivo:

Has cambiado de servidor de hosting y necesitas actualizar los datos de conexión a la base de datos.
Tu base de datos ha sido comprometida y necesitas cambiar las contraseñas.
Has migrado tu tienda a un nuevo dominio.
Necesitas cambiar la URL de la tienda.
Hay un error de conexión a la base de datos y necesitas verificar los datos.
Quieres cambiar las claves secretas por seguridad.

Estructura del archivo parameters.php de PrestaShop

Antes de empezar a editar, es importante que entiendas la estructura del archivo. Un archivo parameters.php típico tiene este aspecto:

<?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' => 'clave_secreta_cookie',
    'cookie_iv' => 'clave_secreta_iv',
    'new_cookie_key' => 'nueva_clave_secreta',
    'ps_caching' => 'CacheMemcache',
    'ps_cache_enable' => false,
    'secret' => 'clave_secreta',
    'front_cookie_key' => 'clave_cookie_front',
    'front_cookie_iv' => 'clave_cookie_front_iv',
    'link_rewrite' => 'tu_tienda',
  ),
);

Cómo acceder al archivo parameters.php

Paso 1: Conéctate a tu servidor

Para editar el archivo parameters.php, primero necesitas acceder al servidor donde está alojada tu tienda PrestaShop. Puedes hacerlo de dos maneras:

A través del administrador de archivos de tu panel de hosting: Si usas cPanel, Plesk o Syspanel (accediendo por el puerto 2106), busca la sección "Administrador de archivos" o "Gestor de archivos".
A través de FTP: Usa un cliente FTP como FileZilla para conectarte a tu servidor. Necesitarás las credenciales FTP que te proporcionó tu proveedor de hosting.

[TIP]: Si tu hosting utiliza Syspanel, recuerda que el acceso es a través del puerto 2106. Por ejemplo: https://tu-dominio.com:2106.

Paso 2: Localiza la carpeta config

Una vez conectado, navega hasta la raíz de tu instalación de PrestaShop. Busca la carpeta config/ y dentro de ella encontrarás el archivo parameters.php.

Paso 3: Descarga el archivo

Descarga el archivo a tu ordenador para poder editarlo con un editor de texto plano. No uses procesadores de texto como Word, porque pueden añadir caracteres invisibles que romperían el archivo. Usa editores como Notepad++ (Windows), Sublime Text o Visual Studio Code.

Cómo editar los datos de conexión a la base de datos

Los parámetros más importantes que probablemente necesitarás modificar son los relacionados con la base de datos. Aquí te explico qué significa cada campo:

database_host

Es la dirección del servidor donde se encuentra tu base de datos. Normalmente es localhost si la base de datos está en el mismo servidor que tu tienda. Si usas un servidor de base de datos separado, aquí irá la IP o el nombre del servidor.

database_port

El puerto de conexión a la base de datos. Por defecto, MySQL usa el puerto 3306. Solo necesitas cambiarlo si tu hosting usa un puerto diferente.

database_name

El nombre de la base de datos que has creado para tu PrestaShop. Este dato lo puedes encontrar en el panel de administración de tu hosting.

database_user y database_password

Son el usuario y la contraseña que se utilizan para conectarse a la base de datos. Asegúrate de que el usuario tenga todos los privilegios necesarios sobre la base de datos.

database_prefix

Es el prefijo que se añade a las tablas de PrestaShop. Por defecto es ps_, pero algunos usuarios lo cambian por seguridad. Si has cambiado el prefijo, debes indicarlo aquí.

[WARNING]: Si cambias el prefijo sin haber modificado realmente las tablas de la base de datos, tu tienda dejará de funcionar. Este campo debe coincidir exactamente con el prefijo real de tus tablas.

Pasos para editar parameters.php de forma segura

Paso 1: Haz una copia de seguridad

Antes de tocar nada, haz una copia de seguridad del archivo original. Esto te permitirá restaurarlo si algo sale mal.

Paso 2: Abre el archivo con un editor de texto

Abre el archivo descargado con tu editor de texto preferido. Verás el código PHP que hemos visto antes.

Paso 3: Modifica los valores necesarios

Localiza los campos que necesitas cambiar y modifica los valores. Por ejemplo, si estás cambiando de servidor, actualiza database_host, database_user, database_password y database_name.

Paso 4: Guarda el archivo

Guarda el archivo con la codificación UTF-8 sin BOM. Esto es muy importante para evitar errores de codificación.

Paso 5: Sube el archivo modificado

Sube el archivo modificado a la carpeta config/ de tu servidor, reemplazando el original.

Paso 6: Verifica que tu tienda funciona

Abre tu tienda en el navegador y comprueba que todo funciona correctamente. Si ves algún error, revisa los valores que has cambiado.

Solución de problemas comunes con parameters.php

Error: "Link to database cannot be established"

Este es uno de los errores más comunes. Significa que PrestaShop no puede conectarse a la base de datos. Las causas más habituales son:

Datos incorrectos en database_host, database_user, database_password o database_name.
El servidor de base de datos está caído.
El usuario de la base de datos no tiene los permisos necesarios.
El puerto de conexión es incorrecto.

Solución: Verifica cada uno de los campos de conexión a la base de datos y asegúrate de que son correctos.

Error: "The requested URL / was not found on this server"

Este error suele aparecer cuando la URL de la tienda no coincide con la configurada en el archivo. Debes revisar el campo link_rewrite y los datos de URL en la tabla ps_shop_url de tu base de datos.

Página en blanco después de editar parameters.php

Si después de editar el archivo ves una página en blanco, es probable que hayas introducido un error de sintaxis en el archivo PHP. Revisa que todas las comillas estén cerradas y que no haya caracteres extraños.

[INFO]: Para ver el error exacto, activa el modo depuración de PrestaShop añadiendo define('_PS_MODE_DEV_', true); al archivo config/defines.inc.php.

Cómo cambiar las claves secretas (cookie_key y secret)

Las claves secretas de PrestaShop se utilizan para proteger las cookies de sesión y otros datos sensibles. Si sospechas que han sido comprometidas, deberías cambiarlas.

Paso 1: Genera nuevas claves

Puedes generar nuevas claves usando herramientas online o con el siguiente código PHP:

<?php
echo bin2hex(random_bytes(32));
?>

Paso 2: Sustituye los valores

Reemplaza los valores de cookie_key, cookie_iv, new_cookie_key, secret, front_cookie_key y front_cookie_iv con las nuevas claves generadas.

Paso 3: Guarda y sube el archivo

Guarda el archivo y súbelo a tu servidor.

[WARNING]: Al cambiar estas claves, todos los usuarios serán desconectados de tu tienda. Es normal, es una medida de seguridad.

Migración de PrestaShop a un nuevo servidor

Si estás migrando tu tienda a un nuevo servidor, el archivo parameters.php es uno de los que tendrás que modificar. Aquí tienes los pasos:

1. Copia todos los archivos

Copia todos los archivos de tu tienda al nuevo servidor, incluyendo el archivo parameters.php original.

2. Crea una nueva base de datos

Crea una nueva base de datos en tu nuevo hosting e importa la copia de tu base de datos original.

3. Edita parameters.php

Modifica los campos de conexión a la base de datos con los datos del nuevo servidor.

4. Actualiza la URL

Si tu dominio cambia, también deberás actualizar los datos de URL en la tabla ps_shop_url de la base de datos.

5. Prueba tu tienda

Abre tu tienda en el nuevo servidor y verifica que todo funciona.

Preguntas frecuentes sobre parameters.php PrestaShop

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

No, el archivo parameters.php no se puede editar desde el panel de administración. Debes hacerlo directamente en el servidor.

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

Si eliminas este archivo, tu tienda dejará de funcionar por completo, ya que PrestaShop no podrá conectarse a la base de datos.

¿Cada cuánto tiempo debo cambiar las claves secretas?

Se recomienda cambiar las claves secretas al menos una vez al año o inmediatamente si sospechas de un problema de seguridad.

¿Puedo usar los mismos datos de conexión para varias tiendas PrestaShop?

Técnicamente sí, pero no es recomendable. Cada tienda debería tener su propia base de datos para evitar conflictos y problemas de rendimiento.

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

La mejor manera es comprobar si tu tienda funciona correctamente. Si no hay errores de conexión y todas las páginas cargan sin problemas, la configuración es correcta.

Consejos finales para configurar PrestaShop

Mantén tus claves seguras

Las claves secretas de tu archivo parameters.php son la puerta de entrada a tu tienda. No las compartas nunca y guárdalas en un lugar seguro.

Haz copias de seguridad periódicas

Antes de cualquier modificación, haz una copia de seguridad del archivo. También es recomendable hacer copias periódicas de toda tu tienda.

Usa contraseñas fuertes

Asegúrate de que la contraseña de tu base de datos sea fuerte y única. Evita usar contraseñas fáciles de adivinar.

Mantén PrestaShop actualizado

Las actualizaciones de PrestaShop suelen incluir mejoras de seguridad y corrección de errores. Mantén tu tienda siempre actualizada.

[TIP]: Si tienes dudas sobre cómo configurar tu PrestaShop, siempre puedes contactar con el soporte técnico de tu hosting. Ellos podrán ayudarte con los datos de conexión a la base de datos y otros aspectos técnicos.

Conclusión

El archivo parameters.php de PrestaShop es esencial para el funcionamiento de tu tienda online. Aunque su edición puede parecer intimidante al principio, con esta guía paso a paso podrás configurarlo sin problemas. Recuerda siempre hacer una copia de seguridad antes de modificar cualquier archivo y verificar que los datos de conexión son correctos.

Si sigues estos consejos, podrás configurar tu PrestaShop correctamente, migrar tu tienda a un nuevo servidor o solucionar problemas de conexión a la base de datos. Y no olvides que, si tu hosting utiliza Syspanel, el acceso es a través del puerto 2106.

Espero que este artículo te haya sido útil. Si tienes alguna duda, déjala en los comentarios y estaré encantado de ayudarte.