---
title: "Socruithe"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/ref/settings/
canonical: https://djangodocs.dev/ga/5.2/ref/settings/
---
# Socruithe

- [Socruithe lárnacha](#core-settings)
- [Authas](#auth)
- [Teachtaireachtaí](#messages)
- [Seisiúin](#sessions)
- [Suíomhanna](#sites)
- [Comhaid Statach](#static-files)
- [Innéacs Áiritheach na Socruithe](#core-settings-topical-index)

> **Warning**
>
> Bí cúramach nuair a sháraigh tú socruithe, go háirithe nuair is liosta nó foclóir neamh-folamh é an luach réamhshocraithe, mar shampla:setting: STATICFILES\_FINDERS. Déan cinnte go gcoinníonn tú na comhpháirteanna a theastaíonn ó ghnéithe Django is mian leat a úsáid.

## Socruithe lárnacha

Seo liosta de na socruithe atá ar fáil i gcroí Django agus a luachanna réamhshocraithe. Tá socruithe a sholáthraíonn aipeanna contrib liostaithe thíos, agus innéacs tráthúil de na croí-shocruithe ina dhiaidh sin. Le haghaidh ábhar tosaigh, féach an:doc: treoir ábhair socruithe \</topics/settings\>.

### `URL_ABSOLUTE_OVERRIDES`

Réamhshocraithe: `{}` (Foclóir folamh)

Tá foclóir ag mapáil `"app_label.model_name"` teaghrán chuig feidhmeanna a thógann réad samhail agus a chuireann a URL ar ais. Is bealach é seo chun modhanna get\_absolute\_url () a chur isteach nó a shárú ar bhonn in aghaidh an tsuiteála. Sampla:

```
ABSOLUTE_URL_OVERRIDES = {
    "blogs.blog": lambda o: "/blogs/%s/" % o.slug,
    "news.story": lambda o: "/stories/%s/%s/" % (o.pub_year, o.slug),
}
```

Ba chóir go mbeadh an t-ainm samhail a úsáidtear sa suíomh seo go léir líon beag, beag beann ar chás ainm aicme iarbhír an tsamhail.

### RIARACHÁIN \`\`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta de na daoine go léir a fhaigheann fógraí earráide cód. Nuair: Setting: debug = false \<DEBUG\>\`agus:class: \`~django.utils.log.adminEmailHandler cumraithe in:setting: LOGGING (déanta de réir réamhshocraithe), ríomhphostálann Django na sonraí eisceachtaí a ardaíodh sa timthriall iarrata/freagartha do na daoine seo.

Ba chóir go mbeadh gach mír sa liosta ina tuple de (Ainm iomlán, seoladh ríomhphoist). Sampla:

```
[("John", "john@example.com"), ("Mary", "mary@example.com")]
```

### `ÓSTÁLACHA CEADAITHEAD`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta de na teaghráin a léiríonn na hainmneacha óstaí/fearainn ar féidir leis an suíomh Django seo freastal orthu. Is beart slándála é seo chun cosc a choisc:ref: Ionsaithe ceanntásc Óstach HTTP \<host-headers-virtual-hosting\>, atá indéanta fiú faoi go leor cumraíochtaí freastalaí gréasáin atá cosúil go bhfuil siad sábháilte.

Is féidir le luachanna sa liosta seo a bheith ina ainmneacha láncháilithe (m.sh. `` `www.example.com' ``), agus sa chás sin déanfar iad a mheaitseáil i gcoinne ceannteideal ```Óst` an iarratais go díreach (cás-neamh-íogair, gan calafort san áireamh). Is féidir luach a thosaíonn le tréimhse a úsáid mar fho-chárta fiáin: meaitneoidh ``'.example.com'``` `example.com`, www.example.com\`, agus aon fho-fhearann eile de example.com\`. Meaitneoidh luach `*'` rud ar bith; sa chás seo tá tú freagrach as do bhailíochtú féin a sholáthar ar an gceannteideal `Host` (b'fhéidir i lár- earraí; más amhlaidh ní mór an middleware seo a liostú ar dtús in:setting: MIDDLEWARE).

Ceadaíonn Django freisin ainm fearainn láncháilithe (FQDN) \`\_ d'aon iontrálacha. Cuimsíonn roinnt brabhsálaithe ponc críochnaitheach sa cheanntásc \`\`Óst a stiallann Django agus bailíochtú óstach á ndéanamh.

Mura n-oireann an ceannteideal `Host` (nó `X-Forwarded-Host` más:setting: USE\_X\_FORWARDED\_HOST cumasaithe) aon luach ar an liosta seo, ardóidh an modh:meth: Django.http.httpRequest.get\_host () : exc: ~Django.core.exceptions.suspiciousoperation:exc: ~Django.core.exceptions.suspicoUsoperations.SuspiciousOperations.”.

Nuair a bhíonn: Setting: DEBUG `True` agus `ALLOWED_HOSTS` folamh, bailítear an t-óstach i gcoinne `['.localhost', '127.0.0.1', '[::1]']`.

\<topics-testing-advanced-multiple-hosts\>Tá `ALLOWED_HOSTS` freis:ref: seiceáilte agus tástálacha á reáchtáil .

Ní bhaineann an bailíochtú seo ach via: meth: ~django.http.httpRequest.get\_host () \`; má rochtaíonn do chód ar an gceannteideal \`\`Host\` go díreach ó `Request.Meta` tá tú ag seachaint an chosaint slándála seo.

### `APPEND_SLASH`

Réamhshocraithe: Fíor\`

Nuair a bheidh sé socraithe go True\`, mura n-oireann URL an iarratais aon cheann de na patrúin san URLConf agus mura gcríochnaíonn sé i slash, eisítear atreorú HTTP chuig an URL céanna le slash curtha leis. Tabhair faoi deara gur féidir leis an atreorú a bheith ina chúis le haon sonraí a chuirtear isteach in iarratas POST a chailleadh

Ní úsáidtear an socrú: Setting: APPEND\_SLASH ach má tá: class: ~django.middleware.common.commonMiddleware suiteáilte (féach: doc: /topics/http/middleware). Féach freis:socrú: PREPEND\_WWW.

### `CÁIS`

Réamhshocraithe:

```
{
    "default": {
        "BACKEND": "django.core.cache.backends.locmem.LocMemCache",
    }
}
```

Foclóir ina bhfuil na socruithe do gach taisce le húsáid le Django. Is foclóir neadaithe é a léarscálann a n-ábhar ainmneacha taisce chuig foclóir ina bhfuil na roghanna le haghaidh taisce aonair.

Ní mór don socrú: Socrú: CACHES taisce `réamhshocraithe` a chumrú; féadfar aon líon taisce breise a shonrú freisin. Má tá cúltaca taisce á úsáid agat seachas an taisce cuimhne áitiúil, nó má theastaíonn uait iolracha a shainiú, beidh roghanna eile ag teastáil. Tá na roghanna taisce seo a leanas ar fáil.

#### `` `CÚLT ``

Réamhshocraithe: "(Sreang folamh)

An cúltaca taisce le húsáid. Is iad na cúltaca taisce ionsuite:

- `` `Django.Core.Cache.Backends.db.DatabaseCache' ``
- `'Django.Core.Cache.Backends.Dummy.DummyCache'`
- `` `Django.Core.Cache.Backends.FileBased.FileBasedCache' ``
- `` `Django.Core.Cache.Backends.Locmem.LocMemCache' ``
- `'Django.Core.Cache.Backends.Memcached.PymemCacheCache'`
- `'Django.Core.Cache.Backends.memcached.pylibmccache'`
- `'Django.Core.Cache.Backends.Redis.RedisCache'`

Is féidir leat cúltaca taisce nach seolann le Django a úsáid trí shocrú: BACKEND \`chuig cosán láncháilithe \<CACHES-BACKEND\>de rang cúltaca taisce (ie \`\`MyPackage.Backends.whatever.whateverCache\`).

#### `EOCHAIRFHEIDHME`

Sreang ina bhfuil cosán poncanach chuig feidhm (nó aon ghlaoch) a shainmhíníonn conas réimír, leagan agus eochair a chumadh isteach i eochair taisce deiridh. Tá an cur i bhfeidhm réamhshocraithe comhionann leis an bhfeidhm:

```
def make_key(key, key_prefix, version):
    return ":".join([key_prefix, str(version), key])
```

Féadfaidh tú aon phríomhfheidhm a theastaíonn uait a úsáid, fad is atá an síniú argóint céanna aige.

Féach na:ref: cáipéisíocht taiscéala \<cache\_key\_transformation\>\`le haghaidh tuilleadh faisnéise.

#### `EOCHAIR_RÉAMH`

Réamhshocraithe: "(Sreang folamh)

Sreang a chuirfear san áireamh go huathoibríoch (réamhshocraithe de réir réamhshocraithe) chuig gach eochair taisce a úsáideann an freastalaí Django.

Féach na:ref: cáipéisíocht taiscéala \<cache\_key\_prefixing\>\`le haghaidh tuilleadh faisnéise.

#### `SUÍOMH`

Réamhshocraithe: "(Sreang folamh)

Suíomh an taisce le húsáid. D'fhéadfadh gurb é seo an eolaire do taisce chórais chomhaid, óstach agus calafort do fhreastalaí memcache, nó ainm aitheantais do taisce cuimhne áitiúil. m.sh.:

```
CACHES = {
    "default": {
        "BACKEND": "django.core.cache.backends.filebased.FileBasedCache",
        "LOCATION": "/var/tmp/django_cache",
    }
}
```

#### `ROGHANNAÍ`

Réamhshocraithe: Níl \`\`

Paraiméadair bhreise le dul chuig an gcúltaca taisce. Athraíonn paraiméadair atá ar fáil ag brath ar do chúltaca taisce.

\<cache\_arguments\>Is féidir roinnt faisnéise faoi pharaiméadair atá ar fáil a fháil sa doiciméadúiséireacht: ref: cache argóintí . Le haghaidh tuilleadh faisnéise, téigh i gcomhairle le cáipéisíocht do mhodúl cúlt

#### `TIMEOUT`

Réamhshocraithe: 300\`

Meastar go bhfuil líon na soicind roimh iontráil taisce seasmhach. Más luach an socraithe seo `None`, ní rachaidh iontrálacha taisce in éag. Fágann luach `0` go rachaidh eochracha in éag láithreach (go héifeachtach “ná taisceáil”).

#### `LEAGAN`

Réamhshocraithe: `1`

An uimhir leagan réamhshocraithe d'eochracha taisce a ghineann an freastalaí Django.

Féach na:ref: cáipéisíocht taiscéala \<cache\_versioning\>\`le haghaidh tuilleadh faisnéise.

### `CACHE_MIDDLEWARE_ALIAS`

Réamhshocraithe: `'default'`

\<the-per-site-cache\>An nasc taisce le húsáid don: ref: cache middleware .

### `CACHE_MIDDLEWARE_KEY_PREFIX`

Réamhshocraithe: "(Sreang folamh)

\<the-per-site-cache\>Sreang a bheidh réamhshocraithe leis na heochracha taisce a ghineann an: ref: cache middleware \`. Comhcheanglaítear an réimír seo leis an socrú: setting: \`KEY\_PREFIX \<CACHES-KEY\_PREFIX\>; ní chuireann sé in ionad é.

Féach: doc: /topics/cache.

### `CACHE_MIDDLEWARE_SOICIND`

Réamhshocraithe: 600\`

\<the-per-site-cache\>An líon iomláir réamhshocraithe soicind chun leathanach a thaisceadh don: ref: cache middleware .

Féach: doc: /topics/cache.

### `CSRF_COOKIE_AOS`

Réamhshocraithe: `31449600` (thart ar 1 bhliain, i soicindí)

Aois fianáin CSRF, i soicindí.

Is é an chúis le am éaga fadtréimhse a shocrú fadhbanna a sheachaint i gcás úsáideoir ag dúnadh brabhsálaí nó leathanach a leabharmharcáil agus ansin an leathanach sin a luchtú ó taisce brabhsálaí. Gan fianáin leanúnacha, theipfeadh ar an aighneacht foirme sa chás seo.

Féadann roinnt brabhsálaithe (go sonrach Internet Explorer) fianáin leanúnacha a úsáid nó féadfaidh siad na hinnéacsanna don phróca fianán a bheith truaillithe ar dhiosca, rud a fhágann go dteipfidh seiceálacha cosanta CSRF (uaireanta go tréimhseach). Athraigh an socrú seo go None chun fianáin CSRF bunaithe ar sheisiún a úsáid, a choinníonn na fianáin i gcuimhne seachas ar stóráil leanúnach.

### `CSRF_COOKIE_DOMAIN`

Réamhshocraithe: Níl \`\`

An fearann atá le húsáid agus an fianán CSRF á shocrú. Is féidir leis seo a bheith úsáideach chun ligean go héasca iarratais thrasfho-fhearann a eisiamh ón ngnáthchosaint bréifneach iarratais thrasláithreáin. Ba chóir é a shocrú ar shreang mar `” .example.com"` chun ligean d'iarratas POST ó fhoirm ar fhoirm ar fhoirm amháin glacadh le dearcadh a sheirbheáiltear ó fho-fhearann eile.

\<csrf-limitations\>Tabhair faoi deara le do thoil nach dtugann láithreacht an socrú seo le tuiscint go bhfuil cosaint CSRF Django sábháilte ó ionsaithe tras-fho-fearainn de réir réamhshocraithe - féach an ranna:ref: Teorainneacha CSRF .

### `CSRF_COOKIE_HTTPONLY`

Réamhshocraithe: `Fréag`

Cibé an bhratach HttpOnly a úsáid ar an bhfianán CSRF. Má tá sé seo socraithe ar `True`, ní bheidh JavaScript taobh an chliaint in ann rochtain a fháil ar an bhfianán CSRF.

Ní thugann an fianán CSRF a ainmniú mar HttpOnly aon chosaint phraiticiúil toisc nach bhfuil CSRF ach chun cosaint a dhéanamh ar ionsaithe tras-fearainn. Más féidir le hionsaitheoir an fianán a léamh trí JavaScript, tá siad ar an bhfearann céanna cheana féin chomh fada agus is eol don bhrabhsálaí, ionas gur féidir leo aon rud is mian leo a dhéanamh ar aon nós. (Is poll i bhfad níos mó é XSS ná CSRF.)

Cé nach dtugann an suíomh mórán sochair phraiticiúil, uaireanta teastaíonn iniúchóirí slándála é

\<acquiring-csrf-token-from-cookie\>Má chumasaíonn tú é seo agus má theastaíonn uait luach an chomhartha CSRF a sheoladh le hiarratas AJAX, ní mór do JavaScript an luach:ref: ó ionchur foirm chomhartha CSRF i bhfolach \`in \<acquiring-csrf-token-from-html\>ionad:ref: \`ón bhfianán a tharraingt.

Féach: SETTING: SESSION\_COOKIE\_HTTPONLY le haghaidh sonraí ar HTTPONLY\`.

### `` `AINM_CSRF_COOKIE ``

Réamhshocraithe: `'csrftoken'`

Ainm na fianáin le húsáid le haghaidh comhartha fíordheimhnithe CSRF. Is féidir leis seo a bheith cibé rud is mian leat (fad is atá sé difriúil ó na hainmneacha fianán eile i d'iarratas). Féach: doc: /ref/csrf.

### `CSRF_COOKIE_PATH`

Réamhshocraithe: `'/'`

An cosán atá leagtha síos ar an bhfianán CSRF. Ba chóir go mbeadh sé seo comhoiriúnach le cosán URL do shuiteála Django nó a bheith ina thuismitheoir ar an gcosán sin.

Tá sé seo úsáideach má tá cásanna iolracha Django agat ag rith faoin ainm óstach céanna. Is féidir leo cosáin éagsúla fianán a úsáid, agus ní fheicfidh gach cás ach a fhianán CSRF féin.

### `CSRF_COOKIE_SAMESITE`

Réamhshocraithe: `'Lax'`

Luach an bhratach [SameSite](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value) ar an bhfianán CSRF. Cuireann an bratach seo cosc ar an bhfianán a sheoladh in iarratais tras-láithreáin.

Féach:SETTING: SESSION\_COOKIE\_SAMESITE le haghaidh sonraí faoi Samesite\`.

### `CSRF_COOKIE_SECURE`

Réamhshocraithe: `Fréag`

Cibé acu fianán slán a úsáid don fhianán CSRF. Má tá sé seo socraithe ar `True`, marcálfar an fianán mar “slán”, rud a chiallaíonn go bhféadfadh brabhsálaithe a chinntiú nach seoltar an fianán ach le nasc HTTPS.

### `SEISIÚINT_ÚSÁID_CSRF`

Réamhshocraithe: `Fréag`

Cibé acu an comhartha CSRF a stóráil i seisiún an úsáideora in ionad i bhfianán. Éilíonn sé úsáid:mod: django.contrib.sesions.

Tá an comhartha CSRF a stóráil i bhfianán (réamhshocrú Django) sábháilte, ach is cleachtas coitianta é a stóráil sa seisiún i gcreataí gréasáin eile agus dá bhrí sin éilíonn iniúchóirí slándála uaireanta.

Ós rud é go dteastaíonn comhartha \<error-views\>CSRF uir:ref: réamhshocraithe earráidí \`, :class: \`~django.contrib.sessions.middleware.sessionMiddleware le feiceáil in:setting: MIDDLEWARE roimh aon middleware a d'fhéadfadh eisceacht a ardú chun amharc earráide a spreagadh (mar shampla:exc: ~django.core.exceptions.perdenied) má tá tú ag baint úsáide as `CSRF_USE_SESSIONS`. Féach: ref: middleware-ording.

### `CSRF_FAILURE_VIEW`

Réamhshocraithe: `'django.views.csrf.csrf_failure'`

Conair poncaí chuig an bhfeidhm amharc atá le húsáid nuair a dhiúltaítear iarratas isteach ag na:doc: Cosaint CSRF \</ref/csrf\>. Ba chóir go mbeadh an síniú seo ag an bhfeidhm:

```
def csrf_failure(request, reason=""): ...
```

i gcás gur teachtaireacht ghearr (atá beartaithe d'fhorbróirí nó logála, ní d'úsáideoirí deiridh) a léiríonn an chúis a dhiúltaíodh don iarratas. Ba chóir dó filleadh an:class: ~django.http.httpResponseForbidden.

Glacann ```django.views.csrf.csrf_failure () ``le paraiméadar breise ``template_name``` atá réamhshocraithe go `403_csrf.html'`. Má tá teimpléad leis an ainm sin ann, úsáidfear é chun an leathanach a rinneadh.

### `` `CSRF_HEADER_AINM ``

Réamhshocraithe: `'HTTP_X_CSRFTOKEN'`

Ainm an cheanntásc iarratais a úsáidtear le haghaidh fíordheimhniú CSRF.

Mar is amhlaidh le ceannteidil HTTP eile i Request.meta\`, normalaítear an t-ainm ceannteidil a fhaightear ón bhfreastalaí trí gach carachtar a thiontú go uachtarchlóir, aon bhriseanna a chur in ionad béim, agus réimír ```'HTTP_'` a chur leis an ainm. Mar shampla, má sheolann do chliant ceannteideal ``'X-XSRF-TOKEN'```, ba chóir go mbeadh an socrú HTTP\_X\_XSRF\_TOKEN'.

### `CSRF_TRUSTED_ORIGINS`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta de bhunús iontaofa le haghaidh iarratais neamhshábháilte (m.sh. POST \`).

Maidir le hiarratais ina n-áirítear an ceannteideal Bunaidh , éilíonn cosaint CSRF Django go n-oireann an ceannteideal an tionscnamh atá i láthair sa cheannteideal Óst\`.

Maidir le hiar \<django.http.HttpRequest.is\_secure\>ratas neamhshábháilte a:meth: slán \`nach n-áirítear an ceannteideal \`\`Bunaidh \`, ní mór ceannteideal `Referer` a bheith ag an iarraidh a mheaitseálann leis an mbunús atá i láthair sa cheannteideal Óst\`.

Cuireann na seiceálacha seo cosc, mar shampla, ar iarratas ```POST ``ó `subdomain.example.com``` go n-éireoidh leo i gcoinne api.example.com\`. Má theastaíonn iarratais neamhshábháilte tras-bhunús uait, ag leanúint leis an sampla, cuir <https://subdomain.example.com> 'leis an liosta seo (agus/nó <http://>... má thagann iarratais ó leathanach neamhchinnte).

Tacaíonn an socrú le fo-fhearann freisin, ionas gur féidir leat ```'https://*.example.com '``a chur leis, mar shampla, chun rochtain a cheadú ó gach fo-fhearann de `example.com```.

### `BUNACHAIR SONRAÍ`

Réamhshocraithe: `{}` (Foclóir folamh)

Foclóir ina bhfuil na socruithe do gach bunachar sonraí le húsáid le Django. Is foclóir neadaithe é a léarscáil a n-ábhar ailias bunachar sonraí go foclóir ina bhfuil na roghanna do bhunachar sonraí aonair.

Ní mór don socrú: “BUNACHAR SONRAÍ” bunachar sonraí “réamhshocraithe” a chumrú; féadfar aon líon bunachar sonraí breise a shonrú freisin.

Is é an comhad socruithe is simplí is féidir le socrú bunachar sonraí aonair ag baint úsáide as SQLite. Is féidir é seo a chumrú trí na rudaí seo a leanas a úsáid:

```
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": "mydatabase",
    }
}
```

Agus tú ag nascadh le cúltaca bunachar sonraí eile, mar shampla MariaDB, MySQL, Oracle, nó PostgreSQL, beidh paraiméadair nasc breise ag teastáil. Féach an socrú:setting: ENGINE \<DATABASE-ENGINE\>\`thíos maidir le conas cineálacha eile bunachar sonraí a shonrú. Tá an sampla seo le haghaidh PostgreSQL:

```
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "NAME": "mydatabase",
        "USER": "mydatabaseuser",
        "PASSWORD": "mypassword",
        "HOST": "127.0.0.1",
        "PORT": "5432",
    }
}
```

Tá na roghanna istigh seo a leanas a d'fhéadfadh a bheith ag teastáil le haghaidh cumraíochtaí níos casta ar fáil:

#### `IARRATAITHE_ATOMIC`

Réamhshocraithe: `Fréag`

Socraigh é seo go `True` chun gach radharc a fhilleadh in idirbheart ar an mbunachar sonraí seo. Féach:ref: tiing-idirbheartaí-go-http-iarrataireachtaí .

#### `AUTOCOMIT`

Réamhshocraithe: Fíor\`

\<deactivate-transaction-management\>Socraigh é seo go False\` más mian leat: ref: bainistíocht idirbheart Django a dhíchumasú agus cuir tú féin i bhfeidhm.

#### `INNEAL`

Réamhshocraithe: "(Sreang folamh)

An cúltaca bunachar sonraí le húsáid. Is iad na cúltaca bunachar sonraí ionsuite:

- `'django.db.backends.postgresql'`
- `'django.db.backends.mysql'`
- `'django.db.backends.sqlite3'`
- `'django.db.backends.oracle'`

Is féidir leat cúltaca bunachar sonraí a úsáid nach seolann le Django trí “ENGINE” a shocrú go cosán láncháilithe (ie `mypackage.backends.whatever`).

#### `ÓSTACH`

Réamhshocraithe: "(Sreang folamh)

Cén óstach le húsáid agus tú ag nascadh leis an mbunachar sonraí. Ciallaíonn sreang folamh localhost. Ní úsáidtear le SQLite.

Má thosaíonn an luach seo le slash ar aghaidh ('/') agus má tá MySQL á úsáid agat, ceanglóidh MySQL trí soicéad Unix leis an soicéad sonraithe. Mar shampla:

```
"HOST": "/var/run/mysql"
```

Má tá MySQL á úsáid agat agus nach dtosaíonn an luach seo\* le slach ar aghaidh, glactar leis gurb é an luach seo an t-óstach.

Má tá PostgreSQL á úsáid agat, de réir réamhshocraithe (folam:setting: HOST), déantar an nasc leis an mbunachar sonraí trí soicéid fearainn UNIX (línte 'áitiúla' i pg\_hba.conf\`). Mura bhfuil do soicéad fearainn UNIX sa suíomh caighdeánach, bain úsáid as an luach céanna de ```unix_socket_directory ``ó `postgresql.conf```. Más mian leat nascadh trí soicéid TCP, socraí:setting: HOST go 'localhost' nó '127.0.0.1' (línte 'óstach' i pg\_hba.conf\`). Ar Windows, ba cheart duit sainmhíniú i gcónaí:setting: HOST, toisc nach bhfuil soicéid fearainn UNIX ar fáil.

#### AINM \`

Réamhshocraithe: "(Sreang folamh)

Ainm an bhunachar sonraí le húsáid. Maidir le SQLite, is é an cosán iomlán chuig an gcomhad bunachar sonraí. Agus an cosán á shonrú agat, bain úsáid as slashes ar aghaidh i gcónaí, fiú ar Windows (m.sh. `C: /homes/user/mysite/sqlite3.db`).

#### `CONN_MAX_AOS`

Réamhshocraithe: `0`

Saolré nasc bunachar sonraí, mar shláimhir soicind. \<persistent-database-connections\>Úsáid `0` chun naisc bunachar sonraí a dhúnadh ag deireadh gach iarratais - iompar stairiúil Django - agus None le haghaidh neamhtheoranna:ref: naisc bunachar sonraí leanúnacha .

#### `SEICEÁLACHA SLÁINTE CONN`

Réamhshocraithe: `Fréag`

Má tá sé socraithe go `True`, déan \<persistent-database-connections\>far seiceáil sláinte atá ann: ref: naisc bunachar sonraí leanúnacha 'sula n-athúsáidtear iad i ngach iarratas a dhéanann rochtain ar bhunachar sonraí. Má theipeann ar an seiceáil sláinte, athbhunófar an nasc gan teip ar an iarratas nuair nach bhfuil an nasc inúsáidte a thuilleadh ach tá an freastalaí bunachar sonraí réidh chun naisc nua a ghlacadh agus a sheirbheáil (m.sh. tar éis freastalaí bunachar sonraí a atosú a dhúnadh

#### `ROGHANNAÍ`

Réamhshocraithe: `{}` (Foclóir folamh)

Paraiméadair bhreise le húsáid agus tú ag nascadh leis an mbunachar Athraíonn na paraiméadair atá ar fáil ag brath ar do chúltaca bunachar

Is féidir roinnt faisnéise faoi pharaiméadair atá ar fáil a fháil sa dhoiciméadúiséireacht: Doc: \</ref/databases\> Bunachar Sonraí Backends. Le haghaidh tuilleadh faisnéise, téigh i gcomhairle le cáipéisíocht do mhodúl cúlt

#### PASFHOCAL \`\`

Réamhshocraithe: "(Sreang folamh)

An pasfhocal le húsáid agus tú ag nascadh leis an mbunachar sonraí. Ní úsáidtear le SQLite.

#### CALAFOIRT'

Réamhshocraithe: "(Sreang folamh)

An calafort le húsáid agus tú ag nascadh leis an mbunachar sonraí. Ciallaíonn sreang folamh an calafort réamhshocraithe. Ní úsáidtear le SQLite.

#### `CRIOS_AMA`

Réamhshocraithe: Níl \`\`

Sreang a léiríonn an crios ama don nasc bunachar sonraí seo nó `None`. Glacann an rogha istigh seo den socrú: setting: DATABASES leis na luachanna céanna leis an socrú ginearált:setting: TIME\_ZONE.

Nuair: Setting: `` `True `` USE\_TZ, filleann dáta léitheoireachta ón mbunachar sonraí dáta ar an eolas uaireanta agus an crios ama atá socraithe ar luach an rogha seo mura bhfuil `None`, nó go UTC ar shlí eile.

Nuair: SETTING: USE\_TZ `False`, is earráid é an rogha seo a shocrú.

- Mura dtacaíonn cúltaca an bhunachar sonraí le criosanna ama (m.sh. SQLite, MySQL, Oracle), léann agus scríobhann Django dáta-amanna in am áitiúil de réir an rogha seo má tá sé socraithe agus i UTC mura bhfuil sé.

  Athraíonn athrú an chrios ama nasc an chaoi a léitear dáta-amanna ón mbunachar sonraí agus a scríobh chuig.

  - Má bhainistíonn Django an bunachar sonraí agus nach bhfuil cúis láidir agat a mhalairt a dhéanamh, ba cheart duit an rogha seo a fhágáil gan socrú. Is fearr amanna dáta a stóráil in UTC toisc go seachnaíonn sé amanna dáta débhríoch nó nach bhfuil ann le linn athruithe ama sábhála solais an lae. Chomh maith leis sin, coinníonn uimhríocht dáta-ama simplí a fháil in UTC - ní gá athruithe fritháireamh féideartha a mheas thar aistriú DST.
  - Má tá tú ag nascadh le bunachar sonraí tríú páirtí a stórálann dáta in am áitiúil seachas UTC, ansin ní mór duit an rogha seo a shocrú go dtí an crios ama cuí. Mar an gcéanna, má bhainistíonn Django an bunachar sonraí ach má nascann córais tríú páirtí leis an mbunachar sonraí céanna agus má tá súil leo dáta a fháil in am áitiúil, ansin ní mór duit an rogha seo a shocrú.
- Má thacaíonn cúltaca an bhunachar sonraí le criosanna ama (m.sh., PostgreSQL), ansin socraítear crios ama an nasc bunachar sonraí go dtí an luach seo.

  Cé go bhfuil gá go han-annamh ag teastáil an rogha `TIME_ZONE` a shocrú, tá cásanna ann ina bhfuil sé riachtanach. Go sonrach, moltar an socrú ginearált:setting: TIME\_ZONE a mheaitseáil agus tú ag déileáil le ceisteanna amh a bhaineann le feidhmeanna dáta/ama cosúil le date\_trunc () \`PostgreSQL nó \`generate\_series () \`, go háirithe agus sraitheanna bunaithe ama á ghiniúint a aistríonn coigilteas solais.

  Is féidir an luach seo a athrú ag am ar bith, láimhseálfaidh an bunachar sonraí tiontú dáta-amanna go dtí an crios ama cumraithe.

  Mar sin féin, tá míbhuntáiste aige seo: bíonn uimhríocht dáta níos deacra uimhríocht dáta-ama go léir a fháil in am áitiúil - ní mór duit cuntas a thabhairt ar athruithe féideartha fritháireamh ar aistrithe

  Smaoinigh ar thiontú go am áitiúil go sainráite le `AT TIME ZONE` i gceisteanna amh SQL in ionad an rogha `TIME_ZONE` a shocrú.

#### `CÚRSAÍ TAOBH FREASTALAÍ_DÍCHUMASACHA`

Réamhshocraithe: `Fréag`

Socraigh é seo go `True` más mian leat úsáid cúrsaí taobh an fhreastalaí a dhíchumasú le: meth: .queryset.iterator. :ref: transaction-pooling-server-side-cursors cur síos ar an gcás úsáide.

Is suíomh atá sonrach le PostgreSQL é seo.

#### ÚSÁIDEOIR \`\`

Réamhshocraithe: "(Sreang folamh)

An t-ainm úsáideora le húsáid agus tú ag ceangal leis an mbunachar sonraí Ní úsáidtear le SQLite.

#### `TÁSTÁLA`

Réamhshocraithe: `{}` (Foclóir folamh)

Foclóir socruithe do bhunachar sonraí tástála; le haghaidh tuilleadh sonraí faoi chruthú agus úsáid bunachair sonraí tástála, féach:ref: the-test-database.

Seo sampla le cumraíocht bunachar sonraí tástála:

```
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "USER": "mydatabaseuser",
        "NAME": "mydatabase",
        "TEST": {
            "NAME": "mytestdatabase",
        },
    },
}
```

Tá na heochracha seo a leanas sa fhoclóir `TEST` ar fáil:

##### `CHARSET`

Réamhshocraithe: Níl \`\`

An t-ionchódú tacar carachtair a úsáidtear chun an bunachar sonraí tástála a Cuirtear luach an teaghráin seo go díreach chuig an mbunachar sonraí, mar sin tá a fhormáid go sonrach le cúltaca.

Le tacaíocht ó na cúltaca PostgreSQL (postgresql\`) agus [MySQL](https://dev.mysql.com/doc/refman/en/charset-charsets.html) (`mysql`).

##### COMHLÁNÚ \`\`

Réamhshocraithe: Níl \`\`

An t-ordú comhlánaithe le húsáid agus an bunachar sonraí tástála á chruthú. Cuirtear an luach seo ar aghaidh go díreach chuig an gcúltaca, mar sin tá a fhormáid go sonrach le cúltaca.

Ní thacaítear ach leis an gcúltaca `mysql` (féach an lámhleabhar MySQL \_ le haghaidh sonraí).

##### SPLEÁCHAIS \`\`

Réamhshocraithe: `['réamhshocraithe']`, do gach bunachar sonraí seachas `default`, nach bhfuil aon spleáchais aige.

Sspleáchais ordú cruthaithe an bhunachar sonraí. Féach an doiciméadú ar:ref: ord cruthaithe bunachar sonraí tástála a rialú \<topics-testing-creation-dependencies\>\`le haghaidh sonraí.

##### `` `IMIRCE ``

Réamhshocraithe: Fíor\`

Nuair a bheidh sé socraithe ar False, ní rithfidh imirce agus an bunachar sonraí tástála á gcruthú. Tá sé seo cosúil le `None` a shocrú mar luach in:setting: MIGRATION\_MODULES, ach do gach aip.

##### `SCÁTHÁN`

Réamhshocraithe: Níl \`\`

An t-ainm den bhunachar sonraí ba chóir go mbeadh an bunachar sonraí seo a scáthú le linn Braitheann sé ar idirbhearta agus dá bhrí sin caithfear é a úsáid laistigh de: class: ~django.test.transactionTestCase in ionad:class: ~django.test.testcase.

Tá an suíomh seo ann chun cumraíochtaí bunscoil/macasamhail (dá ngairtear máistir/sclábhaí ag roinnt bunachair sonraí) a thástáil ar bhunachar sonraí iolracha. \<topics-testing-primaryreplica\>Féach an doiciméadú ar:ref: cumraíochtaí bunscoile/macasamhail a thástáil le haghaidh sonraí.

##### AINM \`

Réamhshocraithe: Níl \`\`

Ainm an bhunachar sonraí le húsáid agus an tsraith tástála á reáchtáil.

Má úsáidtear an luach réamhshocraithe (````None ``) le hinneall bunachar sonraí SQLite, úsáidfidh na tástálacha bunachar sonraí cónaitheoirí cuimhne. Maidir le gach inneall bunachar sonraí eile úsáidfidh an bunachar sonraí tástála an t-ainm ```test_'+DATABASE_NAME````.

Féach:ref: bunachar sonraí tástála'.

##### `TEIMPLÉAD`

Is suíomh atá sonrach le PostgreSQL é seo.

Ainm [teimpléad](#template) (m.sh. teimpléad0') as a chruthófar bunachar sonraí tástála.

##### `CRUTHAITHE_DB`

Réamhshocraithe: Fíor\`

Is suíomh atá sonrach le Oracle é seo.

Má tá sé socraithe ar False\`, ní chruthófar na spásanna tástála go huathoibríoch ag tús na dtástálacha nó ní chruthófar na spásanna tástála ag an deireadh.

##### `CHRUTHAITHE_ÚSÁIDEOIR`

Réamhshocraithe: Fíor\`

Is suíomh atá sonrach le Oracle é seo.

Má tá sé socraithe ar False\`, ní chruthófar an t-úsáideoir tástála go huathoibríoch ag tús na dtástálacha agus titeoidh sé ag an deireadh.

##### ÚSÁIDEOIR \`\`

Réamhshocraithe: Níl \`\`

Is suíomh atá sonrach le Oracle é seo.

An t-ainm úsáideora le húsáid agus tú ag ceangal le bunachar sonraí Oracle a úsáidfear agus tástálacha á reáchtáil Mura gcuirtear ar fáil, úsáidfidh Django `` `'test_'+USER ``.

##### PASFHOCAL \`\`

Réamhshocraithe: Níl \`\`

Is suíomh atá sonrach le Oracle é seo.

An focal faire le húsáid agus tú ag nascadh le bunachar sonraí Oracle a úsáidfear agus tástálacha á reáchtáil. Mura gcuirtear ar fáil, ginfidh Django pasfhocal randamach.

##### `COMHAD BAINISTITHE ORACLE`

Réamhshocraithe: `Fréag`

Is suíomh atá sonrach le Oracle é seo.

Má tá sé socraithe ar `True`, úsáidfear spásanna tábla Comhaid Bainistithe Oracle (OMF). :setting: DATAFILE agus:setting: DATAFILE\_TMP déanfar neamhaird.

##### `TBLSPACE`

Réamhshocraithe: Níl \`\`

Is suíomh atá sonrach le Oracle é seo.

Ainm an spás tábla a úsáidfear agus tástálacha á reáchtáil. Mura gcuirtear ar fáil, úsáidfidh Django `` `'test_'+USER ``.

##### `TBLSPACE_TMP`

Réamhshocraithe: Níl \`\`

Is suíomh atá sonrach le Oracle é seo.

Ainm an spás tábla sealadach a úsáidfear agus tástálacha á reáchtáil. Mura gcuirtear ar fáil, úsáidfidh Django `` `'test_'+ USER + '_temp' ``.

##### `DATAFILE`

Réamhshocraithe: Níl \`\`

Is suíomh atá sonrach le Oracle é seo.

Ainm na fille sonraí le húsáid don TBLSPACE. Mura gcuirtear ar fáil, úsáidfidh Django `TBLSPACE + '.dbf'`.

##### `DATAFILE_TMP`

Réamhshocraithe: Níl \`\`

Is suíomh atá sonrach le Oracle é seo.

Ainm na sonraí le húsáid don TBLSPACE\_TMP. Mura gcuirtear ar fáil, úsáidfidh Django `TBLSPACE_TMP + '.dbf'`.

##### `DATAFILE_MAXSIZE`

Réamhshocraithe: 500M \`

Is suíomh atá sonrach le Oracle é seo.

An méid uasta a cheadaítear don DATAFILE fás air.

##### `DATAFILE_TMP_MAXSIZE`

Réamhshocraithe: 500M \`

Is suíomh atá sonrach le Oracle é seo.

An méid uasta a cheadaítear don DATAFILE\_TMP fás.

##### `MÉID_DATAFILE`

Réamhshocraithe: `'50M'`

Is suíomh atá sonrach le Oracle é seo.

Méid tosaigh an DATAFILE.

##### `DATAFILE_TMP_SIZE`

Réamhshocraithe: `'50M'`

Is suíomh atá sonrach le Oracle é seo.

Méid tosaigh an DATAFILE\_TMP.

##### `DATAFILE_EXTSIZE`

Réamhshocraithe: `'25M'`

Is suíomh atá sonrach le Oracle é seo.

An méid a leathnaítear an DATAFILE nuair a bhíonn níos mó spáis ag teastáil.

##### `DATAFILE_TMP_EXTSIZE`

Réamhshocraithe: `'25M'`

Is suíomh atá sonrach le Oracle é seo.

An méid a leathnaítear an DATAFILE\_TMP nuair a bhíonn níos mó spáis ag teastáil.

### SONRA\_UASLÓDÁIL\_MÉID\_CUIMHNEACHÁIN UASTA \`\`

Réamhshocraithe: 2621440\` (ie 2.5 MB).

Ardaítear an méid uasta i mbeátaí a d'fhéadfadh comhlacht iarratais a bheith roimh a:exc: ~Django.Core.Exceptions.SuspiciousOperation (`RequestDataToObig`). Déantar an seiceáil nuair a bhíonn rochtain agat ar `request.body` nó `request.post` agus ríomhtar é i gcoinne méid iomlán an iarratais gan aon sonraí uaslódála comhad a áireamh. Is féidir leat é seo a shocrú go None chun an seic a dhíchumasú. Ba chóir d'iarratais a bhfuiltear ag súil go bhfaighidh poist foirme neamhghnách mór an suíomh

Tá an méid sonraí iarratais comhghaolmhar leis an méid cuimhne atá ag teastáil chun an t-iarratas a phróiseáil agus na foclóirí GET agus POST a líonadh. D'fhéadfaí iarratais mhóra a úsáid mar veicteoir ionsaí diúltaithe seirbhíse má fhágtar gan seiceáil. Ós rud é nach ndéanann freastalaithe gréasáin iniúchadh domhain iarratais de ghnáth, ní féidir seiceáil den chineál céanna a dhéanamh ag an leibhéal sin.

Féach freis:socrú: FILE\_UPLOAD\_MAX\_MEMORY\_SIZE.

### `SONRA_UASLÓDÁIL_UIMHREACH_RÉIMSÍ UASGHAIR`

Réamhshocraithe: `1000`

Ardaítear an líon uasta na bparaiméadair a d'fhéadfaí a fháil trí GET nó POST roimh a:exc: ~Django.Core.Exceptions.SuspiciousOperation (`ToomanyFields`). Is féidir leat é seo a shocrú go None chun an seic a dhíchumasú. Ba chóir d'iarratais a bhfuiltear ag súil go bhfaighidh líon neamhghnách mór réimsí foirme an socrú seo a

Tá líon na bparaiméadair iarratais comhghaolmhar leis an méid ama a theastaíonn chun an t-iarratas a phróiseáil agus na foclóirí GET agus POST a líonadh. D'fhéadfaí iarratais mhóra a úsáid mar veicteoir ionsaí diúltaithe seirbhíse má fhágtar gan seiceáil. Ós rud é nach ndéanann freastalaithe gréasáin iniúchadh domhain iarratais de ghnáth, ní féidir seiceáil den chineál céanna a dhéanamh ag an leibhéal sin.

### SONRAÍ\_UASLÓDÁIL\_UIMHREACH\_COMHAID \`\`

Réamhshocraithe: `100`

Ardaítear an líon uasta comhaid a d'fhéadfaí a fháil trí POST in iarratas ionchódaithe ```multipart/form-data ``roimh a:exc: `~Django.Core.Exceptions.SuspiciousOperation` (`ToomanyFiles```). Is féidir leat é seo a shocrú go None chun an seic a dhíchumasú. Ba chóir d'iarratais a bhfuiltear ag súil go bhfaighidh líon neamhghnách mór réimsí comhad an suíomh seo a dhí

Tá comhghaol ag líon na gcomhad a nglactar leis an méid ama agus cuimhne a theastaíonn chun an iarratas a phróiseáil. D'fhéadfaí iarratais mhóra a úsáid mar veicteoir ionsaí diúltaithe seirbhíse má fhágtar gan seiceáil. Ós rud é nach ndéanann freastalaithe gréasáin iniúchadh domhain iarratais de ghnáth, ní féidir seiceáil den chineál céanna a dhéanamh ag an leibhéal sin.

### `RÓDAIRÍ_BUNACHAR SONRAÍ`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta na ródairí a úsáidfear chun a chinneadh cén bunachar sonraí atá le húsáid agus ceist bunachar sonraí á ndéanamh agat.

\<topics-db-multi-db-routing\>Féach an doiciméadú ar:ref: ródú uathoibríoch bunachar sonraí i cumraíochtaí ilbhunachar sonraí .

### `FORMÁID_DÁTA`

Réamhshocraithe: `'N j, Y'` (m.sh. `4 Feabhra, 2003`)

An formáidiú réamhshocraithe le húsáid chun réimsí dáta a thaispeáint in aon chuid den chóras. Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin. \<date\>Féach: TFilter: teaghráin formáid dáta ceadaithe .

Féach freis:setting: DATETIME\_FORMAT, :setting: TIME\_FORMAT agus:setting: SHORT\_DATE\_FORMAT.

### FORMÁIDÍ DÁTA\_IONCHUIRIÚCHÁIN \`\`

Réamhshocraithe:

```
[
    "%Y-%m-%d",  # '2006-10-25'
    "%m/%d/%Y",  # '10/25/2006'
    "%m/%d/%y",  # '10/25/06'
    "%b %d %Y",  # 'Oct 25 2006'
    "%b %d, %Y",  # 'Oct 25, 2006'
    "%d %b %Y",  # '25 Oct 2006'
    "%d %b, %Y",  # '25 Oct, 2006'
    "%B %d %Y",  # 'October 25 2006'
    "%B %d, %Y",  # 'October 25, 2006'
    "%d %B %Y",  # '25 October 2006'
    "%d %B, %Y",  # '25 October, 2006'
]
```

Liosta de na formáidí a nglacfar leo agus sonraí á ionchur isteach i réimse dáta. Déanfar triail a bhaint as formáidí in ord, ag baint úsáide as an gcéad cheann bailí. Tabhair faoi deara go n-úsáideann na teaghráin formáide seo comhréir modúl Python: ref: datetime '\<strftime-strptime-behavior\>, ní na teaghráin formáide ón scagaire teimpléad:tfilter: \`dáta.

Tá tosaíocht níos airde ag an bhformáid áitiúil agus cuirfear i bhfeidhm ina ionad sin.

Féach freis:socrú: DATETIME\_INPUT\_FORMATS agus:SETTING: TIME\_INPUT\_FORMATS.

### `FORMÁID_DÁTAIME`

Réamhshocraithe: `'N j, Y, P'` (m.sh. `4 Feabhra, 2003, 4 p.m.`)

An formáidiú réamhshocraithe le húsáid chun réimsí dáta-ama a thaispeáint in aon chuid den chóras. Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin. \<date\>Féach: TFilter: teaghráin formáid dáta ceadaithe .

Féach freis:socrú: DATE\_FORMAT, :setting: TIME\_FORMAT agus:setting: SHORT\_DATETIME\_FORMAT.

### FORMÁIDÍ DÁTAIME\_IONCHUIRIÚCHÁIN \`\`

Réamhshocraithe:

```
[
    "%Y-%m-%d %H:%M:%S",  # '2006-10-25 14:30:59'
    "%Y-%m-%d %H:%M:%S.%f",  # '2006-10-25 14:30:59.000200'
    "%Y-%m-%d %H:%M",  # '2006-10-25 14:30'
    "%m/%d/%Y %H:%M:%S",  # '10/25/2006 14:30:59'
    "%m/%d/%Y %H:%M:%S.%f",  # '10/25/2006 14:30:59.000200'
    "%m/%d/%Y %H:%M",  # '10/25/2006 14:30'
    "%m/%d/%y %H:%M:%S",  # '10/25/06 14:30:59'
    "%m/%d/%y %H:%M:%S.%f",  # '10/25/06 14:30:59.000200'
    "%m/%d/%y %H:%M",  # '10/25/06 14:30'
]
```

Liosta formáidí a nglacfar leo agus sonraí á ionchur isteach ar réimse dáta-ama. Déanfar triail a bhaint as formáidí in ord, ag baint úsáide as an gcéad cheann bailí. Tabhair faoi deara go n-úsáideann na teaghráin formáide seo comhréir modúl Python: ref: datetime '\<strftime-strptime-behavior\>, ní na teaghráin formáide ón scagaire teimpléad:tfilter: \`dáta. Ní chuirtear formáidí dáta amháin san áireamh mar go ndéanfaidh réimsí dáta-ama iarracht go huathoibríoch: setting: DATE\_INPUT\_FORMATS sa rogha deireanach.

Tá tosaíocht níos airde ag an bhformáid áitiúil agus cuirfear i bhfeidhm ina ionad sin.

Féach freis:socrú: DATE\_INPUT\_FORMATS agus:socrú: TIME\_INPUT\_FORMATS.

### `DEBUG`

Réamhshocraithe: `Fréag`

Boolean a chasann ar/as modh dífhabhtaithe.

Ná imscaradh suíomh riamh i dtáirgeadh le: socrú: DEBUG a chasadh air.

Ceann de phríomhghnéithe an mhodh dífhabhtaithe ná leathanaigh earráide mionsonraithe a thaispeáint. Má ardaíonn d'aip eisceacht nuair a bhíonn: socrú: DEBUG `True`, taispeánfaidh Django rianú mionsonraithe, lena n-áirítear go leor meiteashonraí faoi do thimpeallacht, mar shampla na socruithe Django atá sainmhínithe faoi láthair (ó settings.py\`).

Mar bheart slándála, \* ní chuimseoidh Django socruithe a d'fhéadfadh a bheith íogair, mar shampla:setting: SECRET\_KEY. Go sonrach, eisifaidh sé aon socrú a chuimsíonn a n-ainm aon cheann de na nithe seo a leanas:

- `` `'API' ``
- 'EOCHAIR'
- `` `'PASS' ``
- 'RÚNAÍ'
- 'SÍNIÚ'
- `` `'TOKEN' ``

Tabhair faoi deara gur cluichí páirtitheach\* iad seo. Meaitneoidh `'PASS'` PASSWORD freisin, díreach mar a mheaitseálfaidh 'TOKEN'\` TOKENIZED agus mar sin de freisin.

Mar sin féin, tabhair faoi deara go mbeidh codanna de d'aschur dífhabhtaithe ann i gcónaí atá míchuí le haghaidh tomhaltas poiblí. Tugann cosáin comhad, roghanna cumraíochta agus a leithéid go léir faisnéis bhreise d'ionsaitheoirí faoi do fhre

Tá sé tábhachtach cuimhneamh freisin go gcuimhneoidh Django ar gach ceist SQL a fhorghníomhaíonn sé nuair a bheidh ag rith le:setting: DEBUG air. Tá sé seo úsáideach nuair a bhíonn tú ag dífhabhtú, ach ídífidh sé cuimhne go tapa ar fhreastalaí táirgeachta.

Faoi dheireadh, más é: setting: DEBUG `False`, ní mór duit an socrú: setting: ALLOWED\_HOSTS a shocrú i gceart freisin. Mura ndéantar é sin, beidh gach iarratas ar ais mar “Droch-iarratas (400)”.

> **Note**
>
> \<startproject\>Leagann an comhad réamhshocraithe:file: settings.py a chruthaí:djadmin: django-admin startproject \`\`\`DEBUG = True\` le haghaidh áisiúlachta.

### `` `EISCEACHTAIS_IOMADAITHE_DEBUG ``

Réamhshocraithe: `Fréag`

Má tá sé socraithe go True\`, déantar láimhseáil eisceachta Django ar fheidhmeanna amharc (:data: ~django.conf.urls.handler500, nó an dearcadh dífhabhtaithe ife:setting: DEBUG True\`) agus logáil 500 freagra (:ref: django-request-logger) agus iomadú eisceachtaí aníos.

Is féidir leis seo a bheith úsáideach do roinnt socruithe tástála. Níor chóir é a úsáid ar shuíomh beo mura dteastaíonn uait do fhreastalaí gréasáin (in ionad Django) freagraí “Earráid Freastalaí Inmheánach” a ghiniúint. Sa chás sin, déan cinnte nach dtaispeánann do fhreastalaí an rian cruach nó faisnéis íogair eile sa fhreagra.

### `DEIGHILTEOIR DEACHIMAL`

Réamhshocraithe: '.'\` (Ponc)

Déileálóir deachúil réamhshocraithe a úsáidtear agus uimhreacha

Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin.

Féach freis:socrú: NUMBER\_GROUPING, :setting: THOUSAND\_SEPARATOR agus:setting: USE\_THOUSAND\_SEPARATOR.

### `RÉAMHSHOCRAITHE_AUTO_FIELD`

Réamhshocraithe: `` ` ``:class: Django.db.Models.AutoField

\<django.db.models.Field.primary\_key\>Cineál réimse eochair phríomhúil réamhshocraithe le húsáid le haghaidh samhlacha nach bhfuil réimse acu le:attr: primary\_key=True .

> **Aimirce uathoibríoch a cruthaíodh**
>
> Meas a thabhairt ar luach DEFAULT\_AUTO\_FIELD\` nuair a chruthaítear uathoibríoch nua trí tháblaí le haghaidh caidrimh go leor.
>
> Ar an drochuair, ní féidir leis an gcreat imirce príomh-eochracha atá ann cheana a cruthaíodh trí tháblaí a nuashonrú faoi láthair.
>
> Ciallaíonn sé seo má athraíonn tú luach `DEFAULT_AUTO_FIELD` agus ansin imirce a ghineann tú, nuashonrófar eochracha príomhúil na samhlacha gaolmhara, mar aon leis na heochracha eachtracha ón tábla trí thráid, ach ní imirfear príomh-eochair an tábla uathoibríoch.
>
> D'fhonn aghaidh a thabhairt air seo, ba chóir duit oibríocht a:class: ~django.db.migrations.operations.runsql a chur le d'imirce chun an chéim `ALTER TABLE` riachtanach a dhéanamh. Is féidir leat an t-ainm tábla atá ann cheana a sheiceáil trí sqlmigrate\`, dbshell\`, nó le remote\_field.through an réimse. Maoin \_meta.db\_table \`.
>
> Déanann an córas imirce láimhseáil cheana féin a shainmhínítear go sainráite trí
>
> \<32674\>Imirce uathoibríoch a cheadú don phríomh-eochair an uathoibríoch atá ann cheana a chruthaítear trí tháblaí: ticéad: féadfar 'a chur i bhfeidhm

### `DEFAULT_CHARSET`

Réamhshocraithe: `'utf-8'`

Charset réamhshocraithe le húsáid do gach rud ```HttpResponse`, mura ndéantar cineál MIME a shonrú de láimh. Úsáidtear agus an ceannteideal ``Content-Type``` á thógáil.

### `TUAIRISEOIRÍ_EISCEACHTÁIL_RÉAMHSHOCRAITHE`

Réamhshocraithe: `` ` ``:class: Django.Views.debug.ExceptionReporter

Aicme tuairisceoir eisceachta réamhshocraithe le húsáid mura bhfuil aon duine sannta don shampla:class: ~django.http.httpRequest fós. Féach: tagairt: tuarascálacha saincheaptha earráid.

### `SCAGAIR_TUAIRISCITHEOIRÍ_EISCEACHTÁIL_RÉAMHSHOCRAITHE`

Réamhshocraithe: `` ` ``:class: django.views.debug.safeExceptionReporterFilter

Aicme scagaire tuairisceachta eisceachta réamhshocraithe le húsáid mura sannadh aon rud don shampla:class: ~django.http.httpRequest fós. \<filtering-error-reports\>Féach: tagairt: Tuarascálacha earráide scagtha .

### `DEFAULT_FROM_RÍOMHPHOST`

Réamhshocraithe: `'stiúrthóir gréasáin @localhost '`

Seoladh ríomhphoist réamhshocraithe le haghaidh comhfhreagras uathoibrithe ó bhainisteoir an láithreáin Úsáidtear an seoladh seo sa cheanntásc From: de ríomhphoist amach agus féadann sé aon fhormáid a ghlacadh bailí sa phrótacal seolta ríomhphoist roghnaithe.

Ní dhéanann sé seo difear do theachtaireachtaí earráide a sheoltar chuig:setting: ADMINS agus:setting: MANAGERS. Féach: SETTING: SERVER\_EMAIL chuige sin.

### `RÉAMHSHOCRAITHE_INDEX_TABLESPACE`

Réamhshocraithe: "(Sreang folamh)

Spás tábla réamhshocraithe le húsáid le haghaidh innéacsanna ar réimsí nach sonraíonn ceann amháin, má thacaíonn an cúltaca leis (féach: doc: /topics/db/tablespaces).

### `DEFAULT_TABLESPACE`

Réamhshocraithe: "(Sreang folamh)

Spás tábla réamhshocraithe le húsáid le haghaidh samhlacha nach sonraíonn ceann amháin, má thacaíonn an cúltaca leis (féach: doc: /topics/db/tablespaces).

### `GNÍOMHAIRÍ_ÚSÁIDEOIR_NEAMHCHEADAITHE`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta de na rudaí léirithe rialta tiomsaithe a léiríonn teaghráin Gníomhaire Úsáideora nach bhfuil cead acu cuairt a thabhairt ar aon leathanach, Úsáid é seo le haghaidh bots/crawlers. Ní úsáidtear é seo ach amháin má tá `CommonMiddleware` suiteáilte (féach: doc: /topics/http/middleware).

### `RÍOMHPHOST_BACKEND`

Réamhshocraithe: `` ` ``:class: django.core.mail.backends.smtp.emailBackend

An cúltaca le húsáid chun ríomhphoist a sheoladh. Le haghaidh liosta na gcúltaca atá ar fáil féach:ref: topic-email-backends.

### `RÍOMHPHOST_FILE_PATH`

Réamhshocrú: Gan sainmhíniú

An eolaire a úsáideann an: ref: backend ríomhphoist comhad \<topic-email-file-backend\>\`chun comhaid aschuir a stóráil.

### `RÍOMHPHOST_ÓST`

Réamhshocraithe: `'localhost'`

An t-óstach le húsáid chun ríomhphost a sheoladh.

Féach freisin: socrú: EMAIL\_PORT.

### RÍOMHPHOST\_HOST\_PASFHOCAL \`\`

Réamhshocraithe: "(Sreang folamh)

Pasfhocal le húsáid don fhreastalaí SMTP atá sainmhínithe in:setting: EMAIL\_HOST. Úsáidtear an socrú seo i gcomhar le:setting: EMAIL\_HOST\_USER agus tú ag fíordheimhniú chuig an bhfreastalaí SMTP. Má tá ceachtar de na socruithe seo folamh, ní dhéanfaidh Django iarracht fíordheimhniú.

Féach freisin: socrú: EMAIL\_HOST\_USER.

### RÍOMHPHOST\_HOST\_ÚSÁIDEOIR \`\`

Réamhshocraithe: "(Sreang folamh)

Ainm úsáideora le húsáid don fhreastalaí SMTP atá sainmhínithe in:setting: EMAIL\_HOST. Má tá sé folamh, ní dhéanfaidh Django iarracht fíordheimhniú.

Féach freis:socrú: EMAIL\_HOST\_PASSWORD.

### RÍOMHPHOST\_PORT \`

Réamhshocraithe: `25`

Port le húsáid don fhreastalaí SMTP atá sainmhínithe in:setting: EMAIL\_HOST.

### `RÍOMHPHOST_ÁBHAIR_RÉAMH`

Réamhshocraithe: `'[Django] '`

Réimír líne ábhair do theachtaireachtaí ríomhphoist a sheoltar le `django.core.mail.mail_admins` nó `django.core.mail.mail_managers`. Is dócha go mbeidh tú ag iarraidh an spás siar a áireamh.

### `RÍOMHPHOST_ÚSÁID_ÁITIÚIL TIM`

Réamhshocraithe: `Fréag`

Cibé acu an ceannteideal SMTP ```Dáta ``de theachtaireachtaí ríomhphoist a sheoladh sa chrios ama áitiúil (``True```) nó i UTC (`False`).

### `` `RÍOMHPHOST_ÚSÁID_TLS ``

Réamhshocraithe: `Fréag`

Cibé acu nasc TLS (slán) a úsáid agus tú ag caint leis an bhfreastalaí SMTP. Úsáidtear é seo le haghaidh naisc shoiléire TLS, go ginearálta ar chalafort 587. Má tá naisc crochta agat, féach an socrú intuigthe TLS: setting: EMAIL\_USE\_SSL.

### `RÍOMHPHOST_ÚSÁID_SSL`

Réamhshocraithe: `Fréag`

Cibé acu nasc intuigthe TLS (slán) a úsáid agus tú ag caint leis an bhfreastalaí SMTP. I bhformhór na ndoiciméadaithe ríomhphoist tugtar SSL ar an gcineál seo nasc TLS. Úsáidtear é go ginearálta ar chalafort 465. Má tá fadhbanna agat, féach an socrú sainráite TLS: setting: EMAIL\_USE\_TLS.

Tabhair faoi deara go bhfuil: setting: EMAIL\_USE\_TLS/:SETTING: EMAIL\_USE\_SSL frithpháirteach, mar sin ní shocraigh ach ceann de na socruithe sin go `True`.

### `RÍOMHPHOST_SSL_CERTFILE`

Réamhshocraithe: Níl \`\`

If [`EMAIL_USE_SSL`](#std-setting-EMAIL_USE_SSL) or [`EMAIL_USE_TLS`](#std-setting-EMAIL_USE_TLS) is `True` and the
secure connection to the SMTP server requires client authentication, use this
setting to specify the path to a PEM-formatted certificate chain file, which
must be used in conjunction with [`EMAIL_SSL_KEYFILE`](#std-setting-EMAIL_SSL_KEYFILE).

`EMAIL_SSL_CERTFILE` should not be used with a self-signed server certificate
or a certificate from a private certificate authority (CA). In such cases, the
server's certificate (or the root certificate of the private CA) should be
installed into the system's CA bundle. This can be done by following
platform-specific instructions for installing a root CA certificate,
or by using OpenSSL's `SSL_CERT_FILE` or `SSL_CERT_DIR` environment
variables to specify a custom certificate bundle (if modifying the system
bundle is not possible or desired).

For more complex scenarios, the SMTP
[`EmailBackend`](/ga/5.2/topics/email/#django.core.mail.backends.smtp.EmailBackend) can be subclassed to add
root certificates to its `ssl_context` using
[`ssl.SSLContext.load_verify_locations()`](https://docs.python.org/3/library/ssl.html#ssl.SSLContext.load_verify_locations).

### `RÍOMHPHOST_SSL_KEYFILE`

Réamhshocraithe: Níl \`\`

If [`EMAIL_USE_SSL`](#std-setting-EMAIL_USE_SSL) or [`EMAIL_USE_TLS`](#std-setting-EMAIL_USE_TLS) is `True`, you can
optionally specify the path to a PEM-formatted private key file for client
authentication of the SSL connection along with [`EMAIL_SSL_CERTFILE`](#std-setting-EMAIL_SSL_CERTFILE).

Tabhair faoi deara nach mbíonn aon seiceáil deimhnithe mar thoradh ar shocting:setting: EMAIL\_SSL\_CERTFILE agus:setting: EMAIL\_SSL\_KEYFILE. Cuirtear iad ar aghaidh chuig an nasc SSL bunúsach. Féach do thoil do dhoiciméadú feidhm Python: Meth: Python: ssl.sslContext.wrap\_socket le haghaidh sonraí maidir le conas a láimhseálfar an comhad slabhra deimhnithe agus comhad eochair phríobháideach.

### `RÍOMHPHOST_TIMEOUT`

Réamhshocraithe: Níl \`\`

Sonraíonn sé ama i soicindí chun oibríochtaí a bhlocáil cosúil leis an iarracht nasc.

### `LÁIMHSEÁLAITHE COMHAI_UASLÓDÁLAÍ`

Réamhshocraithe:

```
[
    "django.core.files.uploadhandler.MemoryFileUploadHandler",
    "django.core.files.uploadhandler.TemporaryFileUploadHandler",
]
```

Liosta de láimhseálaithe le húsáid le haghaidh uaslódála. Ligeann an socrú seo a athrú saincheaptha iomlán - fiú athsholáthar - próiseas uaslódála Django.

Féach: doc: /topics/files le haghaidh sonraí.

### `FILE_UPLOAD_MAX_MÉIDE_CUIMHNEACH`

Réamhshocraithe: 2621440\` (ie 2.5 MB).

An méid uasta (i mbeátaí) a bheidh uaslódáil sula ndéantar é a shruthú chuig an gcóras comhaid. Féach: doc: /topics/files le haghaidh sonraí.

Féach freis:socrú: DATA\_UPLOAD\_MAX\_MEMORY\_SIZE.

### CEADÚNA\_STIÚRTHÓIREACH\_UASLÓDÁIL\_COMHAD \`\`

Réamhshocraithe: Níl \`\`

An modh uimhriúil le cur i bhfeidhm ar eolairí a cruthaíodh sa phróiseas comhaid a uaslódáil.

Cinneann an socrú seo na ceadanna réamhshocraithe d'eolairí statacha bailithe agus an t-ordú bainistíochta: djadmin: collectstatic á n-úsáid agat. Féach: Djadmin: collectstatic le haghaidh sonraí maidir leis a shárú.

Léiríonn an luach seo feidhmiúlacht agus rabhadh an shocraithe:setting: FILE\_UPLOAD\_PERMISSIONS.

### `CEADÚNA_UASLÓDÁIL_FILE`

Réamhshocraithe: `0o644`

An modh uimhriúil (ie `0o644`) chun comhaid nua-uaslódáilte a shocrú chuige. Le haghaidh tuilleadh faisnéise faoin méid a chiallaíonn na modhanna seo, féach an doiciméadú le haghaidh: func: os.chmod.

Má tá Níl , gheobhaidh tú iompar spleách ar an gcóras oibriúcháin. Ar fhormhór na n-ardán, beidh modh 0o600 ag comhaid shealadacha, agus sábhálfar comhaid a shábháiltear ó chuimhne ag baint úsáide as umask caighdeánach an chórais.

Ar chúiseanna slándála, ní chuirtear na ceadanna seo i bhfeidhm ar na comhaid shealadacha atá stóráilte in:setting: FILE\_UPLOAD\_TEMP\_DIR.

Cinneann an socrú seo na ceadanna réamhshocraithe do chomhaid statacha bailithe agus an t-ordú bainistíochta: djadmin: collectstatic á n-úsáid agat. Féach: Djadmin: collectstatic le haghaidh sonraí maidir leis a shárú.

> **Warning**
>
> \*\* Réamhítear an modh i gcónaí le\*\* 0o' \*\* . \*\*
>
> Mura bhfuil tú eolach ar mhodhanna comhaid, tabhair faoi deara go bhfuil an réimír 0\` an-tábhachtach: léiríonn sé uimhir ochtúil, arb é sin an bealach a chaithfear modhanna a shonrú. Má dhéanann tú iarracht 644\` a úsáid, gheobhaidh tú iompar go hiomlán mícheart.

### `FILE_UPLOAD_TEMP_DIR`

Réamhshocraithe: Níl \`\`

An eolaire chun sonraí a stóráil chuig (de ghnáth comhaid níos mó ná: setting: FILE\_UPLOAD\_MAX\_MEMORY\_SIZE) go sealadach agus comhaid á uaslódáil. Má tá ```None ``, úsáidfidh Django an eolaire sealadach caighdeánach don chóras oibriúcháin. Mar shampla, réamhshocróidh sé seo go ``/tmp``` ar chórais oibriúcháinnix-style.

Féach: doc: /topics/files le haghaidh sonraí.

### `` `CHÉAD_LAETH_DEN TSEACHTAINE ``

Réamhshocraithe: `0` (Dé Domhnaigh)

Uimhir a léiríonn an chéad lá den tseachtain. Tá sé seo úsáideach go háirithe agus féilire á thaispeáint. Ní úsáidtear an luach seo ach nuair nach n-úsáidtear idirnáisiúnú formáid, nó nuair nach féidir formáid a fháil don áitiúil reatha.

Caithfidh an luach a bheith ina shláimhir ó 0 go 6, áit a chiallaíonn 0 Dé Domhnaigh, ciallaíonn 1 Luain agus mar sin de.

### `FIXTURE_DIRS`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta na n-eolair \<fixtures-explanation\>í a chuardaíodh ar chomhaid: ref: fixture , i dteannta leis an eolaire daingneáin de gach feidhmchlár, in ord cuardaigh.

Tabhair faoi deara gur chóir go n-úsáidfeadh na cosáin seo slashes ar aghaidh i stíl Unix, fiú ar Windows.

Féach: tagairt: topics-tástála-daingneáin tosaitheach agus:ref: topics-tástála-daingneáin .

### `` `AINM_SCRIPT_FORCE ``

Réamhshocraithe: Níl \`\`

Mura bhfuil ```None ``, úsáidfear é seo mar luach an athróg comhshaoil ``SCRIPT_NAME``` in aon iarratas HTTP. Is féidir an socrú seo a úsáid chun an luach “SCRIPT\_NAME” a sholáthraíonn an freastalaí a shárú, ar d'fhéadfadh a bheith ina leagan athscríofa den luach is fearr nó nach soláthraítear ar chor ar bith. Úsáidtear é freisin ó:func: django.setup () \`chun réimír script réiteach URL a shocrú lasmuigh den timthriall iarrata/freagartha (m.sh. in orduithe bainistíochta agus scripteanna neamhspleácha) chun URLanna cearta a ghiniúint nuair a chuirtear \`FORCE\_SCRIPT\_NAME\` ar fáil.

### `FOIRM_RENDERER`

Réamhshocraithe: `` ` ``:class: django.forms.renderers.djangoTemplates

An rang a léiríonn foirmeacha agus a fhoirmíonn giuirléidí. \<low-level-widget-render-api\>Caithfidh sé: ref: an API rindreála ísealleibhéil a chur i bhfeidhm. Is iad na láithreoirí foirmeacha san áireamh:

- ``` `` ```:class: Django.Forms.renderers.djangoTemplates
- `` '` ``:class: Django.Forms.renderers.jinja2
- ``` `` ```:class: Django.Forms.Renderers.TemplateSetting`` ` ``

### `FOIRMS_URLFIELD_ASSUME_HTTPS`

> **Deprecated since Django 5.0**
>
> Deprecated since version 5.0.

Réamhshocraithe: `Fréag`

\<django.forms.URLField.assume\_scheme\>Socraigh an suíomh idirthréimhseach seo go True\` chun roghnú `"https"` a úsáid mar an luach réamhshocraithe nua de:attr: URLFIELD.ASSUME\_SCHEME le linn timthriall scaoilte Django 5.x.

### `MODÚL_BHEALACH_FORMÁID`

Réamhshocraithe: Níl \`\`

Conair iomlán Python chuig pacáiste Python ina bhfuil sainmhínithe formáid saincheaptha le haghaidh áitiúla tionscadail. Mura bhfuil `None`, seiceálfaidh Django le haghaidh comhad formats.py\`, faoin eolaire a ainmnítear mar an áitiúil reatha, agus úsáideoidh sé na formáidí atá sainmhínithe sa chomhad seo.

Táthar ag súil go n-ainmníofar ainm an eolaire ina bhfuil na sainmhínithe formáide ag baint úsáid:term: notáil ainm áitiúil, mar shampla \`\`de\`, pt\_br\`, `en_us`, srl.

Mar shampla, má tá: setting: FORMAT\_MODULE\_PATH socraithe go `mysite.formats`, agus is é en (Béarla) an teanga reatha, beidh Django ag súil le crann eolaire mar:

```text
mysite/
    formats/
        __init__.py
        en/
            __init__.py
            formats.py
```

Is féidir leat an socrú seo a shocrú freisin ar liosta de chosáin Python, mar shampla:

```
FORMAT_MODULE_PATH = [
    "mysite.formats",
    "some_app.formats",
]
```

Nuair a chuardaíonn Django ar fhormáid áirithe, rachaidh sé trí gach cosán Python a thugtar go dtí go bhfaighidh sé modúl a shainmhíníonn an fhormáid a thugtar Ciallaíonn sé seo go mbeidh tosaíocht ag formáidí a shainmhínítear i bpacáistí níos faide ar an liosta thar na formáidí céanna i bpacáistí níos faide síos.

Is iad na formáidí atá ar fáil ná:

- [`DATE_FORMAT`](#std-setting-DATE_FORMAT)
- [`DATE_INPUT_FORMATS`](#std-setting-DATE_INPUT_FORMATS)
- [`DATETIME_FORMAT`](#std-setting-DATETIME_FORMAT),
- [`DATETIME_INPUT_FORMATS`](#std-setting-DATETIME_INPUT_FORMATS)
- [`DECIMAL_SEPARATOR`](#std-setting-DECIMAL_SEPARATOR)
- [`FIRST_DAY_OF_WEEK`](#std-setting-FIRST_DAY_OF_WEEK)
- [`MONTH_DAY_FORMAT`](#std-setting-MONTH_DAY_FORMAT)
- [`NUMBER_GROUPING`](#std-setting-NUMBER_GROUPING)
- [`SHORT_DATE_FORMAT`](#std-setting-SHORT_DATE_FORMAT)
- [`SHORT_DATETIME_FORMAT`](#std-setting-SHORT_DATETIME_FORMAT)
- [`THOUSAND_SEPARATOR`](#std-setting-THOUSAND_SEPARATOR)
- [`TIME_FORMAT`](#std-setting-TIME_FORMAT)
- [`TIME_INPUT_FORMATS`](#std-setting-TIME_INPUT_FORMATS)
- [`YEAR_MONTH_FORMAT`](#std-setting-YEAR_MONTH_FORMAT)

### `URLACHA NEAMHCHOITIANTA 404_`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta de na rudaí léirithe rialta tiomsaithe ag cur síos ar URLanna ar chóir neamhaird a dhéanamh agus earráidí HTTP 404 á thuairisciú trí ríomhphost (féach: doc: /howto/error-reporting). Déantar nathanna rialta a mheaitseáil in aghaidh: meth: bealaí iomlána iarrata \<django.http.HttpRequest.get\_full\_path\>\`(lena n-áirítear sreang ceisteanna, más ann). Úsáid é seo mura soláthraíonn do shuíomh comhad a iarrtar go coitianta mar \`\`favicon.ico' nó \`\`robots.txt\`.

Ní úsáidtear é seo ach má tá: class: ~django.middleware.common.BrokenLinkemailsMiddleware cumasaithe (féach: doc: /topics/http/middleware).

### `APPS_SHUITEÁIL`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta de na teaghráin a ainmníonn gach feidhmchlár atá cumasaithe sa suiteáil Django seo. Ba chóir go mbeadh gach sreang ina chonair Python poncaithe chuig:

- aicme cumraíochta feidhmchláir (is fearr), nó
- pacáiste ina bhfuil iarratas.

[Learn more about application configurations](/ga/5.2/ref/applications/).

> **Úsáid clárlann an fheidhmchláir le haghaidh ionfhios**
>
> Níor cheart rochtain a fháil ar do chód riamh: setting: INSTALLED\_APPS go díreach. Úsáid: attr: django.apps.apps ina ionad.

> **Caithfidh ainmneacha agus lipéid iarratais a bheith uathúil in:setting: INSTALLED_APPS**
>
> Iarratas: Attr: ainmneacha \<django.apps.AppConfig.name\>\- an cosán Python poncanach chuig an bpacáiste iarratais - caithfidh a bheith uathúil. Níl aon bhealach ann an feidhmchlár céanna a áireamh faoi dhó, gan a chód a dhúbailt faoi ainm eile.
>
> Iarratas: ATTR: lipéid \<django.apps.AppConfig.label\>\- de réir réamhshocraithe caithfidh an chuid deiridh den ainm - a bheith uathúil freisin. Mar shampla, ní féidir leat `django.contrib.auth` agus `myproject.auth` araon a chur san áireamh. Mar sin féin, is féidir leat feidhmchlár a athlipéadú le cumraíocht saincheaptha a shainmhíníonn difríocht: attr: ~django.apps.appconfig.label.
>
> Tá feidhm ag na rialacha seo beag beann ar: tagraíonn setting: INSTALLED\_APPS aicmí cumraíochta feidhmchláir nó pacáistí feidhmchláir.

Nuair a sholáthraíonn roinnt feidhmchlár leaganacha éagsúla den acmhainn chéanna (teimpléad, comhad statach, ordú bainistíochta, aistriúchán), tá tosaíocht ag an bhfeidhmchlár atá liostaithe ar dtús in:setting: INSTALLED\_APPS.

### `IPS_INMHEÁN`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta de sheoltaí IP, mar teaghráin, go bhfuil:

- Lig don phróiseálaí comhthéacs: func: ~django.template.context\_processors.debug roinnt athróg a chur le comhthéacs an teimpléid.
- Is féidir leis an leabharmharcanna:ref: admindocs bookmarklets \<admindocs-bookmarklets\>\`a úsáid fiú mura bhfuil sé logáilte isteach mar úsáideoir foirne.
- Tá siad marcáilte mar “inmheánach” (seachas “EXTERNAL”) in:class: ~django.utils.log.adminEmailHandler ríomhphoist.

### `CÓD_TEANGA`

Réamhshocraithe: `'en-us'`

Sreang a léiríonn an cód teanga don tsuiteáil seo. \<language code\>Ba chóir go mbeadh sé seo i gcaighdeán:term: formáid ID teanga \`. Mar shampla, is é Béarla na SA \`"en-us". Féach freisin an [liosta na n-aitheantóirí teanga](http://www.i18nguy.com/unicode/language-identifiers.html) agus:doc: /topics/i18n/index.

Freastalaíonn sé trí chuspóir:

- Mura bhfuil an meán-earraí áitiúla in úsáid, cinneann sé cén t-aistriúchán a sheirbheálfar do gach úsáideoir.
- Má tá an láithreán gréasáin gníomhach, soláthraíonn sé teanga aisghabhála i gcás nach féidir an teanga is fearr leis an úsáideoir a chinneadh nó nach dtacaíonn an suíomh Gréasáin leis. Soláthraíonn sé an t-aistriúchán ar ais freisin nuair nach bhfuil aistriúchán do litriúil ar leith ann don teanga is fearr leis an úsáideoir.
- Má dhéantar logánú a dhíchumasú go sainráite tríd an scagair:tfilter: unlocalize nó an chlibe:ttag: {% localize off%}\<localize\>, soláthraíonn sé formáidí logánaithe fillte a chuirfear i bhfeidhm ina ionad sin. Féach:ref: logánú a rialú i dteimpléid \<topic-l10n-templates\>\`le haghaidh sonraí.

Féach:ref: how django-discovers-language-preference le haghaidh tuilleadh sonraí.

### TEANGA\_FIANÁIN AOIS \`\`

Réamhshocraithe: `None` (in éag nuair a dhún an bhrabhsálaí)

Aois na fianán teanga, i soicindí.

### `TEANGA_FIANÁINE_FEARAIN`

Réamhshocraithe: Níl \`\`

An fearann le húsáid don fhianán teanga. Socraigh é seo go sreang mar `"example.com"` le haghaidh fianáin tras-fearainn, nó bain úsáid as None le haghaidh fianán fearainn caighdeánach.

Bí cúramach agus an suíomh seo á nuashonrú agat ar shuíomh táirgeachta. Má nuashonraíonn tú an socrú seo chun fianáin tras-fhearann a chumasú ar shuíomh a d'úsáid fianáin fearainn caighdeánacha roimhe seo, ní nuashonrófar fianáin úsáideora atá ann cheana a bhfuil an sean-fearainn Mar thoradh air seo ní bheidh úsáideoirí an láithreáin in ann an teanga a athrú chomh fada agus a leanfaidh na fianáin seo. Is é an t-aon rogha sábháilte agus iontaofa chun an lasc a dhéanamh ná ainm na fianán teanga a athrú go buan (tríd an socrú: LANGUAGE\_COOKIE\_NAME) agus meán-earraí a chur leis a chóipeálann an luach ón sean-fhianán go ceann nua agus ansin scriosann sé an seancheann.

### `TEANGA_FIANÁIN_HTTPONLY`

Réamhshocraithe: `Fréag`

Cibé acu an bhratach HttpOnly\` a úsáid ar an bhfianán teanga. Má tá sé seo socraithe ar `True`, ní bheidh JavaScript taobh an chliaint in ann rochtain a fháil ar an bhfianán teanga.

Féach: SETTING: SESSION\_COOKIE\_HTTPONLY le haghaidh sonraí ar HTTPONLY\`.

### `AINM_FIANÁIN TEANGA`

Réamhshocraithe: `'django_langue'`

Ainm na fianán atá le húsáid don fhianán teanga. Is féidir leis seo a bheith cibé rud is mian leat (fad is atá sé difriúil ó na hainmneacha fianán eile i d'iarratas). Féach: doc: /topics/i18n/index.

### `TEANGA_FIANÁIN BHEALAIGH`

Réamhshocraithe: `'/'`

An cosán atá leagtha síos ar an bhfianán teanga. Ba chóir go mbeadh sé seo comhoiriúnach le cosán URL do shuiteála Django nó a bheith ina thuismitheoir ar an gcosán sin.

Tá sé seo úsáideach má tá cásanna iolracha Django agat ag rith faoin ainm óstach céanna. Is féidir leo cosáin éagsúla fianán a úsáid agus ní fheicfidh gach cás ach a fianán teanga féin.

Bí cúramach agus an suíomh seo á nuashonrú agat ar shuíomh táirgeachta. Má nuashonraíonn tú an socrú seo chun cosán níos doimhne a úsáid ná mar a úsáideadh sé roimhe seo, ní nuashonrófar fianáin úsáideora atá ann cheana a bhfuil an sean-chosán Mar thoradh air seo ní bheidh úsáideoirí an láithreáin in ann an teanga a athrú chomh fada agus a leanann na fianáin seo. Is é an t-aon rogha sábháilte agus iontaofa chun an lasc a dhéanamh ná ainm na fianán teanga a athrú go buan (tríd an socrú: LANGUAGE\_COOKIE\_NAME), agus meán-earraí a chur leis a chóipeálann an luach ón sean-fhianán go ceann nua agus ansin scriosann sé an ceann.

### `TEANGA_FIANÁN_COMHCHOSAITHE`

Réamhshocraithe: Níl \`\`

Luach an bhratach [SameSite](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value) ar an bhfianán teanga. Cuireann an bratach seo cosc ar an bhfianán a sheoladh in iarratais tras-láithreáin.

Féach:SETTING: SESSION\_COOKIE\_SAMESITE le haghaidh sonraí faoi Samesite\`.

### `TEANGA_FIANÁINE_SLÁNDÁLA`

Réamhshocraithe: `Fréag`

Cibé acu fianán slán a úsáid don fhianán teanga. Má tá sé seo socraithe ar `True`, marcálfar an fianán mar “slán”, rud a chiallaíonn go bhféadfaidh brabhsálaithe a chinntiú nach seoltar an fianán ach faoi nasc HTTPS.

### TEANGACHA \`\`

Réamhshocraithe: Liosta de na teangacha go léir atá ar fáil. Tá an liosta seo ag fás i gcónaí agus is cinnte go mbeadh cóip a áireamh anseo as dáta go tapa. Is féidir leat an liosta reatha de na dteangacha aistrithe a fheiceáil trí:source: django/conf/global\_settings.py.

Is é an liosta de dhá thuples san fhormáid (:term: cód teanga \<language code\>, ```ainm teanga ``) -- mar shampla,``` ('ja', 'Seapáinis') . Sonraíonn sé seo cé na teangacha atá ar fáil le haghaidh roghnú teanga. Féach: doc: /topics/i18n/index.

Go ginearálta, ba chóir go leor an luach réamhshocraithe. Socraigh an socrú seo ach más mian leat roghnú teanga a theorannú go fo-thacar de na teangacha a sholáthraítear Django.

Má shainmhíníonn tú socrú saincheap:setting: LANGUAGES, is féidir leat na hainmneacha teanga a mharcáil mar teaghráin aistriúcháin ag baint úsáide as an bhfeidhm:func: ~django.utils.translation.gettext\_lazy.

Seo comhad socruithe samplach:

```
from django.utils.translation import gettext_lazy as _

LANGUAGES = [
    ("de", _("German")),
    ("en", _("English")),
]
```

### `TEANGACH_BIDI`

Réamhshocraithe: Liosta de na cóid teanga go léir atá scríofa ar dheis go clé. Is féidir leat an liosta reatha de na teangacha seo a fheiceáil trí:source: django/conf/global\_settings.py.

Tá an liosta: téarma: cóid teanga \<language code\>\`do theangacha atá scríofa ar dheis go clé.

Go ginearálta, ba chóir go leor an luach réamhshocraithe. Socraigh an socrú seo ach más mian leat roghnú teanga a theorannú go fo-thacar de na teangacha a sholáthraítear Django. Má shainmhíníonn tú socrú saincheap:setting: LANGUAGES, d'fhéadfadh go mbeadh cóid teanga nach bhfuil cumasaithe ar shuíomh ar leith i liosta na dteangacha déthreoracha.

### COSÁIN ÁITIÚLA \`\`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta d'eolairí ina bhfuil Django ag lorg comhaid aistriúcháin. Féach:ref: cona-django-aimsitheach-aistriúcháin.

Sampla:

```
LOCALE_PATHS = [
    "/home/www/project/common_files/locale",
    "/var/local/translations/locale",
]
```

Breathnóidh Django laistigh de gach ceann de na cosáin seo do na heolairí `<locale_code>/LC_MESSAGES` ina bhfuil na comhaid aistriúcháin iarbhír.

### LOGÁIL ISTEACH \`\`

Réamhshocraithe: Foclóir cumraíochta logála.

Struchtúr sonraí ina bhfuil faisnéis chumraíochta. Nuair nach bhfuil sé folamh, cuirfear ábhar an struchtúir sonraí seo ar aghaidh mar argóint chuig an modh cumraíochta a thuairiscítear in:setting: LOGGING\_CONFIG.

I measc rudaí eile, cuireann an chumraíocht logála réamhshocraithe earráidí freastalaí HTTP 500 chuig láimhseálaí logála ríomhphoist nuai:socrú: “DEBUG” ná False\`. Féach freis:ref: configuring-loging.

Is féidir leat an chumraíocht logála réamhshocraithe a fheiceáil trí fhéachaint isteach: source: django/utils/log.py.

### `LOGING_CONFIG`

Réamhshocraithe: `'Loging.config.dictConfig'`

Conair chuig glaoch a úsáidfear chun logáil isteach i dtionscadal Django a chumrú. \<logging-config-dictschema\>Pointí ag cás de Python's:ref: modh cumraíochta DictConfig de réir réamhshocraithe.

Má shocraíonn tú: socrú: LOGGING\_CONFIG go `None`, scipeánfar an próiseas cumraíochta logála.

### BAINISTEOIRÍ \`\`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta san fhormáid chéanna amha:setting: ADMINS a shonraíonn cé ar chóir fógraí nasc briste a fháil nuai:class: ~django.middleware.common.BrokenLinkemailsMiddleware cumasaithe.

### `MEDIA_FRÉAMH`

Réamhshocraithe: "(Sreang folamh)

Conair iomlán córas comhaid chuig an eolaire a bheidh ina choimeád:doc: comhaid uaslódáilte úsáideora . \</topics/files\>

Sampla: `” /var/www/example.com/media/"`

Féach freis:socrú: MEDIA\_URL.

> **Warning**
>
> [`MEDIA_ROOT`](#std-setting-MEDIA_ROOT) and [`STATIC_ROOT`](#std-setting-STATIC_ROOT) must have different
> values. Before [`STATIC_ROOT`](#std-setting-STATIC_ROOT) was introduced, it was common to
> rely or fallback on [`MEDIA_ROOT`](#std-setting-MEDIA_ROOT) to also serve static files;
> however, since this can have serious security implications, there is a
> validation check to prevent it.

### MEDIA\_URL \`\`

Réamhshocraithe: "(Sreang folamh)

URL a láimhseálann na meáin a sheirbheáiltear ó:setting: MEDIA\_ROOT, a úsáidtear le haghaidh: doc: comhaid stóráilte \</topics/files\> a bhainistiú. Caithfidh sé deireadh a chur le slasc má tá sé socraithe ar luach neamh-folamh. Beidh ort: ref: na comhaid seo a chumrú le seirbheáil \<serving-uploaded-files-in-development\>\`i dtimpeallachtaí forbartha agus táirgeachta araon.

Más mian leat `{{MEDIA_URL}}` a úsáid i do theimpléid, cuir django.template.context\_processors.media' sa rogha context\_processors' de:setting: TEMPLATES.

Sampla: `” https://media.example.com/ “`

> **Warning**
>
> Tá rioscaí slándála ann má tá tú ag glacadh le hábhar uaslódáilte ó úsáideoirí neam Féach ábhar an treoir slándála ar:ref: user-uploaded-content-security le haghaidh sonraí maolaithe.

> **Warning**
>
> [`MEDIA_URL`](#std-setting-MEDIA_URL) and [`STATIC_URL`](#std-setting-STATIC_URL) must have different
> values. See [`MEDIA_ROOT`](#std-setting-MEDIA_ROOT) for more details.

> **Note**
>
> Más: Socrú: Is cosán coibhneasta é MEDIA\_URL, ansin déanfar é a réamhshocrú ag an luach `SCRIPT_NAME` a sholáthraíonn an freastalaí (nó `/` mura bhfuil sé socraithe). Fágann sé seo go bhfuil sé níos éasca feidhmchlár Django a sheirbheáil i bhfochonair gan cumraíocht bhreise a chur leis na socruithe.

### MEÁN-EARRAÍ \`\`

Réamhshocraithe: Níl \`\`

Liosta de mheán-earraí le húsáid. Féach: doc: /topics/http/middleware .

### `MODÚL_IMIRCE`

Réamhshocraithe: `{}` (Foclóir folamh)

Foclóir a shonraíonn an pacáiste inar féidir modúil imirce a fháil ar bhonn in aghaidh an aip. Is foclóir folamh é luach réamhshocraithe an socrú seo, ach is é “imirceacháin” ainm an phacáiste réamhshocraithe do mhodúil imirce.

Sampla:

```
{"blog": "blog.db_migrations"}
```

Sa chás seo, beidh imirce a bhaineann leis an aip `blog` sa phacáiste `blog.db_migrations`.

Má sholáthraíonn tú an argóint `app_label`, cruthóidh: djadmin: makemigrations an pacáiste go huathoibríoch mura bhfuil sé ann cheana féin.

Nuair a sholáthraíonn tú `None` mar luach d'aip, measfaidh Django an aip mar aip gan imirce beag beann ar fho-mhodúl `imirce` atá ann cheana. Is féidir é seo a úsáid, mar shampla, i gcomhad socruithe tástála chun imirce a scipeáil agus tú ag tástáil (cruthófar táblaí fós do mhúnlaí na n-aipeanna). Chun imirce do gach aip a dhíchumasú le linn tástálacha, is féidir leat an: socrú: MIGRATE \`go \`False\`\<TEST\_MIGRATE\> ina ionad. Má úsáidtear `MIGRATION_MODULES` i do shocruithe ginearálta tionscadail, cuimhnigh an roghna:option: migration --run-syncdb a úsáid más mian leat táblaí a chruthú don aip.

### `FORMÁID_LAETH_MHÍ`

Réamhshocraithe: `'F j'`

An formáidiú réamhshocraithe le húsáid le haghaidh réimsí dáta ar leathanaigh liosta athraithe riaracháin Django - agus, b'fhéidir, ag codanna eile den chóras - i gcásanna nach dtaispeántar ach an mhí agus an lá.

Mar shampla, nuair a bhíonn leathanach liosta athraithe riaracháin Django á scagadh ag druileáil dáta, taispeánann an ceannteideal do lá ar leith an lá agus an mhí. Tá formáidí éagsúla ag áitiúla éagsúla. Mar shampla, déarfadh Béarla na SA “1 Eanáir,” ach d'fhéadfadh an Spáinnis a rá “1 Enero.”

Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid chomhfhreagrach áitiúil agus go gcuirfear i bhfeidhm ina ionad.

\<date\>Féach: TFilter: teaghráin formáid dáta ceadaithe \`. Féach freis:socrú: \`DATE\_FORMAT, :setting: DATETIME\_FORMAT, :setting: TIME\_FORMAT agus:setting: YEAR\_MONTH\_FORMAT.

### UIMHREACH\_GHRÚPÁIL \`\`

Réamhshocraithe: `0`

Líon na ndigití atá grúpáilte le chéile ar an gcuid sláireach d'uimhir.

Úsáid choitianta ná míle deighilteoir a thaispeáint. Más é an socrú seo `0`, ansin ní chuirfear aon ghrúpáil i bhfeidhm ar an uimhir. Má tá an socrú seo níos mó ná 0\`, ansin úsáidfear: setting: THOUSAND\_SEPARATOR mar an deighilteoir idir na grúpaí sin.

Úsáideann roinnt áiteanna grúpáil dhigit neamh-aonfhoirmeach, m.sh. `10,00,00,000` i En\_in\`. Maidir leis an gcás seo, is féidir leat seicheamh a sholáthar le líon na méideanna grúpa dhigit atá le cur i bhfeidhm. Sainmhíníonn an chéad uimhir méid an ghrúpa roimh an teorannach deachúil, agus sainmhíníonn gach uimhir a leanann méid na ngrúpaí roimhe seo. Má chuirtear deireadh leis an seicheamh le `-1`, ní dhéantar aon ghrúpáil bhreise. Má chríochnaíonn an seicheamh le `0`, úsáidtear méid an ghrúpa deireanach don chuid eile den uimhir.

Sampla tuple le haghaidh `en_in`:

```
NUMBER_GROUPING = (3, 2, 0)
```

Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin.

Féach freis:socrú: DECIMAL\_SEPARATOR, :setting: THOUSAND\_SEPARATOR agus:setting: USE\_THOUSAND\_SEPARATOR.

### `PREPEND_WWW`

Réamhshocraithe: `Fréag`

Cibé an ndéanfar an fo-fhearann “www.” a phleanáil chuig URLanna nach bhfuil sé acu. Ní úsáidtear é seo ach má tá: class: ~django.middleware.common.commonMiddleware suiteáilte (féach: doc: /topics/http/middleware). Féach freis:socrú: APPEND\_SLASH.

### `ROOT_URLCONF`

Réamhshocrú: Gan sainmhíniú

Sreang a léiríonn an cosán iomlán allmhairithe Python chuig do URLConf fréimhe, mar shampla ```"mydjangoapps.urls"`. Is féidir é a shárú ar bhonn in aghaidh iarratais tríd an tréith ``urlconf``` a shocrú ar an réad `HttpRequest` atá ag teacht isteach. Féach: ref: how django-processes-a-request le haghaidh sonraí.

### `EOCHAIR_RÚNA`

Réamhshocraithe: "(Sreang folamh)

Eochair rúnda do shuiteáil Django áirithe. Úsáidtear é seo chun: doc: síniú cripteagrafach' a sholáthar, agus ba chóir é a shocrú go luach u\</topics/signing\> athúil, nach féidir a thuar.

[`django-admin startproject`](/ga/5.2/ref/django-admin/#django-admin-startproject) automatically adds a
randomly-generated `SECRET_KEY` to each new project.

Níor chóir go nglacfadh úsáidí an eochair leis gur téacs nó beáit é. Ba chóir go mbeadh gach úsáid trí:func: ~django.utils.encoding.force\_str nó: func: ~django.utils.encoding.force\_bytes chun é a thiontú go dtí an cineál atá ag teastáil.

Diúltóidh Django tosú mura bhfuil: setting: SECRET\_KEY socraithe.

> **Warning**
>
> \*\* Coinnigh an luach seo faoi rún. \*\*
>
> Scaoileann Django ag rith le: socrú: SECRET\_KEY go leor de chosaintí slándála Django, agus d'fhéadfadh méadú pribhléid agus leochaileachtaí forghníomhú iargúlta cód a bheith mar thoradh air.

Úsáidtear an eochair rúnda le haghaidh:

- All:doc: sessions má tá aon chúltaca seisiúin eile á úsáid agat seachas `django.contrib.sessions.backends.cache` \</topics/http/sessions\>, nó má tá tú ag úsáid an réamhshocraithe:meth: ~django.contrib.auth.models.abstractbaseUser.get\_session\_auth\_hash () .
- Gach: Doc: teachtaireachtaí \`má tá tú ag baint úsáide:class: \`~django.contrib.messages.storage.cookie.cookieStorage nó\</ref/contrib/messages\> :class: ~django.contrib.messages.storage.fallback.fallbackStorage.
- Gach: Class: comharthaí ~django.contrib.auth.views.passwordResetView.
- Aon úsáid ar:doc: síniú cripteagrafach', mura gcuirtear eochair dhifriúil ar fáil. \</topics/signing\>

Nuair nach bhfuil eochair rúnda socraithe a thuilleadh mar: setting: SECRET\_KEY nó atá ann laistigh de: setting: SECRET\_KEY\_FALLBACKS beidh gach ceann de na rudaí thuas neamhbhailí. Agus do eochair rúnda á rothlú agat, ba chóir duit an sean-eochair a bhogadh chuig: setting: SECRET\_KEY\_FALLBACKS go sealadach. Ní úsáidtear eochracha rúnda le haghaidh pasfhocail úsáideoirí agus ní bheidh tionchar ag rothlú eochair orthu.

> **Note**
>
> \<startproject\>Cruthaíonn an comhad réamhshocraithe:file: settings.py a chruthaí:djadmin: django-admin startproject \`uathúil \`\`SECRET\_KEY\` le haghaidh áisiúlachta.

### `EOCHAIR_FALLBACKS`

Réamhshocraithe: `[]`

Liosta d'eochracha rúnda tagtha le haghaidh suiteáil Django áirithe. Úsáidtear iad seo chun rothlú an `SECRET_KEY` a cheadú.

D'fhonn d'eochracha rúnda a rothlú, socraigh `SECRET_KEY` nua agus bog an luach roimhe seo go dtí tús `SECRET_KEY_FALLBACKS`. Ansin bain na seanluachanna ó dheireadh an `SECRET_KEY_FALLBACKS` nuair a bheidh tú réidh chun na seisiúin, na comharthaí athshocraithe pasfhocal, agus mar sin de, a úsáideann iad a chur in éag.

> **Note**
>
> Tá oibríochtaí sínithe costasach go ríomhaireachta. Cuireann sean-eochrluachanna iolracha agat i `SECRET_KEY_FALLBACKS` lasbhreas breise le gach seiceáil nach n-oireann le heochair níos luaithe.
>
> Dá bhrí sin, ba cheart luachanna titim a bhaint tar éis tréimhse chuí, rud a cheadaíonn rothlú eochair.

Níor chóir go nglacfadh úsáidí na príomhluachanna rúnda leis gur téacs nó béite iad. Ba chóir go mbeadh gach úsáid trí:func: ~django.utils.encoding.force\_str nó: func: ~django.utils.encoding.force\_bytes chun é a thiontú go dtí an cineál atá ag teastáil.

### `CINEÁL_ÁBHAR SLÁNDÁILTE_NOSNIFF`

Réamhshocraithe: Fíor\`

Má tá `True`, socraíonn an:class: ~django.middleware.securityMiddleware ceannteideal: :ref: x-content-type-options ar gach freagra nach bhfuil sé ann cheana féin.

### BEARTAS OSCAILTEOIREACH\_THRAS\_BUNAIDH SLÁNDÁILTE \`\`

Réamhshocraithe: bhunús céann'

Mura bhfuil sé socraithe ar `None`, socraíonn an:class: ~django.middleware.securityMiddleware an ceannteideal: :ref: cross-origin-opener-policy ar gach freagra nach bhfuil sé ar an luach a chuirtear ar fáil cheana féin.

### `SLÁNDA_HSTS_INCLUDE_SUBDOMAINS`

Réamhshocraithe: `Fréag`

Má tá `True`, cuireann an:class: ~django.middleware.securityMiddleware an treoir includeSubdomains\` leis an gceannteideal: http-strict-transport-security. Níl aon éifeacht aige gan leith:leagtar síos: SECURE\_HSTS\_SECONDS socraítear go luach neamh-nialasach.

> **Warning**
>
> Má shocraíonn sé seo go mícheart is féidir le do shuíomh a bhriseadh go neamh-inchúlghabháilte (maidir le luach: SETING: SECURE\_HSTS\_SECONDS). Léigh an doiciméad:ref: http-strict-transport-security ar dtús.

### `SLÁNDA_HSTS_PRELOAD`

Réamhshocraithe: `Fréag`

Má tá `True`, cuireann an:class: ~django.middleware.securityMiddleware an treoir `preload` leis an gceannteideal: http-strict-transport-security. Níl aon éifeacht aige gan leithéid: socraítear SECURE\_HSTS\_SECONDS go luach neamh-nialasach.

### `SLÁNDA_HSTS_SOICIND`

Réamhshocraithe: `0`

Má tá luach sláimhir neamh-nialasach leagtha síos, socraíonn an ceannteideal: :ref: http-strict-transport-security ar gach freagra nach bhfuil sé ann cheana féin.

> **Warning**
>
> Is féidir é seo a shocrú go mícheart do shuíomh a bhriseadh go dochreidte (ar feadh tamaill). Léigh an doiciméad:ref: http-strict-transport-security ar dtús.

### `SLÁNT_PROXY_SSL_HEADER`

Réamhshocraithe: Níl \`\`

Tuple a léiríonn teaglaim ceannair/luach HTTP a thugann le fios go bhfuil iarratas slán. Rialaíonn sé seo iompar modh is\_secure () an réad iarratais.

De réir réamhshocraithe, cinneann ```is_secure () ``an bhfuil iarratas slán trí dheimhniú go n-úsáideann URL iarrtha ``https: //```. Tá an modh seo tábhachtach do chosaint CSRF Django, agus féadfaidh do chód féin nó aipeanna tríú páirtí é a úsáid.

Má tá d'aip Django taobh thiar de sheachfhreastalaí, áfach, b'fhéidir go bhfuil an seachfhreastalaí ag “shlogadh” cibé an úsáideann an t-iarratas bunaidh HTTPS nó nach Má tá nasc neamh-HTTPS idir an seachfhreastalaí agus Django ansin chuirfeadh ```is_secure () ``ar ais ``False``` i gcónaí - fiú le haghaidh iarratais a rinne an t-úsáideoir deiridh trí HTTPS. I gcodarsnacht leis sin, má tá nasc HTTPS idir an seachfhreastalaí agus Django ansin chuirfeadh ```is_secure () ``ar ais ``True``` i gcónaí - fiú le haghaidh iarratais a rinneadh ar dtús trí HTTP.

Sa chás seo, cumraigh do sheachfhreastalaí chun ceanntásc saincheaptha HTTP a shocrú a insíonn do Django an tháinig an t-iarratas isteach trí HTTPS, agus socraigh `SECURE_PROXY_SSL_HEADER` ionas go mbeidh a fhios ag Django cén ceannteideal atá le lorg.

Socraigh tuple le dhá ghné - ainm an cheanntásc le cuardach agus an luach riachtanach. Mar shampla:

```
SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
```

Deir sé seo le Django muinín a bheith agat as an gceannteideal `X-Forwarded-Proto` a thagann ónár seachfhreastalaí agus go ráthaítear go mbeidh an t-iarratas slán (ie, tháinig sé isteach ar dtús trí HTTPS) nuair:

- is é an luach ceanntásc `'https'`, nó
- is é a luach tosaigh, is clé ná `'https'` i gcás liosta prótacail scartha le camóg (m.sh. `` `https, http, http' ``).

Ba chóir duit\* ach an socrú seo a shocrú má rialaíonn tú do sheachfhreastalaí nó má tá ráthaíocht éigin eile agat go socraí/stiallann sé an ceannteideal seo go cuí.

Tabhair faoi deara go gcaithfidh an ceannteideal a bheith sa fhormáid mar a úsáideann `Request.meta` \- gach caipín agus is dócha go dtosaíonn le `HTTP_`. (Cuimhnigh, cuireann Django `'HTTP_'` go huathoibríoch le tús ainmneacha x-cheannteideal sula gcuireann an ceannteideal ar fáil i `Request.meta`.)

> **Warning**
>
> \*\* Féadfaidh an socrú seo a mhodhnú slándáil do shuíomh a chur i gcur Cinntigh go dtuigeann tú do shocrú go hiomlán sula n-athraíonn tú \*\*
>
> Déan cinnte go bhfuil GACH ceann de na rudaí seo a leanas fíor sula gcuirtear é seo a shocrú (glacadh leis na luachanna ón sampla thuas
>
> - Tá d'aip Django taobh thiar de sheachfhreastalaí.
> - Stíorálann do sheachfhreastalaí an ceannteideal `X-Forwarded-Proto` ó gach iarratas atá ag teacht isteach, fiú nuair a bhíonn liosta prótacail scartha le camóg ann. Is é sin le rá, má chuimsíonn úsáideoirí deiridh an ceanntásc sin ina n-iarratais, caithfidh an seachfhreastalaí é.
> - Socraíonn do sheachfhreastalaí an ceannteideal `X-Forwarded-Proto` agus seolann sé chuig Django é, ach amháin le haghaidh iarratais a thagann isteach trí HTTPS ar dtús.
>
> Mura bhfuil aon cheann acu sin fíor, ba cheart duit an socrú seo a choinneáil socraithe go None agus bealach eile a fháil chun HTTPS a chinneadh, b'fhéidir trí mheán-earraí saincheaptha.

### `SLÁNDA_ATHREDIRECT_EISEOLÚINT`

Réamhshocraithe: `[]` (Liosta folamh)

Má mheaitseálann cosán URL le léiriú rialta sa liosta seo, ní atreorófar an t-iarratas chuig HTTPS. Stíleann an: Class: ~django.middleware.security.securityMiddleware slascanna a threoraíonn ó chosáin URL, mar sin níor cheart iad a bheith san áireamh ar phatrúin, m.sh. SECURE\_REDIRECT\_EXEMPT = \[r'^no-ssl/$',...\] \`. Má tá: SETTING: SECURE\_SSL\_REDIRECT `False`, níl aon éifeacht ag an socrú seo.

### `BEARTAS ATREORÓIR_SLÁNDÁLA`

Réamhshocraithe: bhunús céann'

Má tá sé cumraithe, socraíonn an:class: ~django.middleware.securityMiddleware an ceannteideal: ref: referrer-policy ar gach freagra nach bhfuil sé ar an luach a chuirtear ar fáil cheana féin.

### `SSL_ÓST_SÁBHÁILTE`

Réamhshocraithe: Níl \`\`

Má tá teaghrán ann (m.sh. secure.example.com\`), déanfar gach athsheoladh SSL a threorú chuig an óstach seo seachas an t-óstach a iarrtar bunaidh (m.sh. `www.example.com`). Má tá: SETTING: SECURE\_SSL\_REDIRECT `False`, níl aon éifeacht ag an socrú seo.

### `SECURE_SSL_REDIRECT`

Réamhshocraithe: `Fréag`

\<ssl-redirect\>Má tá `True`, an:class: ~django.middleware.securityMiddleware atreoraíonn \`gach iarratas neamh-HTTPS chuig HTTPS (ach amháin na URLanna sin a mheaitseálann le abairt rialta atá liostaithe in:setting: \`SECURE\_REDIRECT\_EXEMPT).

> **Note**
>
> Má chruthaíonn athatreoruithe gan teorainn é seo a chasadh go True\`, is dócha go bhfuil do shuíomh ag rith taobh thiar de seachfhreastalaí agus nach féidir leo a rá cé na hiarratais atá slán agus cé nach bhfuil. Is dócha go socraíonn do sheachfhreastalaí ceanntásc chun iarrataí slán a chur in iúl; is féidir leat an fhadhb a cheartú trí fháil amach cad é an ceannteideal sin agus an socrú:setting: SECURE\_PROXY\_SSL\_HEADER a chumrú dá réir.

### `MODÚL_SRAITHEACH`

Réamhshocrú: Gan sainmhíniú

Foclóir modúil ina bhfuil sainmhínithe serializer (curtha ar fáil mar teaghráin), eochairte ag aitheantóir teaghrán don chineál sraitheach sin. Mar shampla, chun serializer YAML a shainiú, bain úsáid as:

```
SERIALIZATION_MODULES = {"yaml": "path.to.yaml_serializer"}
```

### `FREASTALAÍ_RÍOMHPHOST`

Réamhshocraithe: `'root @localhost '`

An seoladh ríomhphoist as a dtagann teachtaireachtaí earráide, mar shampla iad siúd a sheoltar chuig:setting: ADMINS agus:setting: MANAGERS. Úsáidtear an seoladh seo sa cheanntásc From: agus féadann sé aon fhormáid a ghlacadh bailí sa phrótacal seolta ríomhphoist roghnaithe.

> **Cén fáth a sheoltar mo ríomhphoist ó sheoladh difriúil?**
>
> This address is used only for error messages. It is *not* the address that
> regular email messages sent with [`send_mail()`](/ga/5.2/topics/email/#django.core.mail.send_mail)
> come from; for that, see [`DEFAULT_FROM_EMAIL`](#std-setting-DEFAULT_FROM_EMAIL).

### `FORMÁID_DÁTA_GEARR`

Réamhshocraithe: `` `M/D/Y' `` (m.sh. 12/31/2003 )

Formáidiú atá ar fáil is féidir a úsáid chun réimsí dáta a thaispeáint ar theimpléid. Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid chomhfhreagrach áitiúil agus go gcuirfear i bhfeidhm ina ionad. \<date\>Féach: TFilter: teaghráin formáid dáta ceadaithe .

Féach freis:socrú: DATE\_FORMAT agus:socrú: SHORT\_DATETIME\_FORMAT.

### `FORMÁID_DÁTA GEARRTHA`

Réamhshocraithe: `` `M/D/Y P' `` (m.sh. `12/31/2003 4 p.m.`)

Formáidiú atá ar fáil is féidir a úsáid chun réimsí dáta-ama a thaispeáint ar theimpléid. Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid chomhfhreagrach áitiúil agus go gcuirfear i bhfeidhm ina ionad. \<date\>Féach: TFilter: teaghráin formáid dáta ceadaithe .

Féach freis:socrú: DATE\_FORMAT agus:socrú: SHORT\_DATE\_FORMAT.

### `SIGNED_COOKIE_LEGACY_SALT_FALLBACK`

> **New in Django 5.2.15**

Réamhshocraithe: Fíor\`

Controls whether [`get_signed_cookie()`](/ga/5.2/ref/request-response/#django.http.HttpRequest.get_signed_cookie) accepts
cookies signed with Django's historical signed-cookie salt derivation based on
`key + salt`.

Set this to `False` to reject those legacy signed cookies and only accept
cookies signed with Django's current unambiguous signed-cookie salt derivation.
This transitional setting will be removed in Django 7.0, when the legacy signed
cookies will no longer be accepted.

### `` `SIGNING_BACKEND ``

Réamhshocraithe: Django.Core.Signing.TimeStampSigner'\` \`

An cúltaca a úsáidtear chun fianáin agus sonraí eile a shíniú.

Féach freisin an doiciméadach:doc: /topics/signing.

### SEICEÁLACH\_CHÓRAIS CIOSTAITHE \`\`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta d'aitheantóirí teachtaireachtaí a ghineann creat seiceála an chórais (ie \["Models.W001"\] ) ar mhaith leat aitheantas a thabhairt go buan agus neamhaird a dhéanamh orthu. Ní aschur seiceálacha ciúnaithe chuig an gconsól.

Féach freisin an doiciméadach:doc: /ref/checks.

### `STÓRÁLAÍ`

Réamhshocraithe:

```
{
    "default": {
        "BACKEND": "django.core.files.storage.FileSystemStorage",
    },
    "staticfiles": {
        "BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
    },
}
```

Foclóir ina bhfuil na socruithe do gach stóráil le húsáid le Django. Is foclóir neadaithe é a léarscáil a n-ábhar ailias stórála chuig foclóir ina bhfuil na roghanna le haghaidh stórála aonair.

Is féidir le stórais aon alias a roghnaíonn tú a bheith acu. Mar sin féin, tá dhá ainm le tábhacht speisialta:

- `default` le haghaidh: doc: ``````` comhaid a bhainistiú' </topics/files>. `````` ``````` Django.Core.Files.Storage.FileSystemStorageis é an t-inneall stórála réamhshocraithe.
- `staticfiles` le haghaidh: doc: ``````` comhaid statacha a bhainistiú' </ref/contrib/staticfiles>. `````` ``````` Django.contrib.staticFiles.Storage.staticFilesStorageis é an t-inneall stórála réamhshocraithe.

Seo a leanas sampla `settings.py` snippet a shainmhíníonn stóráil comhaid saincheaptha ar a dtugtar `example`:

```
STORAGES = {
    # ...
    "example": {
        "BACKEND": "django.core.files.storage.FileSystemStorage",
        "OPTIONS": {
            "location": "/example",
            "base_url": "/example/",
        },
    },
}
```

Cuirtear `ROGHANN` chuig an BACKEND\` ar thionscnamh i \*\*kwargs\`.

Is féidir sampla réidh le húsáid de na cúltaca stórála a aisghabháil ó:data: django.core.files.storage.storages. Úsáid eochair a fhreagraíonn don sainmhíniú cúltaca in:setting: STORAGES.

> **An bhfuil mo luach cumaisc leis an luach réamhshocraithe?**
>
> Sáraíonn an socrú seo a shainiú an luach réamhshocraithe agus níl\* níl\* cumasc leis.

### `TEIMPLÉID`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta ina bhfuil na socruithe do gach innill teimpléad le húsáid le Django. Is foclóir é gach mír den liosta ina bhfuil na roghanna le haghaidh inneall aonair.

Seo socrú a insíonn d'inneall teimpléid Django teimpléid a luchtú ón bhfo-eolaire teimpléid taobh istigh de gach feidhmchlár suiteáilte:

```
TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "APP_DIRS": True,
    },
]
```

Tá na roghanna seo a leanas ar fáil do gach cúltaca.

#### `` `CÚLT ``

Réamhshocrú: Gan sainmhíniú

An cúltaca teimpléad le húsáid. Is iad na cúltaca teimpléad ionsuite:

- `` `Django.Template.Backends.Django.DjangoTemplates' ``
- `` `Django.Template.Backends.Jinja2.Jinja2' ``

Is féidir leat cúltaca teimpléad nach seolann le Django a úsáid trí `BACKEND` a shocrú go cosán láncháilithe (ie `` `MyPackage.whatever.backend' ``).

#### AINM \`

Réamhshocraithe: féach thíos

An alias don inneall teimpléad áirithe seo. Is aitheantóir é a cheadaíonn inneall a roghnú le haghaidh rindreála. Caithfidh ainmneacha a bheith uathúil ar fud gach innill teimpléad cumraithe

Réamhshocraíonn sé ainm an mhodúil a shainníonn rang an innill, i.e. an chéad phíosa deireanach de: setting: BACKEND \<TEMPLATES-BACKEND\>, nuair nach gcuirtear ar fáil é. Mar shampla más é `'MyPackage.whatever.backend'` an cúltaca ansin is é whatever'\` a ainm réamhshocraithe.

#### `` `DIRS ``

Réamhshocraithe: `[]` (Liosta folamh)

Eolairí inar chóir don inneall comhaid foinse teimpléad a lorg, in ord cuardaigh.

#### `APP_DIRS`

Réamhshocraithe: `Fréag`

Cibé an chóir don inneall comhaid foinse teimpléad a lorg taobh istigh d'fheidhmchlá

> **Note**
>
> \<startproject\>Leagann an comhad réamhshocraithe:file: settings.py a chruthaí:djadmin: django-admin startproject \`\`\`\`APP\_DIRS': True\`.

#### `ROGHANNAÍ`

Réamhshocraithe: `{}` (Ordú folamh)

Paraiméadair bhreise le dul chuig an gcúltaca teimpléid. Athraíonn paraiméadair atá ar fáil ag brath ar an gcúl teimpléid Féach: Class: ~django.template.backends.django.djangoTemplates agus:class: ~django.template.backends.jinja2.jinja2 le haghaidh roghanna na gcúltaca ionsuite.

### `TÁST_RUNNER`

Réamhshocraithe: Django.Test.Runner.DiscoverRunner'\` \`

Ainm an ranga le húsáid chun an tsraith tástála a thosú. Féach: ref: creataí tástála eile'.

### `TÁSTÁIL_NEAM_AIPEANNA SRAITHEACH`

Réamhshocraithe: `[]` (Liosta folamh)

D'fhonn stát an bunachar sonraí a athbhunú idir tástálacha do TransactionTestCase\` agus cúltaca bunachar sonraí gan idirbhearta, déanfaidh Django: ref: sraitheadh ábhar na n-aipeanna uile \<test-case-serialized-rollback\>\`nuair a thosaíonn sé an rith tástála ionas gur féidir leis an gcóip sin a athluchtú sula ndéanann sé tástálacha a theastaíonn uathu.

Moillíonn sé seo am tosaithe an rádálaí tástála; má tá aipeanna agat a fhios uait nach dteastaíonn an ghné seo uathu, is féidir leat a n-ainmneacha iomlána a chur anseo (m.sh. `django.contrib.contenttypes`) chun iad a eisiamh ón bpróiseas sraitheach seo.

### MÍLTE DEIGHILTEOIR \`\`

Réamhshocraithe: ', '(Coma)

Míle deighilteoir réamhshocraithe a úsáidtear agus u Ní úsáidtear an socrú seo ach nuair:setting: USE\_THOUSAND\_SEPARATOR `True` agus:setting: NUMBER\_GROUPING níos mó ná `0`.

Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin.

Féach freis:socrú: NUMBER\_GROUPING, :setting: DECIMAL\_SEPARATOR agus:setting: USE\_THOUSAND\_SEPARATOR.

### `FORMÁID_AIM`

Réamhshocraithe: `'P'` (m.sh. `4 p.m.`)

An formáidiú réamhshocraithe le húsáid chun réimsí ama a thaispeáint in aon chuid den chóras. Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin. \<date\>Féach: TFilter: teaghráin formáid dáta ceadaithe .

Féach freis:socrú: DATE\_FORMAT agus:socrú: DATETIME\_FORMAT.

### FORMÁID\_IONCHUIR\_AMA \`\`

Réamhshocraithe:

```
[
    "%H:%M:%S",  # '14:30:59'
    "%H:%M:%S.%f",  # '14:30:59.000200'
    "%H:%M",  # '14:30'
]
```

Liosta de na formáidí a nglacfar leo agus sonraí á ionchur isteach ar réimse ama. Déanfar triail a bhaint as formáidí in ord, ag baint úsáide as an gcéad cheann bailí. Tabhair faoi deara go n-úsáideann na teaghráin formáide seo comhréir modúl Python: ref: datetime '\<strftime-strptime-behavior\>, ní na teaghráin formáide ón scagaire teimpléad:tfilter: \`dáta.

Tá tosaíocht níos airde ag an bhformáid áitiúil agus cuirfear i bhfeidhm ina ionad sin.

Féach freisin: socrú: DATE\_INPUT\_FORMATS agus:setting: DATETIME\_INPUT\_FORMATS.

### `CRIOS_AMA`

Réamhshocraithe: `'Meiriceá/Chicago'`

Sreang a léiríonn an crios ama don suiteáil seo. Féach an [liosta criosanna ama](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).

> **Note**
>
> Ós rud é gur eisíodh Django den chéad uair leis an: setting: TIME\_ZONE socraithe go ``'America/Chicago'`, fanann an suíomh domhanda (a úsáidtear mura bhfuil aon rud sainmhínithe i `settings.py`` do thionscadail) ```Meiricea/Chicago'` le haghaidh comhoiriúnacht ar ais. Teimpléid nua tionscadail réamhshocraithe go ``'UTC'```.

Tabhair faoi deara nach gá gurb é seo crios ama an fhreastalaí. Mar shampla, féadfaidh freastalaí amháin freastal ar iliomad suíomhanna faoi thiomáint Django, gach ceann acu le socrú crios ama ar leithligh.

Nuair: SETTING: Is é USE\_TZ `False`, is é seo an crios ama ina stóráilfidh Django gach dáta ama. Nuair: SETTING: Is é USE\_TZ `True`, is é seo an crios ama réamhshocraithe a úsáidfidh Django chun dáta-amanna a thaispeáint i dteimpléid agus chun dáta a iontráiltear i bhfoirmeacha a léirmhíniú.

Ar thimpeallachtaí Unix (áit a chuirtear: func: time.tzset i bhfeidhm), socraíonn Django an athróg ```os.environ ['TZ'] ``don chrios ama a shonraíonn tú sa socrú: `TIME_ZONE`. Mar sin, oibreoidh do thuairimí agus samhlacha go léir go huathoibríoch sa chrios ama seo. <settings-without-django-settings-module>Mar sin féin, ní shocróidh Django an t-athróg comhshaoil ``TZ``` má tá an rogha cumraíochta láimhe á úsáid agat mar a thuairiscítear in:ref: socruithe a chumrú de láimh \`. Mura socraíonn Django an t-athróg comhshaoil \`\`TZ, is fútsa atá sé a chinntiú go bhfuil do phróisis ag rith sa timpeallacht cheart.

> **Note**
>
> Ní féidir le Django criosanna ama malartacha a úsáid go hiontaofa i dtimpeallacht Windows. Má tá Django á reáchtáil agat ar Windows, caithfear :setting: TIME\_ZONE a shocrú chun crios ama an chórais a mheaitseáil.

### `USE_I18N`

Réamhshocraithe: Fíor\`

Boolean a shonraíonn an chóir córas aistriúcháin Django a chumasú. Soláthraíonn sé seo bealach chun é a mhúchadh, le haghaidh feidhmíochta. Má shocraítear é seo go False, déanfaidh Django roinnt optamaithe ionas nach luchtfaidh sé an t-innealra aistriúcháin.

Féach freis:socrú: LANGUAGE\_CODE agus:socrú: USE\_TZ.

> **Note**
>
> \<startproject\>Cuimsíonn an comhad réamhshocraithe:file: settings.py a chruthaí:djadmin: django-admin startproject \`\`\`USE\_I18N = True\` le haghaidh áisiúlachta.

### ÚSÁID\_MÍLTE DEIGHILTEOIR \`\`

Réamhshocraithe: `Fréag`

Boolean a shonraíonn an bhfuil uimhreacha le taispeáint ag baint úsáide as míle deighilteoir. Nuair a bheidh sé socraithe go `True`, déanfaidh Django uimhreacha a fhormáidiú ag baint úsáide as socruithe:: NUMBER\_GROUPING agus:setting: THOUSAND\_SEPARATOR. Is féidir leis an áitiúil a shocrú an dá shocrú deireanach freisin, a ghlacann tosaíocht.

Féach freis:socrú: DECIMAL\_SEPARATOR, :setting: NUMBER\_GROUPING agus:setting: THOUSAND\_SEPARATOR.

### ÚSÁID\_TZ \`\`

Réamhshocraithe: Fíor\`

Boolean a shonraíonn an mbeidh amanna dáta ar an eolas ó chrios ama de réir réamhshocraithe nó nach bhfuil. Má tá sé seo socraithe go `True`, úsáidfidh Django amanna dáta atá ar an eolas faoi chrios ama go hinmheánach.

Nuair a bhíonn USE\_TZ\` bréagach, úsáidfidh Django amanna dáta naif in am áitiúil, ach amháin nuair a dhéantar teaghráin formáidithe ISO 8601 á pháirseáil, áit a gcoinneofar faisnéis crios ama i gcónaí má tá sé i láthair.

Féach freis:socrú: TIME\_ZONE agus:socrú: USE\_I18N.

### `ÚSÁID_X_FORWARDED_ÓST`

Réamhshocraithe: `Fréag`

Boolean a shonraíonn an gceanntásc `X-Forwarded-Host` a úsáid mar rogha ar an gceannteideal `Host`. Níor chóir é seo a chumasú ach amháin má tá seachfhreastalaí a leagann an ceanntásc seo in úsáid.

Glacann an socrú seo tosaíocht thair:setting: USE\_X\_FORWARDED\_PORT. Per:RFC: 7239 #section -5.3, is féidir leis an gceannteideal `X-Forwarded-Host` uimhir an chalafoirt a áireamh, agus sa chás sin níor chóir duit:setting: USE\_X\_FORWARDED\_PORT a úsáid.

### ÚSÁID\_X\_FORWARDED\_PORT \`

Réamhshocraithe: `Fréag`

Boolean a shonraíonn an gceanntásc `X-Forwarded-Port` a úsáid mar rogha leis an athróg `SERVER_PORT` `META`. Níor chóir é seo a chumasú ach amháin má tá seachfhreastalaí a leagann an ceanntásc seo in úsáid.

[`USE_X_FORWARDED_HOST`](#std-setting-USE_X_FORWARDED_HOST) takes priority over this setting.

### `WSGI_IARRATAS`

Réamhshocraithe: Níl \`\`

Conair iomlán Python an réad feidhmchláir WSGI a úsáidfidh freastalaithe ionsuite Django (e.g.:djadmin: runserver). Cruthóidh an t-ordú bainist \<startproject\>íochta: Djadmin: django-admin startproject \`comhad caighdeánach \`wsgi.py le ```feidhmchlár ``is féidir a ghlaoch ann, agus cuirfidh an socrú seo chuig an ``feidhmchlár``` sin.

Mura bhfuil sé socraithe, úsáidfear luach tuairisceáin django.core.wsgi.get\_wsgi\_application () . Sa chás seo, beidh iompar: djadmin: runserver comhionann le leaganacha Django roimhe seo.

### FORMÁID `BLIAN_MHÍOS`

Réamhshocraithe: `'F Y'`

An formáidiú réamhshocraithe le húsáid le haghaidh réimsí dáta ar leathanaigh liosta athraithe riaracháin Django - agus, b'fhéidir, ag codanna eile den chóras - i gcásanna nach dtaispeántar ach an bhliain agus an mhí.

Mar shampla, nuair a bhíonn leathanach liosta athraithe riaracháin Django á scagadh ag druileáil dáta, taispeánann an ceannteideal do mhí ar leith an mhí agus an bhliain. Tá formáidí éagsúla ag áitiúla éagsúla. Mar shampla, déarfadh Béarla na SA “Eanáir 2006,” ach d'fhéadfadh áitiúil eile a rá “2006/Eanáir.”

Tabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid chomhfhreagrach áitiúil agus go gcuirfear i bhfeidhm ina ionad.

\<date\>Féach: TFilter: teaghráin formáid dáta ceadaithe \`. Féach freis:socrú: \`DATE\_FORMAT, :setting: DATETIME\_FORMAT, :setting: TIME\_FORMAT agus:setting: MONTH\_DAY\_FORMAT.

### `ROGHANNA X_FRAME`

Réamhshocraithe: `'DENY'`

An luach réamhshocraithe don cheanntásc X-Frame-Options a úsáideann ar:class: ~django.middleware.clickjacking.xframeOptionsMiddleware. Féach an doiciméad:doc: click\</ref/clickjacking/\> jacking cosant'.

## Authas

Socruithe le haghaidh: mod: django.contrib.auth.

### `BACKENDATION_BACKENDS`

Réamhshocraithe: `['django.contrib.auth.backends.modelBackend']`

Liosta d'aicmí cúltaca fíordheimhnithe (mar teaghráin) le húsáid agus tú ag iarraidh úsáideoir a fhíordheimhniú. \<authentication-backends\>Féach na:ref: doiciméadú cúltaca fíordheimhniúcháin le haghaidh sonraí.

### AUTH\_USER\_MODEL \`\`

Réamhshocraithe: `` `Auth.user' ``

An tsamhail atá le húsáid chun ionadaíocht a dhéanamh ar Úsáideoir. Féach: ref: auth-custom-user.

> **Warning**
>
> Ní féidir leat an socrú AUTH\_USER\_MODEL a athrú le linn shaolré tionscadail (i.e. nuair a bheidh samhlacha déanta agus imirce agat atá ag brath air) gan iarracht tromchúiseach. Tá sé i gceist é a shocrú ag tús an tionscadail, agus caithfidh an tsamhail a thagraíonn sé a bheith ar fáil sa chéad imirce den aip ina gcónaíonn sé ann. Féach: ref: auth-custom-user le haghaidh tuilleadh sonraí.

### LOG\_REDIRECT\_URL \`\`

Réamhshocraithe: `'/cuntais/próifíl/'`

An URL nó:ref: patrún URL ainmnithe \<naming-url-patterns\>\`ina ndéantar iarratais a atreorú tar éis logáil isteach nuair nach bhfaigheann an:class: \`~django.contrib.auth.views.loginView paraiméadar GET `next`.

### `LOG_URL`

Réamhshocraithe: `'/cuntais/logáil isteach /'`

An URL nó:ref: patrún URL ainmnithe \`ina n- \<naming-url-patterns\>atreoraítear iarratais ar logáil isteach nuair a úsáidtear an:func: \`~django.contrib.auth.decorators.login\_required decorator, :class: ~django.contrib.auth.mixins.loginrequiredMixin, :class: ~django.contrib.auth.mixins.accessin, nó when :class: ~django.contrib.auth.middleware.loginrequiredMiddleware suiteáilte.

### LOGOUT\_REDIRECT\_URL \`\`

Réamhshocraithe: Níl \`\`

An URL nó:ref: patrún URL ainmnithe \<naming-url-patterns\>\`ina ndéantar iarratais a atreorú tar éis logáil amach ias:class: \`~django.contrib.auth.views.logoutview tréith `next_page`.

Má tá `None`, ní dhéanfar aon athsheoladh agus déanfar an radharc logála amach a léiriú.

### `PASFHOCAL_RESET_TIMEOUT`

Réamhshocraithe: 259200\` (3 lá, i soicindí)

Tá líon na soicind a bhfuil nasc athshocraithe pasfhocal bailí dóibh.

Úsáidtear ag an: class: ~django.contrib.auth.views.passwordResetConfirmView.

> **Note**
>
> Ní dhéanann luach an t-ama seo a laghdú aon difríocht ar chumas ionsaitheora comhartha athshocraithe pasfhocal a chur i bhfeidhm go brútal. Tá comharthaí deartha le bheith sábháilte ó fhorfheidhmiú brúite gan aon am amach.
>
> Tá an t-am seo ann chun cosaint a dhéanamh i gcoinne roinnt cásanna ionsaithe nach dócha, mar shampla duine a fhaigheann rochtain ar chartlanna ríomhphoist a d'fhéadfadh sean-chomharthaí athshocraithe pasfho

### `PASSWORD_HASHERS`

Féach:ref: auth\_password\_storage.

Réamhshocraithe:

```
[
    "django.contrib.auth.hashers.PBKDF2PasswordHasher",
    "django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher",
    "django.contrib.auth.hashers.Argon2PasswordHasher",
    "django.contrib.auth.hashers.BCryptSHA256PasswordHasher",
    "django.contrib.auth.hashers.ScryptPasswordHasher",
]
```

### `BAILÍOCHTAITHEOIR_PASSWORD_AUTH`

Réamhshocraithe: `[]` (Liosta folamh)

Liosta na mbailíochtóirí a úsáidtear chun neart pasfhocail an úsáideora a sheiceáil. Féach:ref: bailíochtú pasfhocal le haghaidh tuilleadh sonraí. De réir réamhshocraithe, ní dhéantar aon bhailíochtú agus glactar le gach pasfhocal.

## Teachtaireachtaí

Socruithe le haghaidh: mod: django.contrib.messages.

### LEIBHÉAL\_TEACHTAIREACHTAÍ \`\`

Réamhshocraithe: `Messages.info`

Socraíonn sé an leibhéal íosta teachtaireachta a thaifeadfar ag creat na teachtaireachtaí. Féach: tagairt: leibhéil teachtaireachtaí \<message-level\>\`le haghaidh tuilleadh sonraí.

> **Allmhairithe ciorclach**
>
> Má sháraigh tú `MESSAGE_LEVEL` i do chomhad socruithe agus má bhíonn tú ag brath ar aon cheann de na comhsheasmhainní ionsuite, ní mór duit an modúl comhsheasmhach a allmhairiú go díreach chun an fhéidearthacht allmhairí ciorclach a sheachaint, m.sh.:
>
> ```
> from django.contrib.messages import constants as message_constants
>
> MESSAGE_LEVEL = message_constants.DEBUG
> ```
>
> \<message-level-constants\>Más mian leat, féadfaidh tú na luachanna uimhriúla do na comhsheasmhainní a shonrú go díreach de réir na luachanna sa thuas:ref: tábla comhsheasmhainne.

### `TEACHTAIREACHTAÍ STÓRÁLA`

Réamhshocraithe: `'Django.contrib.messages.storage.fallback.fallbackStorage'`

Rialuithe áit a stórálann Django sonraí teachtaireachtaí. Is iad na luachanna bailí:

- `` `Django.contrib.messages.storage.fallback.fallbackstorage' ``
- `` `Django.Contrib.Messages.Storage.Session.SessionStorage' ``
- Django.contrib.messages.storage.cookie.cookieIestorage'

Féach: tagairt: cúltaca stórála teachtaireachtaí \<message-storage-backends\>\`le haghaidh tuilleadh sonraí.

Na cúltaca a úsáideann fianáin --:class: ~django.contrib.messages.storage.cookie.cookieStorage agus:class: ~django.contrib.messages.storage.fallback.fallbackStorage -- bain úsáid as luach:setting: SESSION\_COOKIE\_DOMAIN, :setting: SESSION\_COOKIE\_SECURE :setting: SESSION\_COOKIE\_HTTPONLY agus a gcuid fianáin á leagan síos agat.

### TAG\_TEACHTAIREACHTAÍ \`\`

Réamhshocraithe:

```
{
    messages.DEBUG: "debug",
    messages.INFO: "info",
    messages.SUCCESS: "success",
    messages.WARNING: "warning",
    messages.ERROR: "error",
}
```

Socraíonn sé seo mapáil leibhéal teachtaireachta go clib teachtaireachta, a léirítear de ghnáth mar rang CSS i HTML. Má shonraíonn tú luach, leathnóidh sé an réamhshocrú. Ciallaíonn sé seo nach gá duit ach na luachanna sin a chaithfidh tú a shárú a shonrú. Féach: Ref: teachtaireachtaí taispeántaí thuas le haghaidh tuilleadh sonraí.

> **Allmhairithe ciorclach**
>
> Má sháraigh tú `MESSAGE_TAGS` i do chomhad socruithe agus má bhíonn tú ag brath ar aon cheann de na comhsheasmhainní ionsuite, ní mór duit an modúl constants\` a allmhairiú go díreach chun an fhéidearthacht allmhairí ciorclach a sheachaint, m.sh.:
>
> ```
> from django.contrib.messages import constants as message_constants
>
> MESSAGE_TAGS = {message_constants.INFO: ""}
> ```
>
> \<message-level-constants\>Más mian leat, féadfaidh tú na luachanna uimhriúla do na comhsheasmhainní a shonrú go díreach de réir na luachanna sa thuas:ref: tábla comhsheasmhainne.

## Seisiúin

Socruithe le haghaidh: mod: django.contrib.sessions.

### `SEISIÓN_CACHE_ALIAS`

Réamhshocraithe: `'default'`

Má tá tú ag baint úsáidea:ref: stóráil seisiúin bunaithe ar taisce \<cached-sessions-backend\>, roghnaíonn sé seo an taisce le húsáid.

### `SEISIÓN_COOKIE_AOS`

Réamhshocraithe: 1209600\` (2 seachtaine, i soicindí)

Aois na bhfianáin seisiúin, i soicindí.

### `SESSION_COOKIE_DOMAIN`

Réamhshocraithe: Níl \`\`

An fearainn le húsáid le haghaidh fianáin seisiúin. Socraigh é seo go sreang mar `"example.com"` le haghaidh fianáin tras-fearainn, nó bain úsáid as None le haghaidh fianán fearainn caighdeánach.

Chun fianáin tras-fearainn a úsáid la:setting: CSRF\_USE\_SESSIONS, ní mór duit ponc tosaigh a áireamh (m.sh. `” .example.com"`) chun freastal ar sheiceáil atreoraithe meán-earraí CSRF.

Bí cúramach agus an suíomh seo á nuashonrú agat ar shuíomh táirgeachta. Má nuashonraíonn tú an socrú seo chun fianáin tras-fearainn a chumasú ar shuíomh a d'úsáid fianáin fearainn caighdeánacha roimhe seo, socraítear fianáin úsáideora atá ann cheana ar an sean-fhearann D'fhéadfadh sé seo go mbeidh siad in ann logáil isteach chomh fada agus a leanann na fianáin seo.

Bíonn tionchar ag an socrú seo freisin ar fhianáin arna leagan síos ar:mod: django.contrib.messages.

### `SESSION_COOKIE_HTTPONLY`

Réamhshocraithe: Fíor\`

Cibé acu an bhratach HttpOnly a úsáid ar an bhfianán seisiúin. Má tá sé seo socraithe ar `True`, ní bheidh JavaScript taobh an chliaint in ann rochtain a fháil ar an bhfianán seisiúin.

Is bratach é [HTTPOnly](https://owasp.org/www-community/HttpOnly) atá san áireamh i gceannteideal freagartha Set-Cookie HTTP. Tá sé mar chuid den chaighdeán:rfc: 6265 #section -4.1.2.6 le haghaidh fianáin agus féadann sé a bheith ina bhealach úsáideach chun an baol go bhfaighidh script taobh an chliaint rochtain ar na sonraí cosanta fianán a mhaolú.

Fágann sé seo nach bhfuil sé chomh tábhachtach d'ionsaitheoir leochaileacht scripteála tras-láithreáin a mhéadú go seisiún úsáideora a fhuadach iomlán. Níl go leor cúiseanna maithe ann chun é seo a mhúchadh. Níor chóir do chód fianáin seisiúin a léamh ó JavaScript.

### `` `SESSION_COOKIE_NAME ``

Réamhshocraithe: `'seisión`

Ainm na fianán le húsáid le haghaidh seisiúin. Is féidir leis seo a bheith cibé rud is mian leat (fad is atá sé difriúil ó na hainmneacha fianán eile i d'iarratas).

### `SEISIÓN_COOKIE_PATH`

Réamhshocraithe: `'/'`

An cosán atá leagtha amach ar an bhfianán seisiúin. Ba chóir go n-oireann sé seo cosán URL do shuiteála Django nó a bheith ina thuismitheoir ar an gcosán sin.

Tá sé seo úsáideach má tá cásanna iolracha Django agat ag rith faoin ainm óstach céanna. Is féidir leo cosáin éagsúla fianán a úsáid, agus ní fheicfidh gach cás ach a fhianán seisiúin féin.

### `SEISIÓN_FIANÁINE_SAMESITE`

Réamhshocraithe: `'Lax'`

Luach an bhratach [SameSite](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value) ar an bhfianán seisiúin. Cuireann an bratach seo cosc ar an bhfianán a sheoladh isteach in iarratais tras-láithreáin agus mar sin cosc a chur ar ionsaithe CSRF agus rud a fhágann go bhfuil roinnt modhanna chun fianán

Is iad na luachanna féideartha don socrú:

- `'Strict`: cuireann an brabhsálaí cosc ar an bhfianán a sheoladh chuig an spriocshuíomh i ngach comhthéacs brabhsála tras-láithreáin, fiú nuair a bhíonn nasc rialta á leanúint agat.

  Mar shampla, do shuíomh Gréasáin cosúil le GitHub chiallódh sé seo má leanann úsáideoir logáilte nasc chuig tionscadal príobháideach GitHub a chuirtear ar fhóram plé corparáideach nó ríomhphost, ní gheobhaidh GitHub an fianán seisiúin agus ní bheidh an t-úsáideoir in ann rochtain a fháil ar an tionscadal. Is dóichí nach bhfuil suíomh Gréasáin bainc ag iarraidh cead a cheadú aon leathanaigh idirghníomhaíochta a nascadh ó shuíomhanna seachtracha mar sin bheadh an bhratach `Strict` oiriúnach.
- `'Lax'` (réamhshocraithe): soláthraíonn cothromaíocht idir slándáil agus inúsáidteacht do shuíomhanna gréasáin atá ag iarraidh seisiún logáilte isteach an úsáideora a choinneáil tar éis don úsáideoir teacht ó nasc seachtrach.

  Sa chás GitHub, ceadaíodh an fianán seisiúin nuair a leanfaí nasc rialta ó shuíomh Gréasáin seachtrach agus cuirfí bac ar mhodhanna iarratais CSRF (m.sh. POST \`).
- `` `None' `` (teaghrán): seolfar an fianán seisiúin le gach iarratas ar an láithreán céanna agus tras-láithreán.
- `False`: díchumasaíonn an bratach.

> **Note**
>
> Soláthraíonn brabhsálaithe nua-aimseartha beartas réamhshocraithe níos sábháilte don bhratach `SameSite` agus glacfaidh siad le `Lax` le haghaidh fianáin gan luach follasach soiléir.

### `SEISIÚN_FIANÁIN SHÁBHÁILTE`

Réamhshocraithe: `Fréag`

Cibé acu fianán slán a úsáid don fhianán seisiúin. Má tá sé seo socraithe ar `True`, marcálfar an fianán mar “slán”, rud a chiallaíonn go bhféadfaidh brabhsálaithe a chinntiú nach seoltar an fianán ach faoi nasc HTTPS.

Ní smaoineamh maith é an socrú seo a fhágáil mar d'fhéadfadh ionsaitheoir fianán seisiúin neamhchriptithe a ghabháil le sniffer paicéad agus an fianán a úsáid chun seisiún an úsáideora a fhuadadh.

### `INNEAL_SEISIÚNA`

Réamhshocraithe: `'django.contrib.sessions.backends.db'`

Rialuithe ina stórálann Django sonraí seisiúin. Is iad na hinnill san áireamh:

- `'django.contrib.sessions.backends.db'`
- `'django.contrib.sessions.backends.file'`
- `'django.contrib.sessions.backends.cache'`
- `'django.contrib.sessions.backends.cached_db'`
- `'django.contrib.sessions.backends.signed_cookies'`

Féach: ref: seisiúin cumraitheach le haghaidh tuilleadh sonraí.

### SEISIÚIN\_DEIGH\_AT\_BRABHSÁLAÍ\_DÚNTA \`\`

Réamhshocraithe: `Fréag`

Cibé an rachaidh an seisiún in éag nuair a dhúnn an úsáideoir a bhrabhsála Féach:ref: brabhsálaí-length-vs-seisiúin persistent-s.

### `SESSION_FILE_PATH`

Réamhshocraithe: Níl \`\`

Má tá stóráil seisiúin comhadbhunaithe á úsáid agat, socraíonn sé seo an eolaire ina stóráilfidh Django sonraí seisiúin. Nuair a úsáidtear an luach réamhshocraithe (None ), úsáidfidh Django an eolaire sealadach caighdeánach don chóras.

### `SEISIÚN_SÁBHA_GACH IARRAT`

Réamhshocraithe: `Fréag`

Cibé acu sonraí an tseisiúin a shábháil ar gach iarratas. Más é seo `False` (réamhshocraithe), ansin ní shábhálfar sonraí an tseisiúin ach má tá siad modhnaithe - is é sin, má shanntar nó scriosadh aon cheann dá luachanna foclóra. Ní chruthófar seisiúin folamh, fiú má tá an suíomh seo gníomhach.

### `SESSION_SERIALIZER`

Réamhshocraithe: `'Django.contrib.sessions.serializers.jsonSerializer'`

Conair iomlán iompórtála ranga serializer le húsáid chun sonraí seisiúin a shraitheadh. Is é an sraitheoir san áireamh:

- `'Django.Contrib.Sessions.Serializers.JSONSerializer'`

Féach:ref: session\_serialization le haghaidh sonraí.

## Suíomhanna

Socruithe le haghaidh: mod: django.contrib.sites.

### `ID_LÁITHREACH`

Réamhshocrú: Gan sainmhíniú

An ID, mar shláimhir, an láithreáin reatha sa tábla bunachar sonraí `django_site`. Úsáidtear é seo ionas gur féidir le sonraí feidhmchláir dul isteach i suíomhanna ar leith agus gur féidir le bunachar sonraí amháin ábhar a bhainistiú do shuíomhanna iolr

## Comhaid Statach

Socruithe le haghaidh: mod: django.contrib.staticfiles.

### `FRÉAMH_STATIC`

Réamhshocraithe: Níl \`\`

An cosán iomlán chuig an eolaire ina mbailfidh: djadmin: collectstatic comhaid statacha le haghaidh imscartha.

Sampla: `” /var/www/example.com/static/"`

Má tá an aip contrib: doc: staticfiles cumasaithe (mar atá sa te@@\</ref/contrib/staticfiles\> impléad réamhshocraithe tionscadail), baileoidh an t-ordú bainistíochta: djadmin: collectstatic comhaid statacha san eolaire seo. Féach an conas ar: doc: comhaid statacha a bhainistiú' le haghaidh tuilleadh sonraí faoin úsáid .\</howto/static-files/index\>

> **Warning**
>
> Ba chóir go mbeadh sé seo ina eolaire ceann scríbe folamh i dtosach chun do chuid comhad statacha a bhailiú óna n-áiteanna buana isteach i eolaire amháin chun éasca a imscaradh; ní\*\* áit é chun do chuid comhad statacha a stóráil go buan. Ba chóir duit é sin a dhéanamh in eolairí a gheobhaidh: :doc: staticfiles's:setting: finders \`\</ref/contrib/staticfiles\>\<STATICFILES\_FINDERS\>, atá de réir réamhshocraithe, fo-eolairí aip \`\`static/'\` agus aon eolairí a chuimsíonn tú in:setting: STATICFILES\_DIRS).

### STATIC\_URL \`\`

Réamhshocraithe: Níl \`\`

URL le húsáid agus tú ag tagairt do chomhaid statacha atá suite in:setting: STATIC\_ROOT.

Sampla: `"statach/"` nó `” https://static.example.com/ “`

Mura bhfuil `None`, úsáidfear é seo mar bhonn cosán le haghaidh: ref: sainmhínithe sócmhainní\</ref/contrib/staticfiles\> \<form-asset-paths\>\`(an rang \`\`Meáin \`) agus an aip: doc: staticfiles.

Caithfidh sé deireadh a chur le slasc má tá sé socraithe ar luach neamh-folamh.

B'fhéidir go mbeidh ort: ref: na comhaid seo a chumrú le seirbheáil i bhforbairt \</howto/static-files/deployment\> \<serving-static-files-in-development\>\`agus is cinnte go mbeidh ort é sin a dhéanamh: doc: \`i dtáirgeadh.

> **Note**
>
> Más: Socrú: Is cosán coibhneasta é STATIC\_URL, ansin déanfar é a réamhshocrú ag an luach `SCRIPT_NAME` a sholáthraíonn an freastalaí (nó `/` mura bhfuil sé socraithe). Fágann sé seo go bhfuil sé níos éasca feidhmchlár Django a sheirbheáil i bhfochonair gan cumraíocht bhreise a chur leis na socruithe.

### `COMHAD STATIC_DIRS`

Réamhshocraithe: `[]` (Liosta folamh)

Sainmhíníonn an socrú seo na suíomhanna breise a thrasnóidh an aip staticfiles má chumasaítear an aimsitheoir `FilesystemFinder`, m.sh. má úsáideann tú an ordú bainistíochta: djadmin: collectstatic nó: djadmin: findstatic nó má úsáideann tú an radharc statach a sheirbheáil.

Ba chóir é seo a shocrú ar liosta teaghráin ina bhfuil cosáin iomlána chuig d'eolaire (í) comhaid bhreise m.sh.:

```
STATICFILES_DIRS = [
    "/home/special.polls.com/polls/static",
    "/home/polls.com/polls/static",
    "/opt/webfiles/common",
]
```

Tabhair faoi deara gur chóir go n-úsáidfeadh na cosáin seo sliotáin ar aghaidh i stíl Unix, fiú ar Windows (m.sh. `"C: /Users/User/MySite/Extra_Static_Content"`).

#### Réamhréamhacha (roghnach)

Sa chás gur mhaith leat tagairt a dhéanamh do chomhaid i gceann de na háiteanna le spás ainmneacha breise, is féidir leat\*\*go roghnaí\*\* réimír a sholáthar mar thuples `(réimír, cosán)`, m.sh.:

```
STATICFILES_DIRS = [
    # ...
    ("downloads", "/opt/webfiles/stats"),
]
```

Mar shampla, ag glacadh leis go bhfuil: setting: STATIC\_URL socraithe agat go `'static/'`, baileodh an t-ordú bainistíochta: djadmin: collectstatic na comhaid “stats” i bhfo-eolaire `'downloads'` de:setting: STATIC\_ROOT.

Ligfeadh sé seo duit tagairt a dhéanamh don chomhad áitiúil `` `'/opt/webfiles/stats/polls_20101022.tar.gz' `` le '/static/downloads/polls\_20101022.tar.gz'\` i do theimpléid, m.sh.:

```html+django
<a href="{% static 'downloads/polls_20101022.tar.gz' %}">
```

### `AIMSITHEOIRÍ COMHAID STATAICE`

Réamhshocraithe:

```
[
    "django.contrib.staticfiles.finders.FileSystemFinder",
    "django.contrib.staticfiles.finders.AppDirectoriesFinder",
]
```

Liosta na gcúltaca aimsitheora a bhfuil a fhios acu conas comhaid statacha a aimsiú in áiteanna éagsúla.

Gheobhaidh an réamhshocrú comhaid atá stóráilte sa socrú:setting: STATICFILES\_DIRS (ag baint úsáide as `Django.contrib.staticfiles.finders.filesystemfinder`) agus i bhfo-eolaire static\` de gach aip (ag baint úsáide as `Django.contrib.staticfiles.finders.appDirectoriesFinder`). Má tá comhad iolracha leis an ainm céanna i láthair, úsáidfear an chéad chomhad a fhaightear.

Tá aimsitheoir amháin díchumasaithe de réir réamhshocraithe: `Django.contrib.staticfiles.finders.defaultStorageFinder`. Má chuirtear le do shuíomh:: STATICFILES\_FINDERS, cuardóidh sé comhaid statacha sa stóráil comhaid réamhshocraithe mar a shainmhínítear leis an eochair `default` sa socrú: STORAGES.

> **Note**
>
> Agus an aimsitheoir AppDirectoriesFinder\` á úsáid agat, déan cinnte gur féidir do chuid aipeanna a aimsiú trí staticfiles tríd an aip a chur leis an socrú: INSTALLED\_APPS ar do shuíomh.

Meastar go bhfuil aimsitheoirí comhad statacha ina chomhéadan príobháideach faoi láthair, agus mar sin níl an comhéadan seo gan doiciméadú

## Innéacs Áiritheach na Socruithe

### Cache

- : socrú: CACHES
- [`CACHE_MIDDLEWARE_ALIAS`](#std-setting-CACHE_MIDDLEWARE_ALIAS)
- [`CACHE_MIDDLEWARE_KEY_PREFIX`](#std-setting-CACHE_MIDDLEWARE_KEY_PREFIX)
- [`CACHE_MIDDLEWARE_SECONDS`](#std-setting-CACHE_MIDDLEWARE_SECONDS)

### Bunachar Sonraí

- [`DATABASES`](#std-setting-DATABASES)
- [`DATABASE_ROUTERS`](#std-setting-DATABASE_ROUTERS)
- [`DEFAULT_INDEX_TABLESPACE`](#std-setting-DEFAULT_INDEX_TABLESPACE)
- [`DEFAULT_TABLESPACE`](#std-setting-DEFAULT_TABLESPACE)

### Dífhabhtú

- [`DEBUG`](#std-setting-DEBUG)
- [`DEBUG_PROPAGATE_EXCEPTIONS`](#std-setting-DEBUG_PROPAGATE_EXCEPTIONS)

### Ríomhphost

- [`ADMINS`](#std-setting-ADMINS)
- [`DEFAULT_CHARSET`](#std-setting-DEFAULT_CHARSET)
- [`DEFAULT_FROM_EMAIL`](#std-setting-DEFAULT_FROM_EMAIL)
- [`EMAIL_BACKEND`](#std-setting-EMAIL_BACKEND)
- [`EMAIL_FILE_PATH`](#std-setting-EMAIL_FILE_PATH)
- [`EMAIL_HOST`](#std-setting-EMAIL_HOST)
- [`EMAIL_HOST_PASSWORD`](#std-setting-EMAIL_HOST_PASSWORD)
- [`EMAIL_HOST_USER`](#std-setting-EMAIL_HOST_USER)
- [`EMAIL_PORT`](#std-setting-EMAIL_PORT)
- [`EMAIL_SSL_CERTFILE`](#std-setting-EMAIL_SSL_CERTFILE)
- [`EMAIL_SSL_KEYFILE`](#std-setting-EMAIL_SSL_KEYFILE)
- [`EMAIL_SUBJECT_PREFIX`](#std-setting-EMAIL_SUBJECT_PREFIX)
- [`EMAIL_TIMEOUT`](#std-setting-EMAIL_TIMEOUT)
- : socrú: EMAIL\_USE\_LOCALTIME
- [`EMAIL_USE_SSL`](#std-setting-EMAIL_USE_SSL)
- [`EMAIL_USE_TLS`](#std-setting-EMAIL_USE_TLS)
- [`MANAGERS`](#std-setting-MANAGERS)
- [`SERVER_EMAIL`](#std-setting-SERVER_EMAIL)

### Tuairisciú earrá

- [`DEFAULT_EXCEPTION_REPORTER`](#std-setting-DEFAULT_EXCEPTION_REPORTER)
- [`DEFAULT_EXCEPTION_REPORTER_FILTER`](#std-setting-DEFAULT_EXCEPTION_REPORTER_FILTER)
- [`IGNORABLE_404_URLS`](#std-setting-IGNORABLE_404_URLS)
- [`MANAGERS`](#std-setting-MANAGERS)
- [`SILENCED_SYSTEM_CHECKS`](#std-setting-SILENCED_SYSTEM_CHECKS)

### Uaslódálacha comhad

- [`FILE_UPLOAD_HANDLERS`](#std-setting-FILE_UPLOAD_HANDLERS)
- [`FILE_UPLOAD_MAX_MEMORY_SIZE`](#std-setting-FILE_UPLOAD_MAX_MEMORY_SIZE)
- [`FILE_UPLOAD_PERMISSIONS`](#std-setting-FILE_UPLOAD_PERMISSIONS)
- [`FILE_UPLOAD_TEMP_DIR`](#std-setting-FILE_UPLOAD_TEMP_DIR)
- [`MEDIA_ROOT`](#std-setting-MEDIA_ROOT)
- [`MEDIA_URL`](#std-setting-MEDIA_URL)
- [`STORAGES`](#std-setting-STORAGES)

### Foirmeacha

- [`FORM_RENDERER`](#std-setting-FORM_RENDERER)
- [`FORMS_URLFIELD_ASSUME_HTTPS`](#std-setting-FORMS_URLFIELD_ASSUME_HTTPS)

### Domhandú (`i18n`/`l10n`)

#### Idirnáisiúnú (`i18n`)

- [`FIRST_DAY_OF_WEEK`](#std-setting-FIRST_DAY_OF_WEEK)
- [`FORMAT_MODULE_PATH`](#std-setting-FORMAT_MODULE_PATH)
- [`LANGUAGE_COOKIE_AGE`](#std-setting-LANGUAGE_COOKIE_AGE)
- [`LANGUAGE_COOKIE_DOMAIN`](#std-setting-LANGUAGE_COOKIE_DOMAIN)
- [`LANGUAGE_COOKIE_HTTPONLY`](#std-setting-LANGUAGE_COOKIE_HTTPONLY)
- [`LANGUAGE_COOKIE_NAME`](#std-setting-LANGUAGE_COOKIE_NAME)
- [`LANGUAGE_COOKIE_PATH`](#std-setting-LANGUAGE_COOKIE_PATH)
- [`LANGUAGE_COOKIE_SAMESITE`](#std-setting-LANGUAGE_COOKIE_SAMESITE)
- [`LANGUAGE_COOKIE_SECURE`](#std-setting-LANGUAGE_COOKIE_SECURE)
- [`LANGUAGES`](#std-setting-LANGUAGES)
- [`LANGUAGES_BIDI`](#std-setting-LANGUAGES_BIDI)
- [`LOCALE_PATHS`](#std-setting-LOCALE_PATHS)
- : socrú: TIME\_ZONE
- [`USE_I18N`](#std-setting-USE_I18N)
- [`USE_TZ`](#std-setting-USE_TZ)

#### Logánú (`l10n`)

- [`DATE_FORMAT`](#std-setting-DATE_FORMAT)
- [`DATE_INPUT_FORMATS`](#std-setting-DATE_INPUT_FORMATS)
- [`DATETIME_FORMAT`](#std-setting-DATETIME_FORMAT)
- [`DATETIME_INPUT_FORMATS`](#std-setting-DATETIME_INPUT_FORMATS)
- [`DECIMAL_SEPARATOR`](#std-setting-DECIMAL_SEPARATOR)
- [`LANGUAGE_CODE`](#std-setting-LANGUAGE_CODE)
- [`MONTH_DAY_FORMAT`](#std-setting-MONTH_DAY_FORMAT)
- [`NUMBER_GROUPING`](#std-setting-NUMBER_GROUPING)
- [`SHORT_DATE_FORMAT`](#std-setting-SHORT_DATE_FORMAT)
- [`SHORT_DATETIME_FORMAT`](#std-setting-SHORT_DATETIME_FORMAT)
- [`THOUSAND_SEPARATOR`](#std-setting-THOUSAND_SEPARATOR)
- [`TIME_FORMAT`](#std-setting-TIME_FORMAT)
- [`TIME_INPUT_FORMATS`](#std-setting-TIME_INPUT_FORMATS)
- [`USE_THOUSAND_SEPARATOR`](#std-setting-USE_THOUSAND_SEPARATOR)
- [`YEAR_MONTH_FORMAT`](#std-setting-YEAR_MONTH_FORMAT)

### HTTP

- [`DATA_UPLOAD_MAX_MEMORY_SIZE`](#std-setting-DATA_UPLOAD_MAX_MEMORY_SIZE)
- [`DATA_UPLOAD_MAX_NUMBER_FIELDS`](#std-setting-DATA_UPLOAD_MAX_NUMBER_FIELDS)
- [`DATA_UPLOAD_MAX_NUMBER_FILES`](#std-setting-DATA_UPLOAD_MAX_NUMBER_FILES)
- [`DEFAULT_CHARSET`](#std-setting-DEFAULT_CHARSET)
- [`DISALLOWED_USER_AGENTS`](#std-setting-DISALLOWED_USER_AGENTS)
- [`FORCE_SCRIPT_NAME`](#std-setting-FORCE_SCRIPT_NAME)
- [`INTERNAL_IPS`](#std-setting-INTERNAL_IPS)
- [`MIDDLEWARE`](#std-setting-MIDDLEWARE)
- Slándáil

  - [`SECURE_CONTENT_TYPE_NOSNIFF`](#std-setting-SECURE_CONTENT_TYPE_NOSNIFF)
  - [`SECURE_CROSS_ORIGIN_OPENER_POLICY`](#std-setting-SECURE_CROSS_ORIGIN_OPENER_POLICY)
  - [`SECURE_HSTS_INCLUDE_SUBDOMAINS`](#std-setting-SECURE_HSTS_INCLUDE_SUBDOMAINS)
  - [`SECURE_HSTS_PRELOAD`](#std-setting-SECURE_HSTS_PRELOAD)
  - [`SECURE_HSTS_SECONDS`](#std-setting-SECURE_HSTS_SECONDS)
  - [`SECURE_PROXY_SSL_HEADER`](#std-setting-SECURE_PROXY_SSL_HEADER)
  - [`SECURE_REDIRECT_EXEMPT`](#std-setting-SECURE_REDIRECT_EXEMPT)
  - [`SECURE_REFERRER_POLICY`](#std-setting-SECURE_REFERRER_POLICY)
  - [`SECURE_SSL_HOST`](#std-setting-SECURE_SSL_HOST)
  - [`SECURE_SSL_REDIRECT`](#std-setting-SECURE_SSL_REDIRECT)
- [`SIGNED_COOKIE_LEGACY_SALT_FALLBACK`](#std-setting-SIGNED_COOKIE_LEGACY_SALT_FALLBACK)
- [`SIGNING_BACKEND`](#std-setting-SIGNING_BACKEND)
- [`USE_X_FORWARDED_HOST`](#std-setting-USE_X_FORWARDED_HOST)
- [`USE_X_FORWARDED_PORT`](#std-setting-USE_X_FORWARDED_PORT)
- : socrú: WSGI\_APPLICATION

### Logáil

- : socrú: LOGGING
- [`LOGGING_CONFIG`](#std-setting-LOGGING_CONFIG)

### Samhla

- [`ABSOLUTE_URL_OVERRIDES`](#std-setting-ABSOLUTE_URL_OVERRIDES)
- [`FIXTURE_DIRS`](#std-setting-FIXTURE_DIRS)
- [`INSTALLED_APPS`](#std-setting-INSTALLED_APPS)

### Slándáil

- Cosaint Falsaíochta Iarratas Trasláithreáin

  - [`CSRF_COOKIE_DOMAIN`](#std-setting-CSRF_COOKIE_DOMAIN)
  - [`CSRF_COOKIE_NAME`](#std-setting-CSRF_COOKIE_NAME)
  - [`CSRF_COOKIE_PATH`](#std-setting-CSRF_COOKIE_PATH)
  - [`CSRF_COOKIE_SAMESITE`](#std-setting-CSRF_COOKIE_SAMESITE)
  - [`CSRF_COOKIE_SECURE`](#std-setting-CSRF_COOKIE_SECURE)
  - [`CSRF_FAILURE_VIEW`](#std-setting-CSRF_FAILURE_VIEW)
  - [`CSRF_HEADER_NAME`](#std-setting-CSRF_HEADER_NAME)
  - [`CSRF_TRUSTED_ORIGINS`](#std-setting-CSRF_TRUSTED_ORIGINS)
  - [`CSRF_USE_SESSIONS`](#std-setting-CSRF_USE_SESSIONS)
- [`SECRET_KEY`](#std-setting-SECRET_KEY)
- [`SECRET_KEY_FALLBACKS`](#std-setting-SECRET_KEY_FALLBACKS)
- [`X_FRAME_OPTIONS`](#std-setting-X_FRAME_OPTIONS)

### Sraitheadh

- [`DEFAULT_CHARSET`](#std-setting-DEFAULT_CHARSET)
- [`SERIALIZATION_MODULES`](#std-setting-SERIALIZATION_MODULES)

### Teimpléid

- [`TEMPLATES`](#std-setting-TEMPLATES)

### Tástáil

- \<DATABASE-TEST\>Bunachar sonraí: :setting: TEST \`
- [`TEST_NON_SERIALIZED_APPS`](#std-setting-TEST_NON_SERIALIZED_APPS)
- [`TEST_RUNNER`](#std-setting-TEST_RUNNER)

### URLanna

- [`APPEND_SLASH`](#std-setting-APPEND_SLASH)
- [`PREPEND_WWW`](#std-setting-PREPEND_WWW)
- [`ROOT_URLCONF`](#std-setting-ROOT_URLCONF)
