Error 'Archivo de configuración no encontrado' en PrestaShop: solución

¿Te ha aparecido el temido mensaje de "Archivo de configuración no encontrado" al intentar abrir tu tienda PrestaShop? No entres en pánico. Este es uno de los errores de configuración PrestaShop más comunes, pero también uno de los más fáciles de resolver si sabes exactamente dónde mirar.

En esta guía extensa y práctica, vamos a desglosar paso a paso qué significa este mensaje, por qué ocurre y, lo más importante, cómo solucionar el error PrestaShop de forma definitiva. Tanto si eres un usuario novel como si ya tienes experiencia, aquí encontrarás la solución, explicada de manera sencilla y sin tecnicismos innecesarios.

Vamos a ello.

¿Qué significa exactamente "Archivo de configuración no encontrado"?

Antes de lanzarnos a tocar archivos, es fundamental entender qué está pasando. PrestaShop, como cualquier aplicación seria, necesita un archivo de configuración para funcionar. Este archivo, llamado parameters.php, es el "cerebro" que contiene las credenciales de tu base de datos, la clave secreta y otras opciones vitales.

Cuando el sistema no encuentra este archivo, te muestra ese mensaje de error. Es como si intentaras arrancar un coche sin llave: el motor (PrestaShop) está ahí, pero le falta la pieza esencial para ponerse en marcha.

Este error instalación PrestaShop puede aparecer en dos escenarios concretos:

Durante la instalación inicial: Acabas de subir los archivos de PrestaShop a tu hosting y, al intentar instalar, te sale el error.
Después de un movimiento o actualización: Ya tenías tu tienda funcionando, pero al cambiar de servidor, mover la carpeta o actualizar la versión, el error ha aparecido de repente.

En ambos casos, la solución pasa por crear, restaurar o reparar ese archivo parameters.php. Vamos a ver cómo hacerlo en cada situación.

Causas más comunes de este error

Para solucionar el error PrestaShop de raíz, primero identifiquemos al culpable. Las causas más habituales son:

Permisos de archivo (CHMOD) incorrectos: El servidor no puede leer el archivo porque los permisos no son los adecuados.
El archivo no existe: Se borró por error, no se subió correctamente o la descarga inicial estaba incompleta.
Rutas incorrectas: El archivo está en la carpeta equivocada. PrestaShop lo busca en /config/, no en otro lugar.
Caché corrupta: A veces, el archivo existe, pero PrestaShop intenta leer una versión en caché que está dañada.
Problemas con el servidor (Syspanel): Si gestionas tu hosting desde un panel como Syspanel (recuerda, el puerto de acceso es el 2106), puede que haya un problema de sincronización o de permisos heredados.

Solución Paso a Paso: El método infalible

Vamos a dividir la solución en dos grandes bloques. El primero es para los que están instalando desde cero. El segundo, para los que ya tenían una tienda y han movido o actualizado.

Caso 1: El error aparece durante la instalación inicial

Si estás en el proceso de instalar PrestaShop y te encuentras con este error, el problema suele ser que el archivo parameters.php no se ha generado. Esto ocurre, generalmente, porque el script de instalación no tiene permisos para escribir en la carpeta /config.

Sigue estos pasos:

Accede a tu hosting: Entra en tu panel de control de hosting. Si usas Syspanel, recuerda que la URL de acceso es a través del puerto 2106 (por ejemplo, https://tu-servidor:2106), y busca el administrador de archivos (File Manager) o accede por FTP con un cliente como FileZilla.
Localiza la carpeta raíz: Navega hasta la carpeta donde has subido los archivos de PrestaShop. Normalmente es public_html, www o htdocs, dependiendo de tu proveedor.
Encuentra la carpeta /config: Dentro de la raíz, busca la carpeta llamada config.
Cambia los permisos (CHMOD): Esta es la clave. Debes dar permisos de escritura a la carpeta config para que el instalador pueda crear el archivo. Haz clic derecho sobre la carpeta config, selecciona "Permisos" o "CHMOD" y establece el valor en 755 o, si eso no funciona, 777 (temporalmente). Asegúrate de marcar la opción de "aplicar a subcarpetas y archivos" si te lo pide.
Vuelve a intentar la instalación: Ahora, ve a tu navegador e intenta acceder a tu dominio de nuevo. El instalador debería continuar sin problemas.
Restaura los permisos (IMPORTANTE): Una vez que la instalación haya terminado con éxito, vuelve a cambiar los permisos de la carpeta config a 755 por seguridad. Dejarlo en 777 es un riesgo de seguridad grave.

[TIP] Si el error persiste tras cambiar a 777, el problema no son los permisos. Puede que el servidor tenga activada la función disable_functions que bloquea la creación de archivos. En ese caso, contacta con tu proveedor de hosting.

Caso 2: El error aparece en una tienda ya existente (tras mover o actualizar)

Este es un poco más delicado, porque implica que tu tienda ya funcionaba. Lo más probable es que el archivo parameters.php se haya perdido, se haya corrompido o las rutas que contiene ya no sean válidas.

Aquí tienes el plan de rescate:

Verifica si el archivo existe: Ve a tu carpeta /config y busca el archivo parameters.php. Si no está, tienes dos opciones:
- Restaurar una copia de seguridad: Si tienes una copia de seguridad de tu tienda (¡deberías tenerla!), extrae el archivo parameters.php de esa copia y súbelo a la carpeta /config.
- Crear uno nuevo: Si no tienes copia, tendrás que generarlo. Esto es más complejo, pero no imposible.

Revisa el contenido del archivo (si existe): Si el archivo existe pero el error continúa, ábrelo con un editor de texto como el Bloc de Notas o Sublime Text. Deberías ver algo como esto:

<?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',
    'secret' => 'una_clave_secreta_larga',
  ),
);

