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>.
\nURL_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 = {\n "blogs.blog": lambda o: "/blogs/%s/" % o.slug,\n "news.story": lambda o: "/stories/%s/%s/" % (o.pub_year, o.slug),\n}\nBa 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.
\nRé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.
\nBa chóir go mbeadh gach mír sa liosta ina tuple de (Ainm iomlán, seoladh ríomhphoist). Sampla:
\n[("John", "john@example.com"), ("Mary", "mary@example.com")]\nÓ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.
\nIs 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.
\nMura 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`
\nNuair 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
\nNí ú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.
\nCÁISLink to this heading#Réamhshocraithe:
\n{\n "default": {\n "BACKEND": "django.core.cache.backends.locmem.LocMemCache",\n }\n}\nFocló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.
\nNí 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ÚLTLink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nAn cúltaca taisce le húsáid. Is iad na cúltaca taisce ionsuite:
\n`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`).
\nEOCHAIRFHEIDHMELink to this heading#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:
\ndef make_key(key, key_prefix, version):\n return ":".join([key_prefix, str(version), key])\nFéadfaidh tú aon phríomhfheidhm a theastaíonn uait a úsáid, fad is atá an síniú argóint céanna aige.
\nFéach na:ref: `cáipéisíocht taiscéala <cache_key_transformation>`le haghaidh tuilleadh faisnéise.
\nEOCHAIR_RÉAMHLink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nSreang a chuirfear san áireamh go huathoibríoch (réamhshocraithe de réir réamhshocraithe) chuig gach eochair taisce a úsáideann an freastalaí Django.
\nFéach na:ref: `cáipéisíocht taiscéala <cache_key_prefixing>`le haghaidh tuilleadh faisnéise.
\nSUÍOMHLink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nSuí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.:
\nCACHES = {\n "default": {\n "BACKEND": "django.core.cache.backends.filebased.FileBasedCache",\n "LOCATION": "/var/tmp/django_cache",\n }\n}\nROGHANNAÍLink to this heading#Réamhshocraithe: ``Níl ``
\nParaiméadair bhreise le dul chuig an gcúltaca taisce. Athraíonn paraiméadair atá ar fáil ag brath ar do chúltaca taisce.
\n<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
\nTIMEOUTLink to this heading#Réamhshocraithe: ``300`
\nMeastar 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”).
LEAGANLink to this heading#Réamhshocraithe: 1
An uimhir leagan réamhshocraithe d'eochracha taisce a ghineann an freastalaí Django.
\nFéach na:ref: `cáipéisíocht taiscéala <cache_versioning>`le haghaidh tuilleadh faisnéise.
\nCACHE_MIDDLEWARE_ALIASLink to this heading#Réamhshocraithe: 'default'
<the-per-site-cache>An nasc taisce le húsáid don: ref: `cache middleware `.
\nCACHE_MIDDLEWARE_KEY_PREFIXLink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\n<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 é.
\nFéach: doc: /topics/cache.
\nCACHE_MIDDLEWARE_SOICINDLink to this heading#Réamhshocraithe: ``600`
\n<the-per-site-cache>An líon iomláir réamhshocraithe soicind chun leathanach a thaisceadh don: ref: `cache middleware `.
\nFéach: doc: /topics/cache.
\nSEISIÚ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.
\nTá 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.
\nÓ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:
\ndef csrf_failure(request, reason=""): ...\ni 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.
\nGlacann 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.
\nMar 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 `).
\nMaidir 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`.
\nMaidir 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.
\nNí mór don socrú: “BUNACHAR SONRAÍ” bunachar sonraí “réamhshocraithe” a chumrú; féadfar aon líon bunachar sonraí breise a shonrú freisin.
\nIs é 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:
\nDATABASES = {\n "default": {\n "ENGINE": "django.db.backends.sqlite3",\n "NAME": "mydatabase",\n }\n}\nAgus 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:
\nDATABASES = {\n "default": {\n "ENGINE": "django.db.backends.postgresql",\n "NAME": "mydatabase",\n "USER": "mydatabaseuser",\n "PASSWORD": "mypassword",\n "HOST": "127.0.0.1",\n "PORT": "5432",\n }\n}\nTá 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:
\nIARRATAITHE_ATOMICLink to this heading#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í `.
AUTOCOMITLink to this heading#Réamhshocraithe: ``Fíor`
\n<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.
\nINNEALLink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nAn cúltaca bunachar sonraí le húsáid. Is iad na cúltaca bunachar sonraí ionsuite:
\n'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).
ÓSTACHLink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nCén óstach le húsáid agus tú ag nascadh leis an mbunachar sonraí. Ciallaíonn sreang folamh localhost. Ní úsáidtear le SQLite.
\nMá 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:
\n"HOST": "/var/run/mysql"\nMá 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.
\nMá 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.
Réamhshocraithe: ``"``(Sreang folamh)
\nAinm 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_AOSLink to this heading#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 CONNLink to this heading#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ÍLink to this heading#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
\nIs 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
\nRéamhshocraithe: ``"``(Sreang folamh)
\nAn pasfhocal le húsáid agus tú ag nascadh leis an mbunachar sonraí. Ní úsáidtear le SQLite.
\nRéamhshocraithe: ``"``(Sreang folamh)
\nAn 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.
\nCRIOS_AMALink to this heading#Réamhshocraithe: ``Níl ``
\nSreang 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é.
\nAthraíonn athrú an chrios ama nasc an chaoi a léitear dáta-amanna ón mbunachar sonraí agus a scríobh chuig.
\nMá 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.
\nCé 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.
\nMar 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
\nSmaoinigh 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ÍCHUMASACHALink to this heading#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.
\nRéamhshocraithe: ``"``(Sreang folamh)
\nAn t-ainm úsáideora le húsáid agus tú ag ceangal leis an mbunachar sonraí Ní úsáidtear le SQLite.
\nTÁSTÁLALink to this heading#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.
\nSeo sampla le cumraíocht bunachar sonraí tástála:
\nDATABASES = {\n "default": {\n "ENGINE": "django.db.backends.postgresql",\n "USER": "mydatabaseuser",\n "NAME": "mydatabase",\n "TEST": {\n "NAME": "mytestdatabase",\n },\n },\n}\nTá na heochracha seo a leanas sa fhoclóir TEST ar fáil:
CHARSETLink to this heading#Réamhshocraithe: ``Níl ``
\nAn 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.
\nLe tacaíocht ó na cúltaca PostgreSQL (postgresql`) agus MySQL (mysql).
Réamhshocraithe: ``Níl ``
\nAn 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.
\nNí thacaítear ach leis an gcúltaca mysql (féach an `lámhleabhar MySQL `_ le haghaidh sonraí).
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í.
\n`IMIRCELink to this heading#Réamhshocraithe: ``Fíor`
\nNuair 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ÁNLink to this heading#Réamhshocraithe: ``Níl ``
\nAn 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.
\nTá 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í.
\nRéamhshocraithe: ``Níl ``
\nAinm an bhunachar sonraí le húsáid agus an tsraith tástála á reáchtáil.
\nMá ú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'.
\nTEIMPLÉADLink to this heading#Is suíomh atá sonrach le PostgreSQL é seo.
\nAinm teimpléad (m.sh. ``teimpléad0') as a chruthófar bunachar sonraí tástála.
\nCRUTHAITHE_DBLink to this heading#Réamhshocraithe: ``Fíor`
\nIs suíomh atá sonrach le Oracle é seo.
\nMá 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.
\nCHRUTHAITHE_ÚSÁIDEOIRLink to this heading#Réamhshocraithe: ``Fíor`
\nIs suíomh atá sonrach le Oracle é seo.
\nMá 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.
\nRéamhshocraithe: ``Níl ``
\nIs suíomh atá sonrach le Oracle é seo.
\nAn 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.
Réamhshocraithe: ``Níl ``
\nIs suíomh atá sonrach le Oracle é seo.
\nAn 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.
\nCOMHAD BAINISTITHE ORACLELink to this heading#Réamhshocraithe: Fréag
Is suíomh atá sonrach le Oracle é seo.
\nMá tá sé socraithe ar True, úsáidfear spásanna tábla Comhaid Bainistithe Oracle (OMF). :setting: DATAFILE agus:setting: DATAFILE_TMP déanfar neamhaird.
TBLSPACELink to this heading#Réamhshocraithe: ``Níl ``
\nIs suíomh atá sonrach le Oracle é seo.
\nAinm 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_TMPLink to this heading#Réamhshocraithe: ``Níl ``
\nIs suíomh atá sonrach le Oracle é seo.
\nAinm 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'.
DATAFILELink to this heading#Réamhshocraithe: ``Níl ``
\nIs suíomh atá sonrach le Oracle é seo.
\nAinm na fille sonraí le húsáid don TBLSPACE. Mura gcuirtear ar fáil, úsáidfidh Django TBLSPACE + '.dbf'.
DATAFILE_TMPLink to this heading#Réamhshocraithe: ``Níl ``
\nIs suíomh atá sonrach le Oracle é seo.
\nAinm na sonraí le húsáid don TBLSPACE_TMP. Mura gcuirtear ar fáil, úsáidfidh Django TBLSPACE_TMP + '.dbf'.
DATAFILE_MAXSIZELink to this heading#Réamhshocraithe: ``500M `
\nIs suíomh atá sonrach le Oracle é seo.
\nAn méid uasta a cheadaítear don DATAFILE fás air.
\nDATAFILE_TMP_MAXSIZELink to this heading#Réamhshocraithe: ``500M `
\nIs suíomh atá sonrach le Oracle é seo.
\nAn méid uasta a cheadaítear don DATAFILE_TMP fás.
\nMÉID_DATAFILELink to this heading#Réamhshocraithe: '50M'
Is suíomh atá sonrach le Oracle é seo.
\nMéid tosaigh an DATAFILE.
\nDATAFILE_TMP_SIZELink to this heading#Réamhshocraithe: '50M'
Is suíomh atá sonrach le Oracle é seo.
\nMéid tosaigh an DATAFILE_TMP.
\nDATAFILE_EXTSIZELink to this heading#Réamhshocraithe: '25M'
Is suíomh atá sonrach le Oracle é seo.
\nAn méid a leathnaítear an DATAFILE nuair a bhíonn níos mó spáis ag teastáil.
\nDATAFILE_TMP_EXTSIZELink to this heading#Réamhshocraithe: '25M'
Is suíomh atá sonrach le Oracle é seo.
\nAn méid a leathnaítear an DATAFILE_TMP nuair a bhíonn níos mó spáis ag teastáil.
\nRéamhshocraithe: 2621440` (ie 2.5 MB).
\nArdaí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.
\nFéach freis:socrú: FILE_UPLOAD_MAX_MEMORY_SIZE.
\nSONRA_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.
\nRé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.
\nRÓ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.
\n<topics-db-multi-db-routing>Féach an doiciméadú ar:ref: `ródú uathoibríoch bunachar sonraí i cumraíochtaí ilbhunachar sonraí `.
\nFORMÁ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 `.
\nFéach freis:setting: DATETIME_FORMAT, :setting: TIME_FORMAT agus:setting: SHORT_DATE_FORMAT.
\nRéamhshocraithe:
\n[\n "%Y-%m-%d", # '2006-10-25'\n "%m/%d/%Y", # '10/25/2006'\n "%m/%d/%y", # '10/25/06'\n "%b %d %Y", # 'Oct 25 2006'\n "%b %d, %Y", # 'Oct 25, 2006'\n "%d %b %Y", # '25 Oct 2006'\n "%d %b, %Y", # '25 Oct, 2006'\n "%B %d %Y", # 'October 25 2006'\n "%B %d, %Y", # 'October 25, 2006'\n "%d %B %Y", # '25 October 2006'\n "%d %B, %Y", # '25 October, 2006'\n]\nLiosta 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.
\nTá tosaíocht níos airde ag an bhformáid áitiúil agus cuirfear i bhfeidhm ina ionad sin.
\nFéach freis:socrú: DATETIME_INPUT_FORMATS agus:SETTING: TIME_INPUT_FORMATS.
\nFORMÁ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 `.
\nFéach freis:socrú: DATE_FORMAT, :setting: TIME_FORMAT agus:setting: SHORT_DATETIME_FORMAT.
\nRéamhshocraithe:
\n[\n "%Y-%m-%d %H:%M:%S", # '2006-10-25 14:30:59'\n "%Y-%m-%d %H:%M:%S.%f", # '2006-10-25 14:30:59.000200'\n "%Y-%m-%d %H:%M", # '2006-10-25 14:30'\n "%m/%d/%Y %H:%M:%S", # '10/25/2006 14:30:59'\n "%m/%d/%Y %H:%M:%S.%f", # '10/25/2006 14:30:59.000200'\n "%m/%d/%Y %H:%M", # '10/25/2006 14:30'\n "%m/%d/%y %H:%M:%S", # '10/25/06 14:30:59'\n "%m/%d/%y %H:%M:%S.%f", # '10/25/06 14:30:59.000200'\n "%m/%d/%y %H:%M", # '10/25/06 14:30'\n]\nLiosta 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.
\nTá tosaíocht níos airde ag an bhformáid áitiúil agus cuirfear i bhfeidhm ina ionad sin.
\nFéach freis:socrú: DATE_INPUT_FORMATS agus:socrú: TIME_INPUT_FORMATS.
\nDEBUGLink to this heading#Réamhshocraithe: Fréag
Boolean a chasann ar/as modh dífhabhtaithe.
\nNá imscaradh suíomh riamh i dtáirgeadh le: socrú: DEBUG a chasadh air.
\nCeann 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:
\n\nTabhair 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
\nTá 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.
\nFaoi 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.
\nIs 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.
\nDEIGHILTEOIR DEACHIMALLink to this heading#Réamhshocraithe: ``'.'` (Ponc)
\nDéileálóir deachúil réamhshocraithe a úsáidtear agus uimhreacha
\nTabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin.
\nFéach freis:socrú: NUMBER_GROUPING, :setting: THOUSAND_SEPARATOR agus:setting: USE_THOUSAND_SEPARATOR.
\nRÉ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 `.
\n\nDEFAULT_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.
\nSCAGAIR_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 `.
\nDEFAULT_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.
\nNí dhéanann sé seo difear do theachtaireachtaí earráide a sheoltar chuig:setting: ADMINS agus:setting: MANAGERS. Féach: SETTING: SERVER_EMAIL chuige sin.
\nRÉAMHSHOCRAITHE_INDEX_TABLESPACELink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nSpá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).
\nDEFAULT_TABLESPACELink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nSpá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).
\nGNÍ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.
\nRÍOMHPHOST_FILE_PATHLink to this heading#Réamhshocrú: Gan sainmhíniú
\nAn eolaire a úsáideann an: ref: `backend ríomhphoist comhad <topic-email-file-backend>`chun comhaid aschuir a stóráil.
\nRÍOMHPHOST_ÓSTLink to this heading#Réamhshocraithe: 'localhost'
An t-óstach le húsáid chun ríomhphost a sheoladh.
\nFéach freisin: socrú: EMAIL_PORT.
\nRéamhshocraithe: ``"``(Sreang folamh)
\nPasfhocal 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ú.
\nFéach freisin: socrú: EMAIL_HOST_USER.
\nRéamhshocraithe: ``"``(Sreang folamh)
\nAinm ú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ú.
\nFéach freis:socrú: EMAIL_HOST_PASSWORD.
\nRéamhshocraithe: 25
Port le húsáid don fhreastalaí SMTP atá sainmhínithe in:setting: EMAIL_HOST.
\nRÍ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.
\nRÍ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.
\nTabhair 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 ``
\nIf EMAIL_USE_SSL or EMAIL_USE_TLS is True and the\nsecure connection to the SMTP server requires client authentication, use this\nsetting to specify the path to a PEM-formatted certificate chain file, which\nmust be used in conjunction with EMAIL_SSL_KEYFILE.
EMAIL_SSL_CERTFILE should not be used with a self-signed server certificate\nor a certificate from a private certificate authority (CA). In such cases, the\nserver's certificate (or the root certificate of the private CA) should be\ninstalled into the system's CA bundle. This can be done by following\nplatform-specific instructions for installing a root CA certificate,\nor by using OpenSSL's SSL_CERT_FILE or SSL_CERT_DIR environment\nvariables to specify a custom certificate bundle (if modifying the system\nbundle is not possible or desired).
For more complex scenarios, the SMTP\nEmailBackend can be subclassed to add\nroot certificates to its ssl_context using\nssl.SSLContext.load_verify_locations().
RÍOMHPHOST_SSL_KEYFILELink to this heading#Réamhshocraithe: ``Níl ``
\nIf EMAIL_USE_SSL or EMAIL_USE_TLS is True, you can\noptionally specify the path to a PEM-formatted private key file for client\nauthentication 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.
\nRÍOMHPHOST_TIMEOUTLink to this heading#Réamhshocraithe: ``Níl ``
\nSonraíonn sé ama i soicindí chun oibríochtaí a bhlocáil cosúil leis an iarracht nasc.
\nLÁIMHSEÁLAITHE COMHAI_UASLÓDÁLAÍLink to this heading#Réamhshocraithe:
\n[\n "django.core.files.uploadhandler.MemoryFileUploadHandler",\n "django.core.files.uploadhandler.TemporaryFileUploadHandler",\n]\nLiosta 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.
\nFéach: doc: /topics/files le haghaidh sonraí.
\nFILE_UPLOAD_MAX_MÉIDE_CUIMHNEACHLink to this heading#Réamhshocraithe: 2621440` (ie 2.5 MB).
\nAn 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í.
\nFéach freis:socrú: DATA_UPLOAD_MAX_MEMORY_SIZE.
\nRéamhshocraithe: ``Níl ``
\nAn modh uimhriúil le cur i bhfeidhm ar eolairí a cruthaíodh sa phróiseas comhaid a uaslódáil.
\nCinneann 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ú.
\nLéiríonn an luach seo feidhmiúlacht agus rabhadh an shocraithe:setting: FILE_UPLOAD_PERMISSIONS.
\nCEADÚ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.
\nAr 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.
\nCinneann 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ú.
\n\nFILE_UPLOAD_TEMP_DIRLink to this heading#Réamhshocraithe: ``Níl ``
\nAn 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í.
\n`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.
\nCaithfidh 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.
\nFIXTURE_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.
\nTabhair faoi deara gur chóir go n-úsáidfeadh na cosáin seo slashes ar aghaidh i stíl Unix, fiú ar Windows.
\nFéach: tagairt: topics-tástála-daingneáin tosaitheach agus:ref: `topics-tástála-daingneáin `.
\n`AINM_SCRIPT_FORCELink to this heading#Réamhshocraithe: ``Níl ``
\nMura 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:
\n\nFOIRMS_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 ``
\nConair 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/\n formats/\n __init__.py\n en/\n __init__.py\n formats.py\nIs féidir leat an socrú seo a shocrú freisin ar liosta de chosáin Python, mar shampla:
\nFORMAT_MODULE_PATH = [\n "mysite.formats",\n "some_app.formats",\n]\nNuair 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.
\nIs iad na formáidí atá ar fáil ná:
\n\nURLACHA 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`.
\nNí úsáidtear é seo ach má tá: class: ~django.middleware.common.BrokenLinkemailsMiddleware cumasaithe (féach: doc: /topics/http/middleware).
\nAPPS_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:
\naicme cumraíochta feidhmchláir (is fearr), nó
pacáiste ina bhfuil iarratas.
Learn more about application configurations.
\n\n\nNuair 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.
\nIPS_INMHEÁNLink to this heading#Réamhshocraithe: [] (Liosta folamh)
Liosta de sheoltaí IP, mar teaghráin, go bhfuil:
\nLig 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.
\nFreastalaíonn sé trí chuspóir:
\nMura 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í.
\nRé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.
\nIs é 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.
\nMá 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.
\nSeo comhad socruithe samplach:
\nfrom django.utils.translation import gettext_lazy as _\n\nLANGUAGES = [\n ("de", _("German")),\n ("en", _("English")),\n]\nTEANGACH_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.
\nTá an liosta: téarma: `cóid teanga <language code>`do theangacha atá scríofa ar dheis go clé.
\nGo 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.
\nRéamhshocraithe: [] (Liosta folamh)
Liosta d'eolairí ina bhfuil Django ag lorg comhaid aistriúcháin. Féach:ref: cona-django-aimsitheach-aistriúcháin.
\nSampla:
\nLOCALE_PATHS = [\n "/home/www/project/common_files/locale",\n "/var/local/translations/locale",\n]\nBreathnó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.
Réamhshocraithe: Foclóir cumraíochta logála.
\nStruchtú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.
\nI 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.
\nIs féidir leat an chumraíocht logála réamhshocraithe a fheiceáil trí fhéachaint isteach: source: django/utils/log.py.
\nLOGING_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.
\nMá shocraíonn tú: socrú: LOGGING_CONFIG go None, scipeánfar an próiseas cumraíochta logála.
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.
\nMEDIA_FRÉAMHLink to this heading#Réamhshocraithe: ``"``(Sreang folamh)
\nConair iomlán córas comhaid chuig an eolaire a bheidh ina choimeád:doc: `comhaid uaslódáilte úsáideora `. </topics/files>
\nSampla: ” /var/www/example.com/media/"
Féach freis:socrú: MEDIA_URL.
\n\nRéamhshocraithe: ``"``(Sreang folamh)
\nURL 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.
\nMá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/ “
Réamhshocraithe: ``Níl ``
\nLiosta de mheán-earraí le húsáid. Féach: doc: `/topics/http/middleware `.
\nMODÚ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.
\nSampla:
\n{"blog": "blog.db_migrations"}\nSa 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á.
\nMar 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.”
\nTabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid chomhfhreagrach áitiúil agus go gcuirfear i bhfeidhm ina ionad.
\n<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.
\nRéamhshocraithe: 0
Líon na ndigití atá grúpáilte le chéile ar an gcuid sláireach d'uimhir.
\nÚ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)\nTabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid áitiúil agus go gcuirfear i bhfeidhm ina ionad sin.
\nFéach freis:socrú: DECIMAL_SEPARATOR, :setting: THOUSAND_SEPARATOR agus:setting: USE_THOUSAND_SEPARATOR.
\nPREPEND_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.
\nROOT_URLCONFLink to this heading#Réamhshocrú: Gan sainmhíniú
\nSreang 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)
\nEochair 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.
\ndjango-admin startproject automatically adds a\nrandomly-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.
\nDiúltóidh Django tosú mura bhfuil: setting: SECRET_KEY socraithe.
\n\nÚsáidtear an eochair rúnda le haghaidh:
\nAll: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.
\n\nEOCHAIR_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.
\nCINEÁL_ÁBHAR SLÁNDÁILTE_NOSNIFFLink to this heading#Réamhshocraithe: ``Fíor`
\nMá 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.
Réamhshocraithe: ````bhunús céann'
\nMura 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.
\n\nSLÁNT_PROXY_SSL_HEADERLink to this heading#Réamhshocraithe: ``Níl ``
\nTuple 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.
\nDe 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:
\nSECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")\nDeir 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í.
\nTabhair 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'
\nMá 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.
\nSSL_ÓST_SÁBHÁILTELink to this heading#Réamhshocraithe: ``Níl ``
\nMá 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ú
\nFocló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:
\nSERIALIZATION_MODULES = {"yaml": "path.to.yaml_serializer"}\nFREASTALAÍ_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.
\n\nFORMÁ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 `.
\nFéach freis:socrú: DATE_FORMAT agus:socrú: SHORT_DATETIME_FORMAT.
\nFORMÁ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 `.
\nFéach freis:socrú: DATE_FORMAT agus:socrú: SHORT_DATE_FORMAT.
\n`SIGNING_BACKENDLink to this heading#Réamhshocraithe: ``Django.Core.Signing.TimeStampSigner'` `
\nAn cúltaca a úsáidtear chun fianáin agus sonraí eile a shíniú.
\nFéach freisin an doiciméadach:doc: /topics/signing.
\nRé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.
\nFéach freisin an doiciméadach:doc: /ref/checks.
\nSTÓRÁLAÍLink to this heading#Réamhshocraithe:
\n{\n "default": {\n "BACKEND": "django.core.files.storage.FileSystemStorage",\n },\n "staticfiles": {\n "BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",\n },\n}\nFocló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.
\nIs 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:
\ndefault 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 = {\n # ...\n "example": {\n "BACKEND": "django.core.files.storage.FileSystemStorage",\n "OPTIONS": {\n "location": "/example",\n "base_url": "/example/",\n },\n },\n}\nCuirtear 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.
\n\nTEIMPLÉ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.
\nSeo 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:
\nTEMPLATES = [\n {\n "BACKEND": "django.template.backends.django.DjangoTemplates",\n "APP_DIRS": True,\n },\n]\nTá na roghanna seo a leanas ar fáil do gach cúltaca.
\n`CÚLTLink to this heading#Réamhshocrú: Gan sainmhíniú
\nAn cúltaca teimpléad le húsáid. Is iad na cúltaca teimpléad ionsuite:
\n`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').
Réamhshocraithe: féach thíos
\nAn 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
\nRé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.
`DIRSLink to this heading#Réamhshocraithe: [] (Liosta folamh)
Eolairí inar chóir don inneall comhaid foinse teimpléad a lorg, in ord cuardaigh.
\nAPP_DIRSLink to this heading#Réamhshocraithe: Fréag
Cibé an chóir don inneall comhaid foinse teimpléad a lorg taobh istigh d'fheidhmchlá
\n\nROGHANNAÍLink to this heading#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.
\nTÁST_RUNNERLink to this heading#Réamhshocraithe: ``Django.Test.Runner.DiscoverRunner'` `
\nAinm an ranga le húsáid chun an tsraith tástála a thosú. Féach: ref: `creataí tástála eile'.
\nTÁ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.
\nMoillí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.
Réamhshocraithe: ``', '``(Coma)
\nMí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.
\nFéach freis:socrú: NUMBER_GROUPING, :setting: DECIMAL_SEPARATOR agus:setting: USE_THOUSAND_SEPARATOR.
\nFORMÁ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 `.
\nFéach freis:socrú: DATE_FORMAT agus:socrú: DATETIME_FORMAT.
\nRéamhshocraithe:
\n[\n "%H:%M:%S", # '14:30:59'\n "%H:%M:%S.%f", # '14:30:59.000200'\n "%H:%M", # '14:30'\n]\nLiosta 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.
\nTá tosaíocht níos airde ag an bhformáid áitiúil agus cuirfear i bhfeidhm ina ionad sin.
\nFéach freisin: socrú: DATE_INPUT_FORMATS agus:setting: DATETIME_INPUT_FORMATS.
\nCRIOS_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.
\n\nTabhair 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.
\nNuair: 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`
\nBoolean 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.
\nFéach freis:socrú: LANGUAGE_CODE agus:socrú: USE_TZ.
\n\nRé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.
\nRéamhshocraithe: ``Fíor`
\nBoolean 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.
\nFéach freis:socrú: TIME_ZONE agus:socrú: USE_I18N.
\nÚ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.
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 ``
\nConair 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.
\nBLIAN_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í.
\nMar 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.”
\nTabhair faoi deara go bhfuil tosaíocht níos airde ag an bhformáid chomhfhreagrach áitiúil agus go gcuirfear i bhfeidhm ina ionad.
\n<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.
\nROGHANNA 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'.
\nSocruithe le haghaidh: mod: django.contrib.auth.
\nBACKENDATION_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í.
\nRé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.
\n\nRé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.
\nRéamhshocraithe: ``Níl ``
\nAn 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í)
\nTá líon na soicind a bhfuil nasc athshocraithe pasfhocal bailí dóibh.
\nÚsáidtear ag an: class: ~django.contrib.auth.views.passwordResetConfirmView.
\n\nPASSWORD_HASHERSLink to this heading#Féach:ref: auth_password_storage.
\nRéamhshocraithe:
\n[\n "django.contrib.auth.hashers.PBKDF2PasswordHasher",\n "django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher",\n "django.contrib.auth.hashers.Argon2PasswordHasher",\n "django.contrib.auth.hashers.BCryptSHA256PasswordHasher",\n "django.contrib.auth.hashers.ScryptPasswordHasher",\n]\nBAILÍ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.
\nSocruithe le haghaidh: mod: django.contrib.messages.
\nRé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í.
\n\nTEACHTAIREACHTAÍ 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í:
\n`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í.
\nNa 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.
\nSocruithe le haghaidh: mod: django.contrib.sessions.
\nSEISIÓ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.
\nINNEAL_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:
\n'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í.
\nRé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.
\nSESSION_FILE_PATHLink to this heading#Réamhshocraithe: ``Níl ``
\nMá 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.
\nSEISIÚ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:
\n'Django.Contrib.Sessions.Serializers.JSONSerializer'
Féach:ref: session_serialization le haghaidh sonraí.
\nSocruithe le haghaidh: mod: django.contrib.sites.
\nID_LÁITHREACHLink to this heading#Réamhshocrú: Gan sainmhíniú
\nAn 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
Socruithe le haghaidh: mod: django.contrib.staticfiles.
\nFRÉAMH_STATICLink to this heading#Réamhshocraithe: ``Níl ``
\nAn cosán iomlán chuig an eolaire ina mbailfidh: djadmin: collectstatic comhaid statacha le haghaidh imscartha.
\nSampla: ” /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>
\n\nRéamhshocraithe: ``Níl ``
\nURL le húsáid agus tú ag tagairt do chomhaid statacha atá suite in:setting: STATIC_ROOT.
\nSampla: "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.
\nB'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.
\n\nCOMHAD 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.:
\nSTATICFILES_DIRS = [\n "/home/special.polls.com/polls/static",\n "/home/polls.com/polls/static",\n "/opt/webfiles/common",\n]\nTabhair 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").
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 = [\n # ...\n ("downloads", "/opt/webfiles/stats"),\n]\nMar 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.:
<a href="{% static 'downloads/polls_20101022.tar.gz' %}">\nAIMSITHEOIRÍ COMHAID STATAICELink to this heading#Réamhshocraithe:
\n[\n "django.contrib.staticfiles.finders.FileSystemFinder",\n "django.contrib.staticfiles.finders.AppDirectoriesFinder",\n]\nLiosta na gcúltaca aimsitheora a bhfuil a fhios acu conas comhaid statacha a aimsiú in áiteanna éagsúla.
\nGheobhaidh 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ú
\n: socrú: CACHES
: socrú: EMAIL_USE_LOCALTIME
i18n/l10n)Link to this heading#i18n)Link to this heading#l10n)Link to this heading#Slándáil
\n\n: socrú: WSGI_APPLICATION
: socrú: LOGGING
Cosaint Falsaíochta Iarratas Trasláithreáin
\n\n<DATABASE-TEST>Bunachar sonraí: :setting: `TEST `