Estructura de carpetes

Què hi ha dins de la instal·lació i on viu cada cosa (admin, modules, themes, src).

26 de maig del 2026 5 slides 5 min de lectura

PrestaShop · Instal·lació

Estructura de carpetes

Un mapa per no perdre's dins del codi.
Les carpetes que importen

No cal saber-ho tot, però sí ubicar les peces clau.
- admin/ — el back-office (carpeta amb sufix aleatori).
- themes/ — els temes del front-office.
- modules/ — els mòduls instal·lats.
- src/ i classes/ — el nucli (Symfony nou + llegat).
- var/ — cache, logs i fitxers generats.
PrestaShop · Instal·lació i entorn arlaf.dev
El nucli dual

src/ conté l'arquitectura moderna basada en Symfony; classes/ i controllers/ guarden el nucli clàssic. Conviuen, i saber-ho t'estalvia confusió.
var/ és reciclable

Tot el que hi ha a var/cache es regenera. Si una cosa rara passa, esborrar la cache és el primer remei abans de buscar bugs.
On NO tocar

No editis mai el nucli directament. Tot el que vulguis canviar es fa amb mòduls, temes fills i overrides — així sobreviu a les actualitzacions.

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.