Jaka jest różnica między plikami statycznymi a plikami mediów?

Question

Accepted Answer

Django rozróżnia dwa rodzaje plików: **pliki statyczne** (zasoby, które są częścią aplikacji — CSS, JavaScript, obrazy, które dostarczasz) i **pliki mediów** (pliki **przesyłane przez użytkowników** w czasie działania — zdjęcia profilowe, dokumenty). Są obsługiwane inaczej, ponieważ ich źródła i cykle życia różnią się fundamentalnie. ## Pliki statyczne — zasoby aplikacji ```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 %}

``` Pliki statyczne są **częścią bazy kodów** — CSS, JS, czcionki, obrazy projektowe. Są wersjonowane, takie same dla wszystkich użytkowników i serwowane z katalogów statycznych projektu. ## collectstatic do produkcji ```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 ``` W produkcji `collectstatic` konsoliduje pliki statyczne ze wszystkich aplikacji do jednego katalogu (`STATIC_ROOT`), który serwer WWW lub CDN może serwować — Django nie serwuje ich sam w produkcji. ## Pliki mediów — przesyłki użytkowników ```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 ``` Pliki mediów są **przesyłane przez użytkowników w czasie działania** za pośrednictwem `FileField`/`ImageField`. Są dynamiczne, NIE są w kontroli wersji i rosną w czasie, gdy użytkownicy przesyłają zawartość. ## Kluczowe różnice ```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 ``` ## Zagadnienia produkcyjne ```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) ``` ## Dlaczego to ważne Zrozumienie rozróżnienia między plikami statycznymi a mediami jest ważne zarówno dla prawidłowego budowania, jak i prawidłowego wdrażania aplikacji Django, ponieważ te dwa typy plików mają fundamentalnie różne źródła, cykle życia i wymagania obsługi. **Pliki statyczne** (własne CSS, JavaScript, obrazy, czcionki aplikacji) są częścią bazy kodów, wersjonowane i takie same dla wszystkich — przywoływane za pośrednictwem `{% static %}` i konsolidowane za pomocą `collectstatic` do serwowania w produkcji przez serwer WWW lub CDN. **Pliki mediów** (przesyłki użytkowników za pośrednictwem `FileField`/`ImageField`) to dynamiczna, generowana przez użytkownika zawartość tworzona w czasie działania, NIE w kontroli wersji i stale rosnąca. Pomylenie ich lub błędna konfiguracja ich ustawień (`STATIC_*` vs `MEDIA_*`) jest częstą przyczyną problemów typu „mój CSS się nie ładuje