{"title":"Conas rang stórála saincheaptha a scríobh","version":"6.1","locale":"ga","docname":"howto/custom-file-storage","url":"/ga/6.1/howto/custom-file-storage/","canonical":"https://djangodocs.dev/ga/6.1/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í…","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\">Django.Core.Files.Storage.Storage</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=\"nn\">django.core.files.storage</span> <span class=\"kn\">import</span> Storage\n\n\n<span class=\"k\">class</span> <span class=\"nc\">MyStorage</span><span class=\"p\">(</span>Storage<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\">django.conf.settings</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=\"nn\">django.conf</span> <span class=\"kn\">import</span> settings\n<span class=\"kn\">from</span> <span class=\"nn\">django.core.files.storage</span> <span class=\"kn\">import</span> Storage\n\n\n<span class=\"k\">class</span> <span class=\"nc\">MyStorage</span><span class=\"p\">(</span>Storage<span class=\"p\">):</span>\n    <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> option<span class=\"o\">=</span><span class=\"kc\">None</span><span class=\"p\">):</span>\n        <span class=\"k\">if</span> <span class=\"ow\">not</span> option<span class=\"p\">:</span>\n            option <span class=\"o\">=</span> settings<span class=\"o\">.</span>CUSTOM_STORAGE_OPTIONS\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\">_open()</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\">_save()</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>Caithfidh do rang stórála a bheith: ref: dífhoirmithe &lt;custom-deconstruct-method&gt;`ionas gur féidir é a shraitheadh nuair a úsáidtear é ar réimse in imirce. Chomh fada agus a bhíonn argóintí ag do réimse atá féin:ref: `serializable &lt;migration-serializing&gt;, is féidir leat an maisitheoir aicme <code class=\"docutils literal notranslate\">django.utils.deconstruct.deconstructible</code> a úsáid chuige seo (sin an rud a úsáideann Django ar 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.1/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\">Storage.delete()</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.1/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\">Storage.exists()</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.1/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\">Storage.listdir()</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.1/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\">Storage.size()</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ga/6.1/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\">Storage.url()</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\">_open</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">name</em>, <em class=\"sig-param\">mode<span class=\"o\">=</span><span class=\"default_value\">'rb'</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\">_save</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">name</em>, <em class=\"sig-param\">content</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\">Storage.save () ``. Beidh an ``ainm ``imithe cheana féin trí ``get_valid_name ()</code> agus <code class=\"docutils literal notranslate\">get_available_name () ``, agus is réad ``Comhad</code> féin a bheidh an <code class=\"docutils literal notranslate\">content</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\">get_valid_name</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">name</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\">name</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\">upload_to</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\">get_alternative_name</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">file_root</em>, <em class=\"sig-param\">file_ext</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\">file_ext</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\">get_available_name</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">name</em>, <em class=\"sig-param\">max_length<span class=\"o\">=</span><span class=\"default_value\">None</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\">ainm ``a chuirtear chuig an modh seo glan cheana féin chuig ainm comhaid atá bailí don chóras stórála, de réir an mhodha ``get_valid_name ()</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\">ainm ``ann cheana féin, tugtar ``get_alternative_name ()</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=\"nn\">django.core.files.storage</span> <span class=\"kn\">import</span> storages\n\nexample_storage <span class=\"o\">=</span> storages<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.1/howto/"}],"prev":{"docname":"howto/csrf","title":"Conas cosaint CSRF Django a úsáid","url":"/ga/6.1/howto/csrf/"},"next":{"docname":"howto/custom-management-commands","title":"Conas orduithe saincheaptha ``django-admin ``a chruthú","url":"/ga/6.1/howto/custom-management-commands/"},"formats":{"html":"/ga/6.1/howto/custom-file-storage/","markdown":"/ga/6.1/howto/custom-file-storage.md","json":"/ga/6.1/howto/custom-file-storage.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/howto/custom-file-storage.txt","official":"https://docs.djangoproject.com/ga/6.1/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"]}