SocruitheLink to this heading#

URL_ABSOLUTE_OVERRIDESLink to this heading#

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

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

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

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

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.

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

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

CACHE_MIDDLEWARE_ALIASLink to this heading#

Réamhshocraithe: 'default'

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

CACHE_MIDDLEWARE_KEY_PREFIXLink to this heading#

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

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

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

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

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

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

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

Réamhshocraithe: 'Lax'

Luach an bhratach SameSite 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_SECURELink to this heading#

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

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

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

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

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

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:

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

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

``SONRA_UASLÓDÁIL_MÉID_CUIMHNEACHÁIN UASTA ``Link to this heading#

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

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

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

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

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

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

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

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.

DEBUGLink to this heading#

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)”.

`EISCEACHTAIS_IOMADAITHE_DEBUGLink to this heading#

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

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

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

DEFAULT_CHARSETLink to this heading#

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

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

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

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

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

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

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

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

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_ÓSTLink to this heading#

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

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

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

Réamhshocraithe: 25

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

RÍOMHPHOST_ÁBHAIR_RÉAMHLink to this heading#

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

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

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

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

Réamhshocraithe: ``Níl ``

If EMAIL_USE_SSL or 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.

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 can be subclassed to add root certificates to its ssl_context using ssl.SSLContext.load_verify_locations().

RÍOMHPHOST_SSL_KEYFILELink to this heading#

Réamhshocraithe: ``Níl ``

If EMAIL_USE_SSL or 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.

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

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

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

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

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

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

FILE_UPLOAD_TEMP_DIRLink to this heading#

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áin*nix-style.

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

`CHÉAD_LAETH_DEN TSEACHTAINELink to this heading#

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

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

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

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

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

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:

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

• DATE_INPUT_FORMATS

• DATETIME_FORMAT,

• DATETIME_INPUT_FORMATS

• DECIMAL_SEPARATOR

• FIRST_DAY_OF_WEEK

• MONTH_DAY_FORMAT

• NUMBER_GROUPING

• SHORT_DATE_FORMAT

• SHORT_DATETIME_FORMAT

• THOUSAND_SEPARATOR

• TIME_FORMAT

• TIME_INPUT_FORMATS

• YEAR_MONTH_FORMAT

URLACHA NEAMHCHOITIANTA 404_Link to this heading#

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

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.

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

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

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

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

Aois na fianán teanga, i soicindí.

TEANGA_FIANÁINE_FEARAINLink to this heading#

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

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

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

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

Réamhshocraithe: ``Níl ``

Luach an bhratach SameSite 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ÁLALink to this heading#

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

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

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

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

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

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Í ``Link to this heading#

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

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.

``MEDIA_URL ``Link to this heading#

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/ “

``MEÁN-EARRAÍ ``Link to this heading#

Réamhshocraithe: ``Níl ``

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

MODÚL_IMIRCELink to this heading#

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

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

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

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

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

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

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

EOCHAIR_FALLBACKSLink to this heading#

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.

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

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

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

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.

SLÁNDA_HSTS_PRELOADLink to this heading#

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

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.

SLÁNT_PROXY_SSL_HEADERLink to this heading#

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

SLÁNDA_ATHREDIRECT_EISEOLÚINTLink to this heading#

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

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

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

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

MODÚL_SRAITHEACHLink to this heading#

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

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.

FORMÁID_DÁTA_GEARRLink to this heading#

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

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

