--- title: "API stórála comhad" version: 6.0 locale: ga source: https://docs.djangoproject.com/ga/6.0/ref/files/storage/ canonical: https://djangodocs.dev/ga/6.0/ref/files/storage/ --- # API stórála comhad ## An rang stórála réamhshocraithe a fháil Soláthraíonn Django bealaí áisiúla chun teacht ar an rang stórála réamhshocraithe #### `storages` Rud cosúil le foclóir a cheadaíonn cás stórála a aisghabháil ag baint úsáide as a ainm mar a shainmhínítear ar:setting: STORAGES. Tá tréith `backends` ag stórálaí \`, a réamhshocraíonn an luach amh a chuirtear ar fáil in:setting: STORAGES. Ina theannta sin, soláthraíonn `storages` modh create\_storage () a ghlacann leis an bhfoclóir a úsáidtear in:setting: STORAGES le haghaidh cúltaca, agus a thugann sé sampla stórála bunaithe ar an sainmhíniú cúltaca sin. D'fhéadfadh sé seo a bheith úsáideach do phacáistí tríú páirtí a theastaíonn uathu stórálaí a thabhairt isteach i d ```pycon >>> from django.core.files.storage import storages >>> storages.backends {'default': {'BACKEND': 'django.core.files.storage.FileSystemStorage'}, 'staticfiles': {'BACKEND': 'django.contrib.staticfiles.storage.StaticFilesStorage'}, 'custom': {'BACKEND': 'package.storage.CustomStorage'}} >>> storage_instance = storages.create_storage({"BACKEND": "package.storage.CustomStorage"}) ``` #### `class DefaultStorage` [`DefaultStorage`](#django.core.files.storage.DefaultStorage) provides lazy access to the default storage system as defined by `default` key in [`STORAGES`](/ga/6.0/ref/settings/#std-setting-STORAGES). [`DefaultStorage`](#django.core.files.storage.DefaultStorage) uses [`storages`](#django.core.files.storage.storages) internally. #### `default_storage` [`default_storage`](#django.core.files.storage.default_storage) is an instance of the [`DefaultStorage`](#django.core.files.storage.DefaultStorage). ## An rang `FilesystemStorage` #### `class FileSystemStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None, allow_overwrite=False)` Cuireann rang:class: ~django.core.files.storage.filesystemStorage stóráil bunúsach comhaid i bhfeidhm ar chóras comhaid áitiúil. Oidhreacht aige ó:class: ~django.core.files.storage.storage agus soláthraíonn sé cur i bhfeidhm do na modhanna poiblí uile dá leithéid. > **Note** > > Ní ardóidh an modh FilesystemStorage.delete () eisceacht mura bhfuil ainm an chomhaid tugtha ann. #### `location` Conair iomlán chuig an eolaire a shealbhóidh na comhaid. Réamhshocraithe ar luach do shuíomh: socrú: MEDIA\_ROOT. #### `base_url` URL a fhreastalaíonn ar na comhaid atá stóráilte ag an áit seo. Réamhshocraithe ar luach do shuíomh: socrú: MEDIA\_URL. #### `file_permissions_mode` Ceadanna an chórais chomhaid a gheobhaidh an comhad nuair a shábháiltear é. Réamhshocraithe chuig: socrú: FILE\_UPLOAD\_PERMISSIONS. #### `directory_permissions_mode` Ceadanna an chórais chomhaid a gheobhaidh an eolaire nuair a shábháiltear é. Réamhshocraithe chuig: socrú: FILE\_UPLOAD\_DIRECTORY\_PERMISSIONS. #### `allow_overwrite` Bratach chun rialú a ligeann comhad nua a shábháil thar ceann atá ann cheana. Réamhshocraithe go `False`. #### `get_created_time(name)` Tuairisceann a:class: ~datetime.datetime de ctime an chórais, i.e.:func: os.path.getctime. Ar roinnt córais (cosúil le Unix), is é seo an t-athrú meiteashonraí deireanach, agus ar chórais eile (cosúil le Windows), is é am cruthaithe an chomhaid é. ## An rang `InmemoryStorage` #### `class InMemoryStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None)` Cuireann rang:class: ~django.core.files.storage.inMemoryStorage stóráil comhaid bunaithe ar chuimhne i bhfeidhm. Níl aon mharthanacht aige, ach féadann sé a bheith úsáideach chun tástálacha a bhrostú trí rochtain ar dhiosca a sheachaint. #### `location` Conair iomlán chuig ainm an eolaire a shanntar do chomhaid. Réamhshocraithe ar luach do shuíomh: socrú: MEDIA\_ROOT. #### `base_url` URL a fhreastalaíonn ar na comhaid atá stóráilte ag an áit seo. Réamhshocraithe ar luach do shuíomh: socrú: MEDIA\_URL. #### `file_permissions_mode` Na ceadanna córais chomhaid a shanntar do chomhaid, a sholáthraítear le haghaidh comhoiriúnacht le `FilesystemStorage`. Réamhshocraithe chuig: socrú: FILE\_UPLOAD\_PERMISSIONS. #### `directory_permissions_mode` Na ceadanna córais chomhaid a shanntar d'eolairí, a sholáthraítear le haghaidh comhoiriúnacht le `FilesystemStorage`. Réamhshocraithe chuig: socrú: FILE\_UPLOAD\_DIRECTORY\_PERMISSIONS. ## An rang `Stórála` #### `class Storage` Soláthraíonn an rang:Class: ~django.core.files.storage.storage API caighdeánaithe chun comhaid a stóráil, mar aon le sraith iompraíochtaí réamhshocraithe ar féidir le gach córas stórála eile a oidhreacht nó a shárú de réir mar is gá. > **Note** > > Nuair a fhilleann modhanna rudaí `datetime` naif, is é an crios ama éifeachtach a úsáidtear ná luach reatha os.environ \['TZ'\] ; tabhair faoi deara go socraítear é seo de ghnáth ó Django's:SETTING: \`TIME\_ZONE. #### `delete(name)` Scriosann sé an comhad dá dtagraítear ```ainm ``. Mura dtacaítear le scriosadh ar an spriocchóras stórála ardóidh sé seo ``NotImplementederror``` ina ionad sin. #### `exists(name)` Tugann sé ar ais `True` má tá comhad dá dtagraítear leis an ainm tugtha cheana sa chóras stórála. #### `get_accessed_time(name)` Tuairisceann a:class: ~datetime.datetime an t-am deireanach a rochtain ar an gcomhad. Maidir le córais stórála nach féidir leis an am dheireanach a rochtain a thabhairt ar ais, ardóidh sé seo: exc: NotImplementeDerror. Má tá: Setting: `` `True `` USE\_TZ, filleann `datetime` ar an eolas, ar shlí eile filleann `datetime` naif sa chrios ama áitiúil. #### `get_alternative_name(file_root, file_ext)` Tugann ainm comhaid malartach ar ais bunaithe ar na paraiméadair file\_root\` agus file\_ext\`, cuirtear béim móide sreang alfauméireach randamach 7 charachtar leis an ainm comhaid roimh an síneadh. #### `get_available_name(name, max_length=None)` Tugann ainm comhaid ar ais bunaithe ar an bparaiméadar ainm atá saor in aisce agus atá ar fáil le haghaidh ábhar nua le scríobh chuige ar an spriocchóras stórála. Ní rachaidh fad an ainm comhaid thar max\_length , má chuirtear ar fáil. \Mura féidir ainm comhaid uathúil saor in aisce a fháil, ardófar eisceacht a: exc: SuspiciousFileOperation. Má tá comhad le ainm ann cheana féin, glaoirtear ar :meth: get\_alternative\_name chun ainm malartach a fháil. #### `get_created_time(name)` Tuairisceann a:class: ~datetime.datetime am cruthaithe an chomhaid. Maidir le córais stórála nach féidir leis an am cruthaithe a thabhairt ar ais, ardóidh sé seo: exc: NotImplementeDerror. Má tá: Setting: `` `True `` USE\_TZ, filleann `datetime` ar an eolas, ar shlí eile filleann `datetime` naif sa chrios ama áitiúil. #### `get_modified_time(name)` Tugann a:class: ~datetime.datetime an t-am modhnaithe deireanach den chomhad. Maidir le córais stórála nach féidir leis an am deireanach modhnaithe a thabhairt ar ais, ardóidh sé seo: exc: NotImplementeDerror. Má tá: Setting: `` `True `` USE\_TZ, filleann `datetime` ar an eolas, ar shlí eile filleann `datetime` naif sa chrios ama áitiúil. #### `get_valid_name(name)` Tugann ainm comhaid ar ais bunaithe ar an bparaiméadar ainm atá oiriúnach le húsáid ar an spriocchóras stórála. #### `generate_filename(filename)` Validates the `filename` by calling [`get_valid_name`](/ga/6.0/howto/custom-file-storage/#django.core.files.storage.get_valid_name) and returns a filename to be passed to the [`save()`](#django.core.files.storage.Storage.save) method. The `filename` argument may include a path as returned by [`FileField.upload_to`](/ga/6.0/ref/models/fields/#django.db.models.FileField.upload_to). In that case, the path won't be passed to [`get_valid_name`](/ga/6.0/howto/custom-file-storage/#django.core.files.storage.get_valid_name) but will be prepended back to the resulting name. Úsáideann an cur i bhfeidhm réamhshocraithe oibríochtaí: mod: os.path. Athraigh an modh seo mura bhfuil sé sin oiriúnach do do stóráil. #### `listdir(path)` Liostaíonn sé ábhar an chosáin shonraithe, ag tabhairt ar ais dhá liostaí; is eolairí an chéad mhír, agus is comhaid an dara mír. Maidir le córais stórála nach bhfuil in ann liostú den sórt sin a sholáthar, ardóidh sé seo “NotImplementederror” ina ionad sin. #### `open(name, mode='rb')` Osclaíonn sé an comhad a thugtar ag ainm . Tabhair faoi deara cé go ráthaítear gurb é an comhad a chuirtear ar ais ina réad Comhad , d'fhéadfadh sé a bheith i ndáiríre fo-aicme éigin. I gcás stórála comhaid iargúlta ciallaíonn sé seo go bhféadfadh léitheoir/scríbhneoireacht a bheith mall go leor, mar sin tabhair rabhadh. #### `path(name)` An cosán córais chomhaid áitiúil inar féidir an comhad a oscailt ag baint úsáide as caighdeánach Python open () \`. Maidir le córais stórála nach bhfuil inrochtana ón gcóras comhaid áitiúil, ardóidh sé seo \`NotImplementederror\` ina ionad sin. #### `save(name, content, max_length=None)` Sábhálann sé comhad nua ag baint úsáide as an gcóras stórála, b'fhearr leis an ainm a sh Má tá comhad ann cheana féin leis an ainm seo ainm , féadfaidh an córas stórála an t-ainm comhaid a mhodhnú de réir mar is gá chun ainm uathúil a fháil. Cuirfear ainm iarbhír an chomhaid stóráilte ar ais. Cuirtear an argóint max\_length \`\`ar aghaidh chuig: meth: \`get\_available\_name. Caithfidh an argóint `content` a bheith ina shampla de:class: django.core.files.file nó réad cosúil le comhad is féidir a fhilleadh i Comhad \`. #### `size(name)` Tugann sé ar ais méid iomlán, i mbeátaí, an chomhaid dá dtagraítear ```ainm ``. Maidir le córais stórála nach bhfuil in ann méid an chomhaid a thabhairt ar ais, ardóidh sé seo `NotImplementederror``` ina ionad sin. #### `url(name)` Tugann sé an URL ar ais inar féidir teacht ar ábhar an chomhaid dá dtagraítear ```ainm ``. Maidir le córais stórála nach dtacaíonn le rochtain trí URL ardóidh sé seo ``NotImplementederror``` ina ionad sin. > **There are community-maintained solutions too!** > > Django has a vibrant ecosystem. There are storage backends > highlighted on the [Community Ecosystem](https://www.djangoproject.com/community/ecosystem/#storage-and-static-files) page. The Django Packages > [Storage Backends grid](https://djangopackages.org/grids/g/storage-backends/) has even more options for you!