Folder structure

What's inside the install and where each thing lives (admin, modules, themes, src).

May 26, 2026 5 slides 5 min read

PrestaShop · Instal·lació

Folder structure

A map so you don't get lost in the code.
The folders that matter

You don't need to know it all, but you must locate the key pieces.
- admin/ — the back office (folder with a random suffix).
- themes/ — the front-office themes.
- modules/ — the installed modules.
- src/ and classes/ — the core (new Symfony + legacy).
- var/ — cache, logs and generated files.
PrestaShop · Installation and environment arlaf.dev
The dual core

src/ holds the modern Symfony-based architecture; classes/ and controllers/ keep the classic core. They coexist, and knowing it saves you confusion.
var/ is throwaway

Everything in var/cache is regenerated. If something weird happens, clearing the cache is the first fix before hunting bugs.
Where NOT to touch

Never edit the core directly. Everything you want to change goes through modules, child themes and overrides — that way it survives updates.

Quan obres una instal·lació de PrestaShop per primer cop, la quantitat de carpetes espanta. La bona notícia: només n’has de tenir clares unes quantes.

El mapa mínim

admin/ (amb sufix aleatori) — el back-office. La teva URL d’administració.
themes/ — els temes del front-office; cada tema, una carpeta.
modules/ — un directori per mòdul instal·lat.
src/ — el codi modern, organitzat a l’estil Symfony.
classes/ i controllers/ — el nucli clàssic, encara molt viu.
var/ — cache, logs i compilacions; tot regenerable.
config/ — paràmetres de l’aplicació i connexió a la base de dades.

El nucli dual, explicat

PrestaShop arrossega anys d’història. Les versions modernes (1.7, 8.x) van portar Symfony a src/, però el nucli clàssic de classes/ i controllers/ encara mou bona part de la botiga. No és desordre: és una migració a mig camí. Tenir-ho present evita la confusió de “per què hi ha dues maneres de fer el mateix”.

La regla d’or

El nucli no es toca. Cap fitxer de classes/, controllers/ o src/ s’edita a mà. Tot el que vulguis personalitzar es fa des de fora —mòduls, temes fills, overrides— perquè una actualització de PrestaShop no t’esborri la feina. És la diferència entre una botiga que es pot mantenir i una que es trenca al primer update.