{"title":"Conas rang stórála saincheaptha a scríobh","version":"6.0","locale":"ga","docname":"howto/custom-file-storage","url":"/ga/6.0/howto/custom-file-storage/","canonical":"https://djangodocs.dev/ga/6.0/howto/custom-file-storage/","summary":"Más gá duit stóráil comhaid saincheaptha a sholáthar - sampla coitianta ná comhaid a stóráil ar chóras iargúlta éigin - is féidir leat é sin a dhéanamh trí rang…","html":"<h1>Conas rang stórála saincheaptha a scríobh<a class=\"heading-anchor\" href=\"#how-to-write-a-custom-storage-class\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Más gá duit stóráil comhaid saincheaptha a sholáthar - sampla coitianta ná comhaid a stóráil ar chóras iargúlta éigin - is féidir leat é sin a dhéanamh trí rang stórála saincheaptha a shainiú. Beidh ort na céimeanna seo a leanúint:</p>\n<ol class=\"arabic\">\n<li><p>Caithfidh do chóras stórála saincheaptha a bheith ina fho-aicme de <code class=\"docutils literal notranslate\"><span class=\"pre\">Django.Core.Files.Storage.Storage</span></code>:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.core.files.storage</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">Storage</span>\n\n\n<span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">MyStorage</span><span class=\"p\">(</span><span class=\"n\">Storage</span><span class=\"p\">):</span> <span class=\"o\">...</span>\n</code></pre></div>\n</li>\n<li><p>Caithfidh Django a bheith in ann do chóras stórála a dhéanamh gan aon argóintí. Ciallaíonn sé seo gur chóir aon socruithe a thógáil ó <code class=\"docutils literal notranslate\"><span class=\"pre\">django.conf.settings</span></code>:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.conf</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">settings</span>\n<span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.core.files.storage</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">Storage</span>\n\n\n<span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">MyStorage</span><span class=\"p\">(</span><span class=\"n\">Storage</span><span class=\"p\">):</span>\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">option</span><span class=\"o\">=</span><span class=\"kc\">None</span><span class=\"p\">):</span>\n        <span class=\"k\">if</span> <span class=\"ow\">not</span> <span class=\"n\">option</span><span class=\"p\">:</span>\n            <span class=\"n\">option</span> <span class=\"o\">=</span> <span class=\"n\">settings</span><span class=\"o\">.</span><span class=\"n\">CUSTOM_STORAGE_OPTIONS</span>\n        <span class=\"o\">...</span>\n</code></pre></div>\n</li>\n<li><p>Your storage class must implement the <a class=\"reference internal\" href=\"#django.core.files.storage._open\" title=\"django.core.files.storage._open\"><code class=\"xref py py-meth docutils literal notranslate\"><span class=\"pre\">_open()</span></code></a> and <a class=\"reference internal\" href=\"#django.core.files.storage._save\" title=\"django.core.files.storage._save\"><code class=\"xref py py-meth docutils literal notranslate\"><span class=\"pre\">_save()</span></code></a>\nmethods, along with any other methods appropriate to your storage class. See\nbelow for more on these methods.</p>\n<p>Ina theannta sin, má sholáthraíonn do rang stóráil comhad áitiúil, caithfidh sé an modh <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>path () <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>a shárú.</p>\n</li>\n<li><p>Your storage class must be <a class=\"reference internal\" href=\"/ga/6.0/topics/migrations/#custom-deconstruct-method\"><span class=\"std std-ref\">deconstructible</span></a>  so it can be serialized when it's used on a\nfield in a migration. As long as your field has arguments that are\nthemselves <a class=\"reference internal\" href=\"/ga/6.0/topics/migrations/#migration-serializing\"><span class=\"std std-ref\">serializable</span></a>, you can use the\n<code class=\"docutils literal notranslate\"><span class=\"pre\">django.utils.deconstruct.deconstructible</span></code> class decorator for this\n(that's what Django uses on FileSystemStorage).</p></li>\n</ol>\n<p>De réir réamhshocraithe, ardaíonn na modhanna seo a leanas NotImplementederror` agus is gnách go gcaithfear iad a shárú:</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/ga/6.0/ref/files/storage/#django.core.files.storage.Storage.delete\" title=\"django.core.files.storage.Storage.delete\"><code class=\"xref py py-meth docutils literal notranslate\"><span class=\"pre\">Storage.delete()</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.0/ref/files/storage/#django.core.files.storage.Storage.exists\" title=\"django.core.files.storage.Storage.exists\"><code class=\"xref py py-meth docutils literal notranslate\"><span class=\"pre\">Storage.exists()</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.0/ref/files/storage/#django.core.files.storage.Storage.listdir\" title=\"django.core.files.storage.Storage.listdir\"><code class=\"xref py py-meth docutils literal notranslate\"><span class=\"pre\">Storage.listdir()</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.0/ref/files/storage/#django.core.files.storage.Storage.size\" title=\"django.core.files.storage.Storage.size\"><code class=\"xref py py-meth docutils literal notranslate\"><span class=\"pre\">Storage.size()</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.0/ref/files/storage/#django.core.files.storage.Storage.url\" title=\"django.core.files.storage.Storage.url\"><code class=\"xref py py-meth docutils literal notranslate\"><span class=\"pre\">Storage.url()</span></code></a></p></li>\n</ul>\n<p>Tabhair faoi deara, áfach, nach bhfuil na modhanna seo uile ag teastáil agus gur féidir iad a fhágáil d'aon ghnó. Mar a tharlaíonn sé, is féidir gach modh a fhágáil gan cur i bhfeidhm agus Stóráil oibre a bheith agat fós.</p>\n<p>Mar shampla, má bhíonn sé daor ábhar cúltaca stórála áirithe a liostáil, b'fhéidir go gcinneann tú gan <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>Storage.listDir () <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>a chur i bhfeidhm.</p>\n<p>Sampla eile ba ea cúltaca nach láimhseálann ach scríbhneoireacht chuig comhaid. Sa chás seo, ní bheadh ort aon cheann de na modhanna thuas a chur i bhfeidhm.</p>\n<p>I ndeireadh na dála, is fútsa atá cé acu de na modhanna seo a chuirtear i bhfeidhm. Beidh comhéadan páirteach (briste b'fhéidir) mar thoradh ar roinnt modhanna gan cur i bhfeidhm.</p>\n<p>De ghnáth beidh tú ag iarraidh crúcaí a úsáid atá deartha go sonrach le haghaidh rudaí stórála saincheaptha Seo iad seo:</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.files.storage._open\">\n<span class=\"sig-name descname\"><span class=\"pre\">_open</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">name</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">mode</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">'rb'</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.files.storage._open\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p><strong>Riachtanáil</strong>.</p>\n<p>Tugtar air ag <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>Storage.open () <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>, is é seo an meicníocht iarbhír a úsáideann an rang stórála chun an comhad a oscailt. Caithfidh sé seo réad <a href=\"#id5\"><span class=\"problematic\" id=\"id6\">``</span></a>Comhad <a href=\"#id7\"><span class=\"problematic\" id=\"id8\">``</span></a>a thabhairt ar ais, cé i bhformhór na gcásanna, beidh tú ag iarraidh roinnt fo-aicme a thabhairt ar ais anseo a chuireann loighic go sonrach don chóras stórála cúltaca i bhfeidhm. Ba chóir an eisceacht: EXC: FileNotFoundError a ardú nuair nach bhfuil comhad ann.</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.files.storage._save\">\n<span class=\"sig-name descname\"><span class=\"pre\">_save</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">name</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">content</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.files.storage._save\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Glaoigh <code class=\"docutils literal notranslate\"><span class=\"pre\">Storage.save</span> <span class=\"pre\">()</span> <span class=\"pre\">``.</span> <span class=\"pre\">Beidh</span> <span class=\"pre\">an</span> <span class=\"pre\">``ainm</span> <span class=\"pre\">``imithe</span> <span class=\"pre\">cheana</span> <span class=\"pre\">féin</span> <span class=\"pre\">trí</span> <span class=\"pre\">``get_valid_name</span> <span class=\"pre\">()</span></code> agus <code class=\"docutils literal notranslate\"><span class=\"pre\">get_available_name</span> <span class=\"pre\">()</span> <span class=\"pre\">``,</span> <span class=\"pre\">agus</span> <span class=\"pre\">is</span> <span class=\"pre\">réad</span> <span class=\"pre\">``Comhad</span></code> féin a bheidh an <code class=\"docutils literal notranslate\"><span class=\"pre\">content</span></code>.</p>\n<p>Ba chóir ainm iarbhír an chomhaid a shábháiltear a thabhairt ar ais (de ghnáth an <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>ainm <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>a chuirtear isteach, ach más gá don stóráil ainm an chomhaid a athrú, cuir an t-ainm nua ar ais ina ionad).</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.files.storage.get_valid_name\">\n<span class=\"sig-name descname\"><span class=\"pre\">get_valid_name</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">name</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.files.storage.get_valid_name\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Filleann sé ainm comhaid atá oiriúnach le húsáid leis an gcóras stórála bunúsach. Is é an argóint <code class=\"docutils literal notranslate\"><span class=\"pre\">name</span></code> a cuireadh ar aghaidh chuig an modh seo ná an bunainm comhaid a seoladh chuig an bhfreastalaí nó, má tá <code class=\"docutils literal notranslate\"><span class=\"pre\">upload_to</span></code> inghlaoite, cuirtear ainm an chomhaid ar ais ar an modh sin tar éis aon fhaisnéis cosán a bhaint. Sáraigh é seo chun an chaoi a dtiontaítear carachtair neamhchaighdeánacha go comhadainmneacha sábháilte a shaincheapadh.</p>\n<p>Ní choimeádann an cód a chuirtear ar <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>Stóráil <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>ach carachtair, tréimhsí agus béim alfa-uimhriúla ón ainm comhaid bunaidh, ag baint gach rud eile.</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.files.storage.get_alternative_name\">\n<span class=\"sig-name descname\"><span class=\"pre\">get_alternative_name</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">file_root</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">file_ext</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.files.storage.get_alternative_name\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Tugann ainm comhaid malartach ar ais bunaithe ar na paraiméadair file_root` agus <code class=\"docutils literal notranslate\"><span class=\"pre\">file_ext</span></code>. De réir réamhshocraithe, cuirtear béim móide sreang alfauméireach randamach 7 charachtar leis an ainm comhaid roimh an síneadh.</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.core.files.storage.get_available_name\">\n<span class=\"sig-name descname\"><span class=\"pre\">get_available_name</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">name</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">max_length</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">None</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.core.files.storage.get_available_name\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Filleann ainm comhaid atá ar fáil sa mheicníocht stórála, agus b'fhéidir ag cur an ainm comhaid a chuirtear ar fáil san áireamh. Beidh an argóint <code class=\"docutils literal notranslate\"><span class=\"pre\">ainm</span> <span class=\"pre\">``a</span> <span class=\"pre\">chuirtear</span> <span class=\"pre\">chuig</span> <span class=\"pre\">an</span> <span class=\"pre\">modh</span> <span class=\"pre\">seo</span> <span class=\"pre\">glan</span> <span class=\"pre\">cheana</span> <span class=\"pre\">féin</span> <span class=\"pre\">chuig</span> <span class=\"pre\">ainm</span> <span class=\"pre\">comhaid</span> <span class=\"pre\">atá</span> <span class=\"pre\">bailí</span> <span class=\"pre\">don</span> <span class=\"pre\">chóras</span> <span class=\"pre\">stórála,</span> <span class=\"pre\">de</span> <span class=\"pre\">réir</span> <span class=\"pre\">an</span> <span class=\"pre\">mhodha</span> <span class=\"pre\">``get_valid_name</span> <span class=\"pre\">()</span></code> a thuairiscítear thuas.</p>\n<p>Ní rachaidh fad an ainm comhaid thar <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>max_length <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>, má chuirtear ar fáil. &lt;django.core.exceptions.SuspiciousOperation&gt;Mura féidir ainm comhaid uathúil saor in aisce a fháil, ardaítear eisceacht a: exc: <a href=\"#id5\"><span class=\"problematic\" id=\"id6\">`</span></a>SuspiciousFileOperation <a href=\"#id7\"><span class=\"problematic\" id=\"id8\">`</span></a>.</p>\n<p>Má tá comhad le <code class=\"docutils literal notranslate\"><span class=\"pre\">ainm</span> <span class=\"pre\">``ann</span> <span class=\"pre\">cheana</span> <span class=\"pre\">féin,</span> <span class=\"pre\">tugtar</span> <span class=\"pre\">``get_alternative_name</span> <span class=\"pre\">()</span></code> chun ainm malartach a fháil.</p>\n<section id=\"use-your-custom-storage-engine\">\n<span id=\"using-custom-storage-engine\"></span><h2>Úsáid d'inneall stórála saincheaptha<a class=\"heading-anchor\" href=\"#use-your-custom-storage-engine\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Is é an chéad chéim chun do stóráil saincheaptha a úsáid le Django ná insint do Django faoin gcúltaca stórála comhaid a bheidh á úsáid agat. Déantar é seo ag baint úsáide as an socrú:setting: STORAGES. Déanann an socrú seo mapáil ainmneacha stórála, ar bealach iad chun tagairt a dhéanamh do stóráil ar leith ar fud Django, chuig foclóir socruithe don chúlcheann stórála sonrach sin. Déantar cur síos iomlán ar na socruithe sna foclóirí istigh sa doiciméadach:setting: STORAGES.</p>\n<p>Ansin déantar rochtain ar stórálaí ag ainm ón bhfoclóir:data: django.core.files.storage.storages:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.core.files.storage</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">storages</span>\n\n<span class=\"n\">example_storage</span> <span class=\"o\">=</span> <span class=\"n\">storages</span><span class=\"p\">[</span><span class=\"s2\">&quot;example&quot;</span><span class=\"p\">]</span>\n</code></pre></div>\n</section>","rootId":"how-to-write-a-custom-storage-class","toc":[{"title":"Úsáid d'inneall stórála saincheaptha","anchor":"use-your-custom-storage-engine","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/6.0/howto/"}],"prev":{"docname":"howto/csrf","title":"Conas cosaint CSRF Django a úsáid","url":"/ga/6.0/howto/csrf/"},"next":{"docname":"howto/custom-management-commands","title":"Conas orduithe saincheaptha ``django-admin ``a chruthú","url":"/ga/6.0/howto/custom-management-commands/"},"formats":{"html":"/ga/6.0/howto/custom-file-storage/","markdown":"/ga/6.0/howto/custom-file-storage.md","json":"/ga/6.0/howto/custom-file-storage.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/custom-file-storage.txt","official":"https://docs.djangoproject.com/ga/6.0/howto/custom-file-storage/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}