API stórála comhadLink to this heading#

An rang stórála réamhshocraithe a fháilLink to this heading#

Soláthraíonn Django bealaí áisiúla chun teacht ar an rang stórála réamhshocraithe

storagesLink to this definition#

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

Python console

>>> 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 DefaultStorageLink to this definition#

DefaultStorage provides lazy access to the default storage system as defined by default key in STORAGES. DefaultStorage uses storages internally.

default_storageLink to this definition#

default_storage is an instance of the DefaultStorage.

An rang FilesystemStorageLink to this heading#

class FileSystemStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None, allow_overwrite=False)Link to this definition#

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.

locationLink to this definition#

Conair iomlán chuig an eolaire a shealbhóidh na comhaid. Réamhshocraithe ar luach do shuíomh: socrú: MEDIA_ROOT.

base_urlLink to this definition#

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_modeLink to this definition#

Ceadanna an chórais chomhaid a gheobhaidh an comhad nuair a shábháiltear é. Réamhshocraithe chuig: socrú: FILE_UPLOAD_PERMISSIONS.

directory_permissions_modeLink to this definition#

Ceadanna an chórais chomhaid a gheobhaidh an eolaire nuair a shábháiltear é. Réamhshocraithe chuig: socrú: FILE_UPLOAD_DIRECTORY_PERMISSIONS.

allow_overwriteLink to this definition#

Bratach chun rialú a ligeann comhad nua a shábháil thar ceann atá ann cheana. Réamhshocraithe go False.

get_created_time(name)Link to this definition#

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 InmemoryStorageLink to this heading#

class InMemoryStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None)Link to this definition#

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.

locationLink to this definition#

Conair iomlán chuig ainm an eolaire a shanntar do chomhaid. Réamhshocraithe ar luach do shuíomh: socrú: MEDIA_ROOT.

base_urlLink to this definition#

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_modeLink to this definition#

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_modeLink to this definition#

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álaLink to this heading#

class StorageLink to this definition#

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á.

delete(name)Link to this definition#

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)Link to this definition#

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)Link to this definition#

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)Link to this definition#

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)Link to this definition#

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. <django.core.exceptions.SuspiciousOperation>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)Link to this definition#

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)Link to this definition#

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)Link to this definition#

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)Link to this definition#

Validates the filename by calling get_valid_name and returns a filename to be passed to the save() method.

The filename argument may include a path as returned by FileField.upload_to. In that case, the path won't be passed to 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)Link to this definition#

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')Link to this definition#

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)Link to this definition#

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)Link to this definition#

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)Link to this definition#

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)Link to this definition#

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.