{"title":"Uaslódálacha Comhad","version":"6.0","locale":"ga","docname":"topics/http/file-uploads","url":"/ga/6.0/topics/http/file-uploads/","canonical":"https://djangodocs.dev/ga/6.0/topics/http/file-uploads/","summary":"Nuair a láimhseálann Django uaslódáil comhad, críochnaíonn sonraí na gcomhad cuirtear in:attr: `…","html":"

Uaslódálacha ComhadLink to this heading#

\n

Nuair a láimhseálann Django uaslódáil comhad, críochnaíonn sonraí </ref/request-response> <django.http.HttpRequest.FILES>na gcomhad cuirtear in:attr: `request.files `(le haghaidh tuilleadh eolais ar an réad ``iarraidh ``féach an doiciméadú le haghaidh: doc: `earraí iarratais agus freagartha'). Míníonn an doiciméad seo conas a stóráiltear comhaid ar dhiosca agus i gcuimhne, agus conas an t-iompar réamhshocraithe a shain

\n\n
\n

Uaslódálacha comhaid bunúsachaLink to this heading#

\n

Smaoinigh ar fhoirm ina bhfuil a:class: ~django.forms.filefield:

\n
foirme.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

Gheobhaidh amharc ag láimhseáil an fhoirm seo na sonraí comhad in:attr: Request.File`<django.http.HttpRequest.FILES>, ar foclóir é ina bhfuil eochair do gach ceach:class: `~django.forms.filefield (nó:class: ~django.forms.imagefield nó eile:class: ~django.forms.filefield) sa fhoirm. Mar sin bheadh na sonraí ón bhfoirm thuas inrochtana mar ``request.files ['file'] ``.

\n

<form>Tabhair faoi deara nach m <django.http.HttpRequest.FILES>beidh sonraí: attr: Request.files `ach mura raibh an modh iarratais ``POST `, cuireadh réimse comhad amháin ar a laghad a phostáil i ndáiríre, agus tá an tréith enctype="multipart/form-data" ag an`` a chuir an iarraidh. Seachas sin, beidh ``request.files folamh.

\n

An chuid is mó den am, cuirfidh tú na sonraí comhad ó request isteach sa fhoirm mar a thuairiscítear in:ref: binding-uploaded-files. Bheadh cuma rud éigin air seo:

\n
views.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

Tabhair faoi deara go gcaithfimid: attr: `Request.files <django.http.HttpRequest.FILES>`a chur isteach i dtógálaí na foirme; seo mar a chuirtear sonraí comhad ceangailte i bhfoirm.

\n

Seo bealach coitianta a d'fhéadfá comhad uaslódáilte a láimhseáil:

\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

Cinntíonn lupáil thar uploadedfile.chunks () ``in ionad ``read () a úsáid nach gcuireann comhaid mhóra cuimhne do chórais a shárú.

\n

Tá cúpla modh agus tréithe eile ar fáil ar rudaí uploadedfile; féach:class: UploadedFile le haghaidh tagartha iomlán.

\n
\n

Comhaid uaslódáilte a láimhseáilLink to this heading#

\n

Má tá comhad á shábháil agat ar a:class: ~django.db.models.model le a:class: ~django.db.models.filefield, déanann an próiseas seo i bhfad níos éasca ag baint úsáide as a:class: ~django.forms.ModelForm. Sábhálfar réad an chomhaid chuig an suíomh a shonraítear leis an:attr: ~django.db.models.filefield.upload_to argóint an chomhfhreagraí:class: ~django.db.models.filefield nuair a ghlaoch ``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

Má tá réad á thógáil agat de láimh, is féidir leat an réad comhaid a shannadh ó:attr: `request.files <django.http.HttpRequest.FILES>`chuig an réimse comhaid sa tsamhail:

\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

Má tá réad á thógáil agat de láimh lasmuigh d'iarratas, is féidir leat a:class: ~django.core.files.file cosúil le réad a shannadh chuig an:class: ~django.db.models.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

Comhad iolracha a uaslódáilLink to this heading#

\n

Más mian leat comhad iolracha a uaslódáil ag baint úsáide as réimse foirme amháin, cruthaigh fo-aicme de ghuirléid an réimse agus socraigh a tréith aicme allow_multiple_selected go True.

\n

Ionas go mbeidh comhaid den sórt sin go léir a bhailíochtú ag d'fhoirm (agus go mbeidh luach an réimse iad go léir san áireamh), beidh ort fo-aicme “FileField” a dhéanamh freisin. Féach thíos le haghaidh sampla.

\n\n
foirme.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

Ansin athraigh an modh ``form_valid () ``de d':class: ~django.views.generic.edit.formView chun uaslódálacha comhad iolracha a láimhseáil:

\n
views.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

Uaslódáil HandlersLink to this heading#

\n

Nuair a uaslódálann úsáideoir comhad, cuireann Django sonraí na gcomhad chuig*láimhseálaí uaslódálaí* - rang beag a láimhseálann sonraí comhaid de réir mar a uaslódáltar iad. Sainmhínítear láimhseálaithe uaslódála ar dtús sa socrú:setting: FILE_UPLOAD_HANDLERS, a réamhshocraíonn:

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

Le chéile: Class: MemoryFileUploadHandler agus: class: TemporaryFileUploadHandler soláthraíonn iompar uaslódála comhaid réamhshocraithe Django maidir le comhaid bheaga a léamh isteach i gcuimhne agus cinn mhóra ar an diosca.

\n

Is féidir leat láimhseálaithe saincheaptha a scríobh a shaincheapann an chaoi a láimhseálann D'fhéadfá, mar shampla, láimhseálaithe saincheaptha a úsáid chun cuótaí ar leibhéal an úsáideora a fhorfheidhmiú, sonraí a chomhbhrú ar an eitilt, barraí dul chun cinn a léiriú, agus fiú sonraí a sheoladh chuig áit stórála eile go díreach gan Féach: ref: custom_upload_handlers le haghaidh sonraí maidir le conas is féidir leat iompar uaslódála a shaincheapadh nó a athsholáthar go hiomlán.

\n
\n

Nuair a stóráiltear sonraí uaslódáLink to this heading#

\n

Sula sábhálann tú comhaid uaslódáilte, ní mór na sonraí a stóráil áit éigin.

\n

De réir réamhshocraithe, má tá comhad uaslódáilte níos lú ná 2.5 meigabyte, coinneoidh Django ábhar iomlán an uaslódála i gcuimhne. Ciallaíonn sé seo nach mbíonn ach léamh ón gcuimhne agus scríobh chuig diosca i gceist leis an gcomhad a shábháil agus dá bhrí sin tá sé an-tapa.

\n

Mar sin féin, má tá comhad uaslódáilte ró-mhór, scríobhfaidh Django an comhad uaslódáilte chuig comhad sealadach atá stóráilte in eolaire sealadach do chórais. Ar ardán cosúil le Unix ciallaíonn sé seo gur féidir leat a bheith ag súil go nginfidh Django comhad ar a dtugtar rud éigin cosúil le /tmpzfp6i6.upload. Má tá uaslódáil mór go leor, is féidir leat féachaint ar an gcomhad seo ag fás i méid de réir mar a shruthlaíonn Django na sonraí ar an diosca.

\n

Is “réamhshocruithe réasúnacha” iad na sonraíochtaí seo - 2.5 meigabyte; /tmp; srl. - is féidir iad a shaincheapadh mar a thuairiscítear sa chéad chuid eile.

\n
\n
\n

Iompar láimhseála uaslódálaLink to this heading#

\n

Tá cúpla socrú ann a rialaíonn iompar uaslódála comhad Django. Féach: Ref: `Socruithe Uaslódála Comhad <file-upload-settings>`le haghaidh sonraí.

\n
\n
\n

Láimhseálóirí uaslódála a mhodhnúLink to this heading#

\n

Uaireanta teastaíonn iompar uaslódála éagsúla Sna cásanna seo, is féidir leat láimhseálaithe uaslódála a shárú ar bhonn in aghaidh iarratais trí ``request.upload_handlers` a mhodhnú. De réir réamhshocraithe, beidh na láimhseálaithe uaslódála a thugtar ar:setting: FILE_UPLOAD_HANDLERS sa liosta seo, ach is féidir leat an liosta a mhodhnú mar a dhéanfá aon liosta eile.

\n

Mar shampla, cuir i gcás go bhfuil “ProgressbarUploadHandler” scríofa agat a sholáthraíonn aiseolas ar dhul chun cinn a uaslódáil chuig cineál éigin giuirléid AJAX. Chuirfeá an láimhseálaí seo le do láimhseálaithe uaslódála mar seo:

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

Using list.insert(), as shown above, ensures that the progress bar handler\nis placed at the beginning of the list. Since upload handlers are executed in\norder, this placement guarantees that the progress bar handler runs before the\ndefault handlers, allowing it to track progress across the entire upload.

\n

Más mian leat na láimhseálaithe uaslódála a chur in ionad go hiomlán, is féidir leat liosta nua a shannadh:

\n
Code
request.upload_handlers = [ProgressBarUploadHandler(request)]\n
\n\n
\n
","rootId":"file-uploads","toc":[{"title":"Uaslódálacha comhaid bunúsacha","anchor":"basic-file-uploads","children":[{"title":"Comhaid uaslódáilte a láimhseáil","anchor":"handling-uploaded-files-with-a-model","children":[]},{"title":"Comhad iolracha a uaslódáil","anchor":"uploading-multiple-files","children":[]}]},{"title":"Uaslódáil Handlers","anchor":"upload-handlers","children":[{"title":"Nuair a stóráiltear sonraí uaslódá","anchor":"where-uploaded-data-is-stored","children":[]},{"title":"Iompar láimhseála uaslódála","anchor":"changing-upload-handler-behavior","children":[]},{"title":"Láimhseálóirí uaslódála a mhodhnú","anchor":"modifying-upload-handlers-on-the-fly","children":[]}]}],"breadcrumbs":[{"docname":"topics/index","title":"Using Django","url":"/ga/6.0/topics/"},{"docname":"topics/http/index","title":"Láimhseáil iarratais HTTP","url":"/ga/6.0/topics/http/"}],"prev":{"docname":"topics/http/decorators","title":"Féach ar mhaisitheoirí","url":"/ga/6.0/topics/http/decorators/"},"next":{"docname":"topics/http/shortcuts","title":"Django shortcut functions","url":"/ga/6.0/topics/http/shortcuts/"},"formats":{"html":"/ga/6.0/topics/http/file-uploads/","markdown":"/ga/6.0/topics/http/file-uploads.md","json":"/ga/6.0/topics/http/file-uploads.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/topics/http/file-uploads.txt","official":"https://docs.djangoproject.com/ga/6.0/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"]}