Verifica que los datos de la base de datos (host, nombre, usuario y contraseña) sean correctos. Si has cambiado de servidor, es muy probable que estos datos hayan cambiado.

Actualiza las rutas: PrestaShop también guarda rutas absolutas en la base de datos. Si has movido la tienda a una carpeta diferente, tendrás que actualizarlas. Esto se hace a través de la base de datos (phpMyAdmin), pero eso es un proceso más avanzado.
Limpia la caché: A veces, el archivo existe y es correcto, pero PrestaShop usa una caché corrupta. Borra el contenido de la carpeta /var/cache (o /cache en versiones antiguas) y /var/logs. No borres las carpetas en sí, solo su contenido.

[WARNING] Antes de tocar cualquier archivo o base de datos, HAZ UNA COPIA DE SEGURIDAD COMPLETA. Tanto de los archivos como de la base de datos. Si algo sale mal, podrás restaurar tu tienda a su estado anterior.

Soluciones alternativas y trucos de experto

Si los pasos anteriores no han funcionado, aquí tienes algunas soluciones más avanzadas que suelen resolver el error configuración PrestaShop:

1. Comprobar el archivo `.htaccess`

El archivo .htaccess en la raíz de tu PrestaShop puede estar redirigiendo mal las URLs. Renómbralo a .htaccess.bak (para desactivarlo) y prueba a cargar tu tienda. Si funciona, el problema era ese archivo. Luego podrás regenerarlo desde el panel de administración (Parámetros Avanzados > Rendimiento > Generar archivo .htaccess).

2. Revisar los permisos de la carpeta raíz

No solo la carpeta /config necesita permisos. La carpeta raíz de tu instalación también debe tener los permisos adecuados (normalmente 755). Si está en 777 o en 600, puede causar conflictos.

3. El problema está en la base de datos

Si el archivo parameters.php es correcto, el problema puede ser que PrestaShop no puede conectarse a la base de datos. Verifica que el servidor de base de datos esté funcionando y que el usuario tenga todos los privilegios sobre la base de datos.

4. Activar el modo de depuración

PrestaShop tiene un modo de depuración que puede darte más pistas sobre el error. Para activarlo, abre el archivo config/defines.inc.php y busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Esto mostrará errores detallados en pantalla que te ayudarán a identificar el problema exacto.

[INFO] Recuerda desactivar el modo de depuración cuando hayas solucionado el problema, ya que muestra información sensible de tu servidor a los visitantes.

Preguntas Frecuentes (FAQ) sobre el error de configuración

Aquí tienes las dudas más habituales que nos llegan al soporte técnico sobre este tema.

¿Por qué aparece el error después de cambiar la contraseña de la base de datos?

Es muy común. Al cambiar la contraseña de la base de datos en tu panel de hosting (como Syspanel, puerto 2106), el archivo parameters.php de PrestaShop sigue teniendo la contraseña antigua. Debes actualizar ese campo en el archivo para que coincida con la nueva.

¿Puedo usar un plugin o módulo para arreglar este error?

No hay un módulo mágico que lo solucione, ya que el problema está en el núcleo del sistema. Sin embargo, una vez que accedas al panel de administración, puedes usar módulos de caché o de optimización para evitar futuros problemas.

¿Es seguro borrar el archivo `parameters.php`?

NUNCA borres el archivo parameters.php de una tienda que ya está funcionando. Al hacerlo, PrestaShop pierde la conexión con la base de datos y tu tienda quedará inaccesible. Solo debes borrarlo si estás 100% seguro de que quieres reinstalar la tienda desde cero, ya que perderás todos los datos.

¿El error puede deberse a un problema de memoria del servidor?

En ocasiones, un límite de memoria (memory_limit) demasiado bajo puede causar errores extraños, pero no es la causa más común de este error específico. Sin embargo, si nada funciona, puedes intentar aumentar el límite de memoria en el archivo php.ini a 256M o 512M.

Conclusión: Resolviendo el misterio

El error "Archivo de configuración no encontrado" en PrestaShop puede ser frustrante, pero como has visto, solucionar el error PrestaShop es un proceso lógico y metódico. La clave está en verificar la existencia y el contenido del archivo parameters.php, así como los permisos de las carpetas.

Recuerda la regla de oro: siempre haz copias de seguridad antes de hacer cualquier cambio. Y si te sientes perdido, no dudes en contactar con el soporte de tu hosting, que podrán guiarte a través de tu panel (como Syspanel) para verificar los permisos y la configuración del servidor.

Con paciencia y siguiendo estos pasos, tu tienda volverá a estar en línea en poco tiempo. ¡Mucha suerte!