Jaký je rozdíl mezi statickými soubory a mediálními soubory?

Question

Accepted Answer

Django rozlišuje dva typy souborů: **statické soubory** (assets, která jsou součástí vaší aplikace — CSS, JavaScript, obrázky, které distribuujete) a **mediální soubory** (soubory **nahrané uživateli** za běhu — profilové obrázky, dokumenty). Jsou zpracovávány odlišně, protože jejich zdroje a životní cykly se zásadně liší. ## Statické soubory — assets vaší aplikace ```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 %}

``` Statické soubory jsou **součástí vaší kódové základny** — CSS, JS, fonty, designové obrázky. Jsou verzovány, jsou stejné pro všechny uživatele a jsou podávány z adresářů static vašeho projektu. ## collectstatic pro produkci ```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 ``` V produkci `collectstatic` konsoliduje statické soubory ze všech aplikací do jednoho adresáře (`STATIC_ROOT`), aby je mohl podávat webový server nebo CDN — Django je v produkci sám neobsluhuje. ## Mediální soubory — nahrání od uživatelů ```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 ``` Mediaální soubory jsou **nahrány uživateli za běhu** přes `FileField`/`ImageField`. Jsou dynamické, NEJSOU ve správě verzí a rostou v čase, jak uživatelé nahrávají obsah. ## Klíčové rozdíly ```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 ``` ## Důležité aspekty produkce ```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) ``` ## Proč je to důležité Porozumění rozdílu mezi statickými a mediálními soubory je důležité jak pro správné vytváření, tak pro správné nasazování Django aplikací, protože tyto dva typy souborů mají zásadně odlišné zdroje, životní cykly a požadavky na zpracování. **Statické soubory** (vlastní CSS, JavaScript, obrázky a fonty vaší aplikace) jsou součástí kódové základny, jsou verzovány a jsou stejné pro všechny — jsou odkazovány přes `{% static %}` a konsolidovány pomocí `collectstatic` pro produkční obsluhu webovým serverem nebo CDN. **Mediální soubory** (nahrání od uživatelů přes `FileField`/`ImageField`) jsou dynamickým, uživatelem vytvořeným obsahem vytvořeným za běhu, NEJSOU ve správě verzí a neustále rostou. Zaměňování těchto souborů nebo chybná konfigurace jejich nastavení (`STATIC_*` vs `MEDIA_*`) je běžným zdrojem problémů typu "moje CSS se nenačítá" nebo "nahrávání nefunguje", zejména v produkci, kde Django neobsluhuje statické soubory sám (vyžaduje `collectstatic` a správný server/CDN). Rozdíl má také důležité **dopady na produkci a bezpečnost**: mediální soubory v nasazeních s více servery nemohou spoléhat na místní disk (musí používat sdílené cloudové úložiště jako S3) a nahrávání od uživatelů vyžaduje **ověřování** (typ souboru, velikost) a opatrné obsluhovávání, aby se zabránilo bezpečnostním rizikům z maliciózního obsahu. Znalost toho, jak konfigurovat a zpracovávat oba typy souborů, role `collectstatic` a produkční úvahy (CDN pro statické soubory, cloudové úložiště pro mediální soubory, bezpečnost nahrávání) je praktická, často potřebná znalost pro správné vytváření a nasazování skutečných Django aplikací — běžný problém, který toto porozumění řeší.