Quelle est la différence entre les fichiers statiques et les fichiers médias ?

Question

Accepted Answer

Django distingue deux types de fichiers : les **fichiers statiques** (ressources qui font partie de votre application — CSS, JavaScript, images que vous livrez) et les **fichiers médias** (fichiers **téléchargés par les utilisateurs** à l'exécution — photos de profil, documents). Ils sont traités différemment car leurs sources et leurs cycles de vie diffèrent fondamentalement. ## Fichiers statiques — les ressources de votre application ```python # settings.py STATIC_URL = "/static/" STATICFILES_DIRS = [BASE_DIR / "static"] # where YOU put source static files STATIC_ROOT = BASE_DIR / "staticfiles" # where collectstatic GATHERS them for prod ``` ```html {% load static %}

``` Les fichiers statiques font **partie de votre base de code** — CSS, JS, polices, images de conception. Ils sont versionnés, identiques pour tous les utilisateurs, et servis à partir des répertoires statiques de votre projet. ## collectstatic pour la production ```bash python manage.py collectstatic # gathers ALL static files (from your apps and STATICFILES_DIRS) into STATIC_ROOT, # so a web server / CDN can serve them efficiently in production ``` En production, `collectstatic` consolide les fichiers statiques de toutes les applications dans un seul répertoire (`STATIC_ROOT`) pour que le serveur web ou le CDN les serve — Django ne les sert pas lui-même en production. ## Fichiers médias — téléchargements utilisateur ```python # settings.py MEDIA_URL = "/media/" MEDIA_ROOT = BASE_DIR / "media" # where UPLOADED files are stored ``` ```python # a model with an uploadable file class Profile(models.Model): avatar = models.ImageField(upload_to="avatars/") # stored under MEDIA_ROOT/avatars/ document = models.FileField(upload_to="docs/") profile.avatar.url # the URL to access the uploaded file ``` Les fichiers médias sont **téléchargés par les utilisateurs à l'exécution** via `FileField`/`ImageField`. Ils sont dynamiques, NON versionnés, et croissent au fil du temps à mesure que les utilisateurs téléchargent du contenu. ## Les différences clés ```text Static files Media files Source part of your code uploaded by users at runtime Version control YES (committed) NO (user-generated, .gitignored) Lifecycle fixed (changes with code) dynamic (grows continuously) Examples CSS, JS, logos, fonts avatars, uploaded documents, photos Settings STATIC_URL/ROOT/DIRS MEDIA_URL/ROOT Production collectstatic + CDN/server stored on disk/cloud (S3), served carefully ``` ## Considérations pour la production ```text ✓ Static → serve via the web server (nginx) or a CDN (cached, fast) ✓ Media → store on cloud storage (S3) for scalability/persistence; in multi-server setups, local disk doesn't work (files must be shared) → use S3/object storage ✓ Security → VALIDATE uploaded files (type, size); be careful serving user uploads (a user could upload malicious content) ``` ## Pourquoi c'est important Comprendre la distinction entre fichiers statiques et fichiers médias est important pour construire correctement et déployer convenablement les applications Django, car ces deux types de fichiers ont des sources, des cycles de vie et des exigences de traitement fondamentalement différents. Les **fichiers statiques** (les CSS, JavaScript, images et polices de votre application) font partie de la base de code, sont versionnés, et sont identiques pour tous — référencés via `{% static %}` et consolidés avec `collectstatic` pour la production en étant servis par un serveur web ou un CDN. Les **fichiers médias** (téléchargements utilisateur via `FileField`/`ImageField`) sont du contenu dynamique généré par l'utilisateur créé à l'exécution, NON versionnés, et en croissance continue. Les confondre ou mal configurer leurs paramètres (`STATIC_*` vs `MEDIA_*`) est une source courante de problèmes « mes CSS ne se chargent pas » ou « les téléchargements ne fonctionnent pas », particulièrement en production où Django ne sert pas lui-même les fichiers statiques (nécessitant `collectstatic` et un serveur/CDN approprié). Cette distinction a aussi des implications importantes pour la **production et la sécurité** : les fichiers médias dans les déploiements multi-serveurs ne peuvent pas dépendre du disque local (ils doivent utiliser un stockage cloud partagé comme S3), et les téléchargements utilisateur nécessitent une **validation** (type de fichier, taille) et un servage soigneux pour éviter les risques de sécurité liés aux contenus malveillants. Savoir comment configurer et gérer les deux types, le rôle de `collectstatic`, et les considérations de production (CDN pour les fichiers statiques, stockage cloud pour les médias, sécurité des téléchargements) est une connaissance pratique, fréquemment nécessaire pour construire et déployer correctement les applications Django réelles — un obstacle courant que cette compréhension résout.