Réamhshocraithe: ``Fíor`

Controls whether 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_BACKENDLink to this heading#

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

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

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.FileSystemStorage````is é an t-inneall stórála réamhshocraithe.

• staticfiles le haghaidh: doc: comhaid statacha a bhainistiú' </ref/contrib/staticfiles>. `````` Django.contrib.staticFiles.Storage.staticFilesStorage````is é 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.

TEIMPLÉIDLink to this heading#

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.

TÁST_RUNNERLink to this heading#

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

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

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

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

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

Réamhshocraithe: 'Meiriceá/Chicago'

Sreang a léiríonn an crios ama don suiteáil seo. Féach an liosta criosanna ama.

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.

USE_I18NLink to this heading#

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.

``ÚSÁID_MÍLTE DEIGHILTEOIR ``Link to this heading#

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

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_ÓSTLink to this heading#

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

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 takes priority over this setting.

WSGI_IARRATASLink to this heading#

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

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

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

BACKENDATION_BACKENDSLink to this heading#

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

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.

``LOG_REDIRECT_URL ``Link to this heading#

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

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

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

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.

PASSWORD_HASHERSLink to this heading#

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

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.

``LEIBHÉAL_TEACHTAIREACHTAÍ ``Link to this heading#

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

TEACHTAIREACHTAÍ STÓRÁLALink to this heading#

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Í ``Link to this heading#

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

SEISIÓN_CACHE_ALIASLink to this heading#

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

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

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

SESSION_COOKIE_DOMAINLink to this heading#

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

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

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

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

Réamhshocraithe: 'Lax'

Luach an bhratach SameSite 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.

SEISIÚN_FIANÁIN SHÁBHÁILTELink to this heading#

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

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

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

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

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

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

ID_LÁITHREACHLink to this heading#

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

FRÉAMH_STATICLink to this heading#

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>

``STATIC_URL ``Link to this heading#

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.

COMHAD STATIC_DIRSLink to this heading#

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").

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

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

AIMSITHEOIRÍ COMHAID STATAICELink to this heading#

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.

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ú

CacheLink to this heading#

• : socrú: CACHES

• CACHE_MIDDLEWARE_ALIAS

• CACHE_MIDDLEWARE_KEY_PREFIX

• CACHE_MIDDLEWARE_SECONDS

Bunachar SonraíLink to this heading#

• DATABASES

• DATABASE_ROUTERS

• DEFAULT_INDEX_TABLESPACE

• DEFAULT_TABLESPACE

DífhabhtúLink to this heading#

• DEBUG

• DEBUG_PROPAGATE_EXCEPTIONS

RíomhphostLink to this heading#

• ADMINS

• DEFAULT_CHARSET

• DEFAULT_FROM_EMAIL

• EMAIL_BACKEND

• EMAIL_FILE_PATH

• EMAIL_HOST

• EMAIL_HOST_PASSWORD

• EMAIL_HOST_USER

• EMAIL_PORT

• EMAIL_SSL_CERTFILE

• EMAIL_SSL_KEYFILE

• EMAIL_SUBJECT_PREFIX

• EMAIL_TIMEOUT

• : socrú: EMAIL_USE_LOCALTIME

• EMAIL_USE_SSL

• EMAIL_USE_TLS

• MANAGERS

• SERVER_EMAIL

Tuairisciú earráLink to this heading#

• DEFAULT_EXCEPTION_REPORTER

• DEFAULT_EXCEPTION_REPORTER_FILTER

• IGNORABLE_404_URLS

• MANAGERS

• SILENCED_SYSTEM_CHECKS

Uaslódálacha comhadLink to this heading#

• FILE_UPLOAD_HANDLERS

• FILE_UPLOAD_MAX_MEMORY_SIZE

• FILE_UPLOAD_PERMISSIONS

• FILE_UPLOAD_TEMP_DIR

• MEDIA_ROOT

• MEDIA_URL

• STORAGES

FoirmeachaLink to this heading#

• FORM_RENDERER

• FORMS_URLFIELD_ASSUME_HTTPS

Domhandú (i18n/l10n)Link to this heading#

HTTPLink to this heading#

• DATA_UPLOAD_MAX_MEMORY_SIZE

• DATA_UPLOAD_MAX_NUMBER_FIELDS

• DATA_UPLOAD_MAX_NUMBER_FILES

• DEFAULT_CHARSET

• DISALLOWED_USER_AGENTS

• FORCE_SCRIPT_NAME

• INTERNAL_IPS

• MIDDLEWARE

• Slándáil

  • SECURE_CONTENT_TYPE_NOSNIFF

  • SECURE_CROSS_ORIGIN_OPENER_POLICY

  • SECURE_HSTS_INCLUDE_SUBDOMAINS

  • SECURE_HSTS_PRELOAD

  • SECURE_HSTS_SECONDS

  • SECURE_PROXY_SSL_HEADER

  • SECURE_REDIRECT_EXEMPT

  • SECURE_REFERRER_POLICY

  • SECURE_SSL_HOST

  • SECURE_SSL_REDIRECT

• SIGNED_COOKIE_LEGACY_SALT_FALLBACK

• SIGNING_BACKEND

• USE_X_FORWARDED_HOST

• USE_X_FORWARDED_PORT

• : socrú: WSGI_APPLICATION

LogáilLink to this heading#

• : socrú: LOGGING

• LOGGING_CONFIG

SamhlaLink to this heading#

• ABSOLUTE_URL_OVERRIDES

• FIXTURE_DIRS

• INSTALLED_APPS

SlándáilLink to this heading#

• Cosaint Falsaíochta Iarratas Trasláithreáin

  • CSRF_COOKIE_DOMAIN

  • CSRF_COOKIE_NAME

  • CSRF_COOKIE_PATH

  • CSRF_COOKIE_SAMESITE

  • CSRF_COOKIE_SECURE

  • CSRF_FAILURE_VIEW

  • CSRF_HEADER_NAME

  • CSRF_TRUSTED_ORIGINS

  • CSRF_USE_SESSIONS

• SECRET_KEY

• SECRET_KEY_FALLBACKS

• X_FRAME_OPTIONS

SraitheadhLink to this heading#

• DEFAULT_CHARSET

• SERIALIZATION_MODULES

TeimpléidLink to this heading#

• TEMPLATES

TástáilLink to this heading#

• <DATABASE-TEST>Bunachar sonraí: :setting: `TEST `

• TEST_NON_SERIALIZED_APPS

• TEST_RUNNER

URLannaLink to this heading#

• APPEND_SLASH

• PREPEND_WWW

• ROOT_URLCONF