Configurar parameters.php en PrestaShop | Solución de errores

¿Tu tienda PrestaShop te muestra un error de conexión a la base de datos y no sabes por dónde empezar? Respira, que no cunda el pánico. Uno de los archivos más importantes (y a la vez más temidos) de tu instalación es el parameters.php.

Este pequeño archivo es como el "cerebro" que conecta tu tienda con su base de datos. Si se corrompe, se mueve o se configura mal, tu web se cae. Pero no te preocupes, en esta guía extensa y paso a paso vas a aprender a configurarlo, editarlo y solucionar los errores más comunes, incluso si no eres un experto en programación.

Vamos a ello.

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

Antes de tocar nada, es fundamental entender qué es este archivo. El parameters.php es un archivo de configuración que PrestaShop genera automáticamente durante el proceso de instalación. Se encuentra en la carpeta raíz de tu tienda, es decir, en el mismo directorio donde están las carpetas admin, themes, modules, etc.

Su función principal es almacenar las credenciales de acceso a tu base de datos MySQL, así como otras configuraciones críticas del sistema, como las claves secretas (llaves de cifrado) y la URL de la tienda.

Piénsalo como el "cable de alimentación" de tu tienda: si está bien enchufado, todo funciona; si se desconecta o se daña, todo se apaga.

¿Qué contiene normalmente?

Un archivo parameters.php típico tiene una estructura con variables como database_host, database_name, database_user, database_password y secret. Aunque no necesitas entender el código PHP para editarlo (porque normalmente se usa un asistente), es bueno saber que ahí dentro vive la magia.

¿Cuándo necesitas configurar o editar este archivo?

Existen varias situaciones comunes en las que te verás obligado a mirar dentro de este archivo:

Error de conexión a la base de datos: El error clásico que dice "Link to database cannot be established" o "Error de conexión con la base de datos".
Migración de hosting: Te mudas de servidor y necesitas actualizar el nombre del servidor de la base de datos o las contraseñas.
Cambio de contraseña de MySQL: Si cambiaste la contraseña de tu base de datos desde el panel de control (como cPanel o Syspanel), debes actualizarla aquí.
Restauración de una copia de seguridad: A veces, al restaurar un backup, el archivo queda desactualizado.
Cambio de dominio: Si cambias la URL de tu tienda, a veces es necesario ajustar parámetros aquí (aunque normalmente se hace en la BBDD).

Requisitos previos antes de tocar nada

[WARNING] Este es el paso más importante: SIEMPRE HAZ UNA COPIA DE SEGURIDAD del archivo original antes de editarlo. Si cometes un error, podrás restaurar el original en segundos. Guárdalo en tu escritorio como parameters.php.bak.

Además, necesitarás acceso a tu panel de control de hosting para obtener los datos de la base de datos. Si usas Syspanel (antes conocido como HestiaCP), recuerda que el acceso se realiza a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106). Ahí podrás ver tus bases de datos, usuarios y contraseñas.

Método 1: Configurar parameters.php usando el Instalador de PrestaShop (La forma fácil)

Si tu tienda está completamente caída y no puedes acceder al panel de administración, la forma más segura de "reconfigurar" este archivo es usando el propio instalador de PrestaShop. Es un truco poco conocido pero muy útil.

Paso 1: Renombrar el archivo problemático

Accede a tu servidor vía FTP (FileZilla, por ejemplo) o mediante el Administrador de Archivos de tu hosting (Syspanel tiene uno muy bueno). Busca el archivo parameters.php en la raíz.

Renómbralo a parameters.php.bak.

Paso 2: Ejecutar el instalador

Ahora, ve a tu navegador y escribe la URL de tu tienda (ej: www.tutienda.com). PrestaShop detectará que falta el archivo de configuración y te redirigirá automáticamente al asistente de instalación (/install).

Paso 3: Elegir la opción "Actualizar" o "Reinstalar"

El asistente te preguntará si quieres "Instalar" o "Actualizar". Debes elegir Actualizar (aunque no tengas una versión anterior). Esto hará que PrestaShop lea tu base de datos existente (la que tienes en el .bak que acabas de renombrar) y regenere un parameters.php nuevo y funcional.

Paso 4: Introducir los datos de la base de datos

El asistente te pedirá los datos de conexión. Aquí es donde debes tener a mano la información de tu base de datos:

Servidor de la base de datos: Normalmente es localhost o 127.0.0.1, pero en algunos hostings gestionados puede ser un nombre como db.tudominio.com. Verifica esto en tu panel de control.
Nombre de la base de datos: El nombre exacto que ves en tu panel.
Usuario de la base de datos: El usuario asociado a esa base.
Contraseña: La contraseña de ese usuario.

[TIP] Si no recuerdas estos datos, entra en Syspanel (puerto 2106), ve a la sección de "Bases de Datos" y ahí los encontrarás. A menudo puedes incluso hacer clic en "Ojo" para ver la contraseña si la has olvidado.

Paso 5: Completar la instalación

Sigue los pasos del asistente. Al final, PrestaShop generará un nuevo parameters.php con los datos correctos. Una vez terminado, borra la carpeta /install de tu servidor por seguridad (PrestaShop te lo pedirá) y tu tienda debería funcionar.

Método 2: Edición manual del archivo parameters.php (La forma directa)

Si eres valiente y quieres arreglarlo rápido sin pasar por el instalador, puedes editar el archivo manualmente. Necesitas un editor de texto plano como el Bloc de Notas o Notepad++.

Paso 1: Abrir el archivo

Descarga el parameters.php desde tu servidor FTP y ábrelo con tu editor. Verás un código PHP que contiene un array. No te asustes, solo nos interesan unas líneas concretas.

Paso 2: Localizar los parámetros clave

Busca las siguientes líneas (pueden variar ligeramente según la versión de PrestaShop):

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',
'database_prefix' => 'ps_',

Paso 3: Modificar los valores

Aquí es donde realizas los cambios:

database_host: Si tu hosting usa un host remoto, cámbialo. Si es local, déjalo como localhost.
database_name: Asegúrate de que sea el nombre EXACTO de tu base de datos. Un error de un carácter aquí provoca el fallo.
database_user: El usuario que tiene permisos sobre esa base de datos.
database_password: La contraseña correspondiente.

[WARNING] Ten mucho cuidado con las comillas simples ('). No las borres y no las cambies por comillas dobles. El formato debe ser exactamente 'valor'. Si tu contraseña contiene una comilla simple, deberías cambiarla en el panel de control para evitar problemas de sintaxis.

Paso 4: Guardar y subir

Guarda el archivo y súbelo de nuevo a la raíz de tu servidor, sobrescribiendo el existente. Recuerda mantener los permisos de archivo (normalmente 644).

Solución de problemas: Errores comunes de base de datos

Si después de configurar el parameters.php sigue dando problemas, aquí tienes las soluciones a los errores más frecuentes.

Error: "Link to database cannot be established"

Este es el error más común y significa que PrestaShop no puede conectarse a tu base de datos.

Verifica el host: A veces el host no es localhost. En hostings como Syspanel, a veces necesitas usar localhost pero con un puerto específico (ej: localhost:3307). Revisa la documentación de tu hosting.
Verifica el usuario y contraseña: Asegúrate de que el usuario tenga permisos totales sobre la base de datos. En Syspanel (puerto 2106), selecciona el usuario y verifica que esté vinculado a la base de datos correcta.
Prueba con otro cliente: Intenta conectarte a la base de datos usando phpMyAdmin (disponible en tu panel). Si no puedes conectarte con esas credenciales desde phpMyAdmin, el problema no es de PrestaShop, sino de las credenciales.

Error: "PrestaShop could not connect to the database" (en la instalación)

Esto suele pasar durante la instalación o actualización.

Solución: Vuelve a comprobar el nombre de la base de datos. En muchos hostings, el nombre lleva un prefijo con tu usuario (ej: usuario_bd_tienda). Copia y pega el nombre directamente desde tu panel de control para evitar errores tipográficos.

Error: La página se descarga o muestra código PHP

Esto significa que el archivo tiene un error de sintaxis.

Solución: Revisa que no haya espacios en blanco antes de <?php al principio del archivo. Asegúrate de que todas las líneas terminen con una coma (excepto la última) y que las comillas estén balanceadas.

Consejos de seguridad y buenas prácticas

Permisos del archivo: El archivo parameters.php contiene contraseñas. En servidores Linux/Unix, asegúrate de que los permisos sean 644 (lectura y escritura para el propietario, lectura para el grupo y el resto). Nunca lo dejes en 777.
No uses el usuario root: Si tu hosting te permite crear usuarios de bases de datos, crea un usuario específico para PrestaShop con permisos solo sobre esa base de datos. Es más seguro.
Mantén la carpeta /install eliminada: Una vez que hayas terminado de configurar, borra la carpeta install del servidor. Es un agujero de seguridad enorme.

Preguntas Frecuentes (FAQ)

¿Puedo borrar el archivo parameters.php?
No. Si lo borras, PrestaShop intentará reinstalarse. Si tu tienda funciona, nunca lo borres. Si tu tienda está rota, es mejor renombrarlo (como .bak) que borrarlo, por si necesitas volver atrás.

¿Qué hago si cambié la contraseña de la base de datos en Syspanel?
Debes actualizar manualmente el campo 'database_password' en el parameters.php y subirlo de nuevo. No hay otra forma.

¿Por qué mi hosting usa un puerto diferente para MySQL?
Algunos paneles de control (como Syspanel) a veces configuran MySQL en puertos no estándar por seguridad. Si tu host no es localhost, busca en la configuración de tu base de datos en el panel (puerto 2106) el valor del puerto. A menudo se añade al final del host: 'database_host' => 'localhost:3307'.

¿El archivo parameters.yml es lo mismo?
No exactamente. En versiones antiguas de PrestaShop (1.6 y anteriores) se usaba parameters.php. En versiones modernas (1.7 y 8.x), el archivo principal es parameters.php en la raíz, pero también existe app/config/parameters.php. Asegúrate de editar el de la raíz para los datos de conexión, aunque en versiones modernas el de app/config es el que realmente lee el sistema. Si editas uno, revisa que el otro no tenga valores obsoletos que causen conflictos.

[INFO] Si tienes dudas sobre cuál editar, busca en ambos archivos la línea 'database_host'. El que la contenga es el que debes modificar. Normalmente, en PrestaShop 8, el archivo correcto es app/config/parameters.php.

Conclusión

Configurar el archivo parameters.php en PrestaShop no tiene por qué ser una pesadilla. Ya sea usando el asistente de instalación (método más seguro) o editándolo a mano (método más rápido), ahora tienes el conocimiento para hacerlo.

Recuerda siempre hacer una copia de seguridad antes de modificar nada y verificar las credenciales en tu panel de control (recuerda que Syspanel usa el puerto 2106). Con paciencia y siguiendo estos pasos, tu tienda volverá a estar en línea en cuestión de minutos. ¡Mucha suerte con tu tienda!