{"title":"Filuppladdning","version":"6.1","locale":"sv","docname":"topics/http/file-uploads","url":"/sv/6.1/topics/http/file-uploads/","canonical":"https://djangodocs.dev/sv/6.1/topics/http/file-uploads/","summary":"När Django hanterar en filuppladdning placeras filinformationen i request.FILES (för mer information om objektet request se dokumentationen för request and response…","html":"

FiluppladdningLink to this heading#

\n

När Django hanterar en filuppladdning placeras filinformationen i request.FILES (för mer information om objektet request se dokumentationen för request and response objects). I det här dokumentet förklaras hur filer lagras på disk och i minne och hur du anpassar standardbeteendet.

\n\n
\n

Grundläggande filuppladdningarLink to this heading#

\n

Tänk dig ett formulär som innehåller en FileField:

\n
forms.py
\n
Python
from django import forms\n\n\nclass UploadFileForm(forms.Form):\n    title = forms.CharField(max_length=50)\n    file = forms.FileField()\n
\n

En vy som hanterar detta formulär kommer att få filinformationen i request.FILES, som är en ordbok som innehåller en nyckel för varje FileField (eller ImageField, eller annan FileField subklass) i formuläret. Så data från ovanstående formulär skulle vara tillgängliga som request.FILES['file'].

\n

Observera att request.FILES <django.http.HttpRequest.FILES>` endast kommer att innehålla data om förfrågningsmetoden var POST, minst ett filfält faktiskt postades och <form> som postade förfrågan har attributet enctype="multipart/form-data". Annars kommer request.FILES att vara tomt.

\n

För det mesta kommer du att skicka filinformationen från request till formuläret enligt beskrivningen i Binder uppladdade filer till ett formulär. Detta skulle se ut ungefär som:

\n
Vyer.py
\n
Python
from django.http import HttpResponseRedirect\nfrom django.shortcuts import render\nfrom .forms import UploadFileForm\n\n# Imaginary function to handle an uploaded file.\nfrom somewhere import handle_uploaded_file\n\n\ndef upload_file(request):\n    if request.method == "POST":\n        form = UploadFileForm(request.POST, request.FILES)\n        if form.is_valid():\n            handle_uploaded_file(request.FILES["file"])\n            return HttpResponseRedirect("/success/url/")\n    else:\n        form = UploadFileForm()\n    return render(request, "upload.html", {"form": form})\n
\n

Observera att vi måste skicka request.FILES till formulärets konstruktör; det är så här fildata binds till ett formulär.

\n

Här är ett vanligt sätt att hantera en uppladdad fil:

\n
Code
def handle_uploaded_file(f):\n    with open("some/file/name.txt", "wb+") as destination:\n        for chunk in f.chunks():\n            destination.write(chunk)\n
\n

Genom att loopa över UploadedFile.chunks() istället för att använda read() säkerställs att stora filer inte överbelastar systemets minne.

\n

Det finns några andra metoder och attribut som är tillgängliga för UploadedFile-objekt; se UploadedFile för en fullständig referens.

\n
\n

Hantera uppladdade filer med en modellLink to this heading#

\n

Om du sparar en fil på en Model med en FileField, kan du använda en ModelForm som gör processen mycket enklare. Filobjektet kommer att sparas på den plats som anges av upload_to-argumentet för motsvarande FileField när du anropar form.save():

\n
Code
from django.http import HttpResponseRedirect\nfrom django.shortcuts import render\nfrom .forms import ModelFormWithFileField\n\n\ndef upload_file(request):\n    if request.method == "POST":\n        form = ModelFormWithFileField(request.POST, request.FILES)\n        if form.is_valid():\n            # file is saved\n            form.save()\n            return HttpResponseRedirect("/success/url/")\n    else:\n        form = ModelFormWithFileField()\n    return render(request, "upload.html", {"form": form})\n
\n

Om du konstruerar ett objekt manuellt kan du tilldela filobjektet från request.FILES till filfältet i modellen:

\n
Code
from django.http import HttpResponseRedirect\nfrom django.shortcuts import render\nfrom .forms import UploadFileForm\nfrom .models import ModelWithFileField\n\n\ndef upload_file(request):\n    if request.method == "POST":\n        form = UploadFileForm(request.POST, request.FILES)\n        if form.is_valid():\n            instance = ModelWithFileField(file_field=request.FILES["file"])\n            instance.save()\n            return HttpResponseRedirect("/success/url/")\n    else:\n        form = UploadFileForm()\n    return render(request, "upload.html", {"form": form})\n
\n

Om du konstruerar ett objekt manuellt utanför en begäran kan du tilldela ett File liknande objekt till FileField:

\n
Code
from django.core.management.base import BaseCommand\nfrom django.core.files.base import ContentFile\n\n\nclass MyCommand(BaseCommand):\n    def handle(self, *args, **options):\n        content_file = ContentFile(b"Hello world!", name="hello-world.txt")\n        instance = ModelWithFileField(file_field=content_file)\n        instance.save()\n
\n
\n
\n

Ladda upp flera filerLink to this heading#

\n

Om du vill ladda upp flera filer med ett formulärfält skapar du en underklass av fältets widget och ställer in klassattributet allow_multiple_selected på True.

\n

För att alla sådana filer ska kunna valideras av ditt formulär (och fältets värde ska inkludera dem alla) måste du också underklassa FileField. Se nedan för ett exempel.

\n\n
forms.py
\n
Python
from django import forms\n\n\nclass MultipleFileInput(forms.ClearableFileInput):\n    allow_multiple_selected = True\n\n\nclass MultipleFileField(forms.FileField):\n    def __init__(self, *args, **kwargs):\n        kwargs.setdefault("widget", MultipleFileInput())\n        super().__init__(*args, **kwargs)\n\n    def clean(self, data, initial=None):\n        single_file_clean = super().clean\n        if isinstance(data, (list, tuple)):\n            result = [single_file_clean(d, initial) for d in data]\n        else:\n            result = [single_file_clean(data, initial)]\n        return result\n\n\nclass FileFieldForm(forms.Form):\n    file_field = MultipleFileField()\n
\n

Åsidosätt sedan metoden form_valid() i din FormView-underklass för att hantera flera filuppladdningar:

\n
Vyer.py
\n
Python
from django.views.generic.edit import FormView\nfrom .forms import FileFieldForm\n\n\nclass FileFieldFormView(FormView):\n    form_class = FileFieldForm\n    template_name = "upload.html"  # Replace with your template.\n    success_url = "..."  # Replace with your URL or reverse().\n\n    def form_valid(self, form):\n        files = form.cleaned_data["file_field"]\n        for f in files:\n            ...  # Do something with each file.\n        return super().form_valid(form)\n
\n\n
\n
\n
\n

UppladdningshanterareLink to this heading#

\n

När en användare laddar upp en fil skickar Django filinformationen till en uppladdningshanterare - en liten klass som hanterar filinformationen när den laddas upp. Uppladdningshanterare definieras initialt i inställningen FILE_UPLOAD_HANDLERS, som har standardvärdet:

\n
Code
[\n    "django.core.files.uploadhandler.MemoryFileUploadHandler",\n    "django.core.files.uploadhandler.TemporaryFileUploadHandler",\n]\n
\n

Tillsammans tillhandahåller MemoryFileUploadHandler och TemporaryFileUploadHandler Djangos standardbeteende för filuppladdning genom att läsa små filer i minnet och stora filer på disken.

\n

Du kan skriva egna handlers som anpassar hur Django hanterar filer. Du kan till exempel använda anpassade hanterare för att genomdriva kvoter på användarnivå, komprimera data i farten, rendera förloppsbalkar och till och med skicka data till en annan lagringsplats direkt utan att lagra dem lokalt. Se Skriva anpassade uppladdningshanterare för detaljer om hur du kan anpassa eller helt ersätta uppladdningsbeteendet.

\n
\n

Var uppladdade data lagrasLink to this heading#

\n

Innan du sparar uppladdade filer måste data lagras någonstans.

\n

Som standard, om en uppladdad fil är mindre än 2,5 megabyte, kommer Django att hålla hela innehållet i uppladdningen i minnet. Det innebär att när filen sparas sker endast en läsning från minnet och en skrivning till disken och det går därför mycket snabbt.

\n

Men om en uppladdad fil är för stor kommer Django att skriva den uppladdade filen till en temporär fil som lagras i ditt systems temporära katalog. På en Unix-liknande plattform betyder det att du kan förvänta dig att Django genererar en fil som heter något i stil med /tmp/tmpzfp6I6.upload. Om en uppladdning är tillräckligt stor kan du se den här filen växa i storlek när Django strömmar data till disken.

\n

Dessa specifikationer – 2,5 megabyte; /tmp; etc. – är ”rimliga standardvärden” som kan anpassas enligt beskrivningen i nästa avsnitt.

\n
\n
\n

Ändra beteende för uppladdningshanterareLink to this heading#

\n

Det finns några inställningar som styr Djangos filuppladdningsbeteende. Se Filuppladdningsinställningar för detaljer.

\n
\n
\n

Ändra uppladdningshanterare i fartenLink to this heading#

\n

Ibland kräver särskilda vyer olika uppladdningsbeteende. I dessa fall kan du åsidosätta uppladdningshanterare per begäran genom att ändra request.upload_handlers. Som standard innehåller den här listan de uppladdningshanterare som anges av FILE_UPLOAD_HANDLERS, men du kan ändra listan som du skulle göra med vilken annan lista som helst.

\n

Anta till exempel att du har skrivit en ProgressBarUploadHandler som ger feedback om uppladdningsförloppet till någon form av AJAX-widget. Du skulle lägga till den här hanteraren till dina uppladdningshanterare så här:

\n
Code
request.upload_handlers.insert(0, ProgressBarUploadHandler(request))\n
\n

Genom att använda list.insert(), som visas ovan, säkerställs att förloppsindikatorn placeras i början av listan. Eftersom uppladdningshanterare exekveras i ordning garanterar denna placering att förloppsindikatorn körs före standardhanterarna, vilket gör att den kan spåra förloppet under hela uppladdningen.

\n

Om du vill ersätta uppladdningshanterarna helt och hållet kan du tilldela en ny lista:

\n
Code
request.upload_handlers = [ProgressBarUploadHandler(request)]\n
\n\n
\n
","rootId":"file-uploads","toc":[{"title":"Grundläggande filuppladdningar","anchor":"basic-file-uploads","children":[{"title":"Hantera uppladdade filer med en modell","anchor":"handling-uploaded-files-with-a-model","children":[]},{"title":"Ladda upp flera filer","anchor":"uploading-multiple-files","children":[]}]},{"title":"Uppladdningshanterare","anchor":"upload-handlers","children":[{"title":"Var uppladdade data lagras","anchor":"where-uploaded-data-is-stored","children":[]},{"title":"Ändra beteende för uppladdningshanterare","anchor":"changing-upload-handler-behavior","children":[]},{"title":"Ändra uppladdningshanterare i farten","anchor":"modifying-upload-handlers-on-the-fly","children":[]}]}],"breadcrumbs":[{"docname":"topics/index","title":"Använda Django","url":"/sv/6.1/topics/"},{"docname":"topics/http/index","title":"Hantering av HTTP-förfrågningar","url":"/sv/6.1/topics/http/"}],"prev":{"docname":"topics/http/decorators","title":"Visa dekoratörer","url":"/sv/6.1/topics/http/decorators/"},"next":{"docname":"topics/http/shortcuts","title":"Django genvägsfunktioner","url":"/sv/6.1/topics/http/shortcuts/"},"formats":{"html":"/sv/6.1/topics/http/file-uploads/","markdown":"/sv/6.1/topics/http/file-uploads.md","json":"/sv/6.1/topics/http/file-uploads.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/topics/http/file-uploads.txt","official":"https://docs.djangoproject.com/sv/6.1/topics/http/file-uploads/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}