Configuración de parameters.php en PrestaShop con Plesk | Guía rápida

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

Si alguna vez has intentado mover tu tienda PrestaShop a un nuevo servidor, cambiar la contraseña de la base de datos o simplemente has visto un error de conexión, seguro que has oído hablar del archivo parameters.php. Este archivo es, ni más ni menos, el corazón de la configuración técnica de tu tienda. Sin él, PrestaShop no sabe a qué base de datos conectarse, qué idioma usar o cómo gestionar las sesiones de tus clientes.

Piensa en parameters.php como el cerebro de la comunicación entre tu tienda y el servidor. Contiene datos sensibles como el nombre de la base de datos, el usuario, la contraseña y el prefijo de las tablas. Si este archivo se corrompe, se borra o tiene errores de sintaxis, tu tienda mostrará un error fatal y dejará de funcionar por completo.

En este artículo, vamos a explicarte paso a paso cómo configurar el archivo parameters.php de PrestaShop en Plesk, uno de los paneles de control más utilizados en el hosting. No importa si eres un principiante total o si ya has tocado archivos de configuración antes: aquí lo encontrarás explicado de forma clara, sencilla y con ejemplos prácticos para que no te pierdas.

¿Qué es Plesk y por qué lo usamos?

Plesk es un panel de control de hosting que te permite gestionar tu servidor, dominios, bases de datos, correos electrónicos y archivos desde una interfaz visual e intuitiva. Es muy común en planes de hosting compartido y VPS, y una de sus grandes ventajas es que no necesitas conocimientos avanzados de Linux para realizar tareas complejas, como editar archivos de configuración.

Cuando hablamos de configurar PrestaShop en Plesk, nos referimos a que vamos a usar las herramientas que Plesk nos ofrece para acceder al sistema de archivos de nuestra web, modificar el parameters.php y asegurarnos de que todos los datos de conexión son correctos. Dicho esto, vamos a lo importante: el paso a paso.

Localizar el archivo parameters.php en Plesk

Antes de editar nada, tienes que encontrar el archivo. En Plesk, el acceso a los archivos de tu web se hace a través del Administrador de archivos, una herramienta integrada que te permite navegar por el directorio de tu dominio como si fuera un explorador de Windows o Finder.

Sigue estos pasos para localizarlo:

Inicia sesión en Plesk con tu usuario y contraseña (normalmente accedes a través de https://tu-dominio.com:8443 o la URL que te haya dado tu proveedor).
En el panel izquierdo, busca la sección Sitios web y dominios.
Haz clic en el dominio de tu tienda PrestaShop.
Busca el botón Administrador de archivos (suele tener un icono de carpeta).
Dentro, navega hasta la carpeta raíz de tu PrestaShop. Normalmente es algo como /httpdocs o /public_html, pero depende de cómo esté configurado tu hosting.
Una vez dentro, busca el archivo app/config/parameters.php. Ojo, no lo confundas con parameters.yml que a veces también existe en versiones antiguas. El que nos interesa es el que está dentro de app/config.

[INFO] Si no ves el archivo, activa la opción "Mostrar archivos ocultos" en el Administrador de archivos. A veces Plesk los oculta por seguridad.

Estructura básica del archivo parameters.php

Cuando abras el archivo con el editor de Plesk (haciendo clic derecho sobre él y eligiendo "Editar en el editor de texto"), verás una estructura similar a esta:

<?php

return array(
    'parameters' => array(
        'database_host' => 'localhost',
        'database_port' => '3306',
        'database_name' => 'tu_basededatos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        'database_engine' => 'InnoDB',
        'cookie_key' => 'una_cadena_larga_de_caracteres',
        'cookie_iv' => 'otra_cadena',
        'new_cookie_key' => 'otra_cadena_mas',
        'secret' => 'clave_secreta',
    ),
);

Cada línea tiene una función específica:

database_host: la dirección del servidor de base de datos. Casi siempre es localhost, pero en algunos hostings puede ser una IP o un nombre como mysql.tudominio.com.
database_port: el puerto de conexión. Lo normal es 3306 para MySQL/MariaDB.
database_name: el nombre exacto de tu base de datos. Este dato lo encuentras en Plesk, en la sección Bases de datos.
database_user: el usuario de la base de datos. También lo ves en Plesk.
database_password: la contraseña de ese usuario.
database_prefix: el prefijo de las tablas. Por defecto suele ser ps_, pero si tu tienda usa otro, debes respetarlo.
cookie_key, cookie_iv, new_cookie_key, secret: son claves de seguridad que generó PrestaShop al instalarse. No las cambies salvo que sepas exactamente lo que haces, porque invalidará las sesiones de tus clientes.

[WARNING] Nunca compartas este archivo con nadie. Contiene credenciales de acceso a tu base de datos. Si alguien lo obtiene, podría robar información de tu tienda.

Cómo configurar parameters.php para conectar tu PrestaShop a la base de datos en Plesk

Ahora viene la parte práctica. Supongamos que acabas de crear una base de datos en Plesk y necesitas que tu PrestaShop se conecte a ella. Estos son los pasos exactos:

Paso 1: Crear la base de datos en Plesk (si no la tienes)

En Plesk, ve a Bases de datos (dentro de tu dominio).
Haz clic en Agregar base de datos.
Elige un nombre (por ejemplo, tienda_db), un tipo (MySQL o MariaDB) y un servidor.
Crea un usuario de base de datos con su contraseña. Anota estos datos, los necesitarás después.
Guarda los cambios.

Paso 2: Editar los datos en parameters.php

Abre el archivo app/config/parameters.php en el editor de texto de Plesk.
Sustituye los valores de las claves database_name, database_user y database_password por los que acabas de crear.
Si tu servidor de base de datos no es localhost, cambia también database_host.
Asegúrate de que el database_prefix coincide con el de tu instalación. Si es una instalación nueva, suele ser ps_.
Guarda el archivo.

Paso 3: Probar la conexión

Una vez guardado, intenta acceder a tu tienda. Si todo está bien, verás la página principal sin errores. Si aparece un error de conexión a la base de datos, revisa que los datos sean exactamente los mismos que has creado en Plesk. Un error típico es poner un espacio extra o una mayúscula de más en la contraseña.

[TIP] Si no estás seguro de los datos de conexión, en Plesk puedes hacer clic en "Ver información" en la sección de bases de datos y te mostrará el nombre, el usuario y el host. La contraseña no te la mostrará, pero puedes cambiarla y usar la nueva.

Problemas comunes al editar parameters.php y cómo solucionarlos

Editar este archivo puede dar lugar a errores si no se hace con cuidado. Estos son los problemas más habituales y sus soluciones:

El archivo se ve en blanco o con caracteres extraños

Esto suele pasar cuando el editor de Plesk guarda el archivo con una codificación incorrecta o cuando se copian y pegan caracteres invisibles. Solución: abre el archivo, selecciona todo, bórralo y vuelve a escribir el contenido manualmente o pégalo desde un editor de texto plano como Notepad++ o Visual Studio Code, asegurándote de que la codificación sea UTF-8 sin BOM.

Error "Fatal error: Uncaught exception" al cargar la tienda

Este error es típico cuando el archivo tiene errores de sintaxis, como una coma de más o una comilla sin cerrar. Solución: revisa que cada línea termine con coma (excepto la última) y que todas las comillas estén cerradas. Puedes usar un validador de PHP online para verificar la sintaxis.

La tienda carga pero no guarda productos ni pedidos

Esto indica que la conexión a la base de datos es correcta, pero el prefijo de las tablas no coincide. Solución: revisa el prefijo que usa tu PrestaShop. Puedes verlo en la base de datos desde Plesk (si tienes acceso a phpMyAdmin) o en el archivo parameters.php original de tu instalación.

Cómo hacer una copia de seguridad del parameters.php antes de editarlo

Antes de tocar nada, es obligatorio hacer una copia de seguridad. Si cometes un error, podrás restaurar el archivo original y tu tienda volverá a funcionar.

Para hacerlo en Plesk:

En el Administrador de archivos, localiza app/config/parameters.php.
Haz clic derecho sobre él y selecciona Copiar.
Pega una copia en la misma carpeta y renómbrala como parameters.php.bak.
Si algo sale mal, borra el archivo modificado y renombra el .bak a parameters.php.

[WARNING] Nunca edites el archivo directamente en producción sin una copia de seguridad. Un simple error de tipeo puede dejar tu tienda caída.

Cómo editar parameters.php usando FTP o SSH desde Plesk

Aunque el Administrador de archivos de Plesk es suficiente, a veces es más cómodo usar FTP o SSH. Plesk te permite gestionar cuentas FTP desde el panel.

Opción 1: FTP

Crea una cuenta FTP en Plesk (sección Acceso FTP).
Conecta con un cliente como FileZilla.
Navega hasta app/config/.
Descarga parameters.php, edítalo en tu ordenador y súbelo de nuevo.

Opción 2: SSH

Si tu plan lo permite, activa el acceso SSH en Plesk. Luego, desde la terminal, puedes usar comandos como nano o vim para editar el archivo. Esta opción es más avanzada y no la recomendamos para principiantes.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. En ese panel, la ruta del archivo es la misma, pero el acceso a archivos se hace desde el gestor de archivos integrado o por FTP.

Preguntas frecuentes (FAQ) sobre parameters.php en PrestaShop y Plesk

¿Puedo cambiar la contraseña de la base de datos sin tocar parameters.php?

No. Si cambias la contraseña de la base de datos en Plesk, tienes que actualizarla también en parameters.php, o tu tienda no podrá conectarse. Es un proceso manual y obligatorio.

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

Si borras el archivo, PrestaShop no funcionará. Mostrará un error de instalación o de conexión. La única solución es restaurarlo desde una copia de seguridad o reinstalar PrestaShop (lo cual no es recomendable).

¿Es normal que el archivo tenga permisos 644 o 444?

Sí. Lo normal es que tenga permisos de solo lectura (644 o 444) para evitar modificaciones accidentales. Si necesitas editarlo, cambia los permisos a 644, edítalo y luego vuelve a poner 444 si quieres mayor seguridad.

¿Puedo usar el mismo parameters.php en dos dominios?

No. Cada instalación de PrestaShop necesita su propio archivo con sus propias claves de seguridad y datos de base de datos. Usar el mismo archivo en dos tiendas provocará conflictos graves.

¿Cómo sé si mi archivo es correcto?

La mejor forma es acceder a tu tienda y comprobar que no hay errores. También puedes revisar los logs de error de Plesk (sección Logs) para ver si hay mensajes relacionados con la base de datos.

Conclusión: configurar parameters.php en Plesk es fácil si sigues los pasos

Configurar el archivo parameters.php de PrestaShop en Plesk no tiene por qué ser una pesadilla. Con un poco de paciencia y siguiendo los pasos que te hemos dado, podrás conectar tu tienda a la base de datos correcta, cambiar credenciales o trasladar tu web a otro servidor sin perder la calma.

Recuerda siempre:

Haz una copia de seguridad antes de editar.
Usa el Administrador de archivos de Plesk para editar cómodamente.
Respeta la sintaxis PHP y las comas.
No compartas el archivo con nadie.
Si algo falla, revisa los logs y verifica los datos de conexión.

Y si en algún momento te sientes perdido, no dudes en contactar con el soporte de tu hosting. Un buen proveedor siempre te echará una mano. Ahora ya sabes cómo configurar parameters.php PrestaShop Plesk con confianza y sin errores. ¡Tu tienda online te lo agradecerá!