--- title: "Creat seiceála an chórais" version: 5.2 locale: ga source: https://docs.djangoproject.com/ga/5.2/ref/checks/ canonical: https://djangodocs.dev/ga/5.2/ref/checks/ --- # Creat seiceála an chórais Is sraith seiceálacha statacha é creat seiceála an chórais chun tionscadail Django a bhailíochtú. Braithíonn sé fadhbanna coitianta agus soláthraíonn sé leideanna maidir le conas iad a shocrú. Tá an creat inleathnaithe ionas gur féidir leat do sheiceálacha féin a chur leis go héasca. Le haghaidh sonraí maidir le conas do sheiceálacha féin a chur leis agus iad a chomhtháthú le seiceálacha córais Django, féach in:doc: Treoir ábhair seice\ ála córas. ## Tagairt API ### Seiceachtaireacht \`\` #### `class CheckMessage(level, msg, hint=None, obj=None, id=None)` Caithfidh na rabhaidh agus na hearráidí arna ardú ag seiceálacha córais a bheith ina gcásanna de “seiceachtaireacht seiceála”. Cuimsíonn cás earráid nó rabhadh amháin a thuairiscithe. Soláthraíonn sé comhthéacs agus leideanna is infheidhme maidir leis an teachtaireacht, agus aitheantóir uathúil a úsáidtear chun críocha scagtha. Is iad na hargóintí tógála: **leibhéil \`\`** Déine na teachtaireachta. Úsáid ceann de na luachanna réamhshainithe: DEBUG, INFO\`, RABHADH \`, ERROR\`, CRITICAL\`. Má tá an leibhéal níos mó nó comhionann le ```ERROR`, ansin cuirfidh Django cosc ar orduithe bainistíochta ó fhorghníomhú. Tuairiscítear teachtaireachtaí le leibhéal níos ísle ná ``ERROR``` (ie rabhaidh) don chonsól, ach is féidir iad a thostú. **`msg`** Sreang gairid (níos lú ná 80 carachtar) ag cur síos ar an bhfadhb. Níor chóir go mbeadh línte nua sa teaghrána\*. **`` `Cinn ``** Sreang aon-líne a sholáthraíonn leid chun an fhadhb a shocrú. Mura féidir aon leid a sholáthar, nó mura bhfuil an leid féin-soiléir ón teachtaireacht earráide, is féidir an leid a fhágáil, nó is féidir luach `None` a úsáid. **`` `Obj ``** Roghnach. Rud a sholáthraíonn comhthéacs don teachtaireacht (mar shampla, an tsamhail inar aimsíodh an fhadhb). Ba chóir go mbeadh an réad ina mhúnla, réimse, nó bainisteoir nó aon rud eile a shainmhíníonn modh \_\_str\_\_ () . Úsáidtear an modh agus gach teachtaireacht á thuairisciú agus bíonn a thoradh roimh an teachtaireacht. **`id`** Sreang roghnach. Aitheantóir uathúil don tsaincheist. Ba chóir d'aitheantóirí an patrún `Applabel.x001` a leanúint, áit a bhfuil X\` ceann de na litreacha `CEWID`, ag léiriú déine na teachtaireachta (`C` do chriticiúla, E\` le haghaidh earráidí agus mar sin). Is féidir leis an iarratas an uimhir a leithdháileadh, ach ba chóir go mbeadh sé uathúil laistigh den iarratas sin Tá fo-ranganna ann chun teachtaireachtaí a chruthú le leibhéil choiteanna a dhéanamh níos éasca. Agus iad á úsáid agat is féidir leat an argóint leibhéil a fhágáil toisc go bhfuil ainm an ranga intuigthe air. #### `class Debug(msg, hint=None, obj=None, id=None)` #### `class Info(msg, hint=None, obj=None, id=None)` #### `class Warning(msg, hint=None, obj=None, id=None)` #### `class Error(msg, hint=None, obj=None, id=None)` #### `class Critical(msg, hint=None, obj=None, id=None)` ## Clibeanna Builtin Eagraítear seiceálacha córais Django ag baint úsáide as na clibeanna seo a leanas: - `admin`: Seiceálacha ar aon dearbhú láithreáin riaracháin. - `async_support`: Seiceálann cumraíocht asincrónach a bhaineann leis. - `caches`: Seiceálann cumraíocht a bhaineann le taisce. - `comhoiriúnacht`: Brataíonn fadhbanna féideartha le huasghrádú leagan. - `commands`: Checks custom management commands related configuration. - `database`: Seiceálann saincheisteanna cumraíochta a bhaineann le bunachar sonraí. Ní reáchtáiltear seiceálacha bunachar sonraí de réir réamhshocraithe toisc go ndéanann siad níos mó ná anailís chód statach mar a dhéanann Ní reáchtáiltear iad ach leis an ordú:djadmin: migrate nó má shonraíonn tú ainmneacha bunachar sonraí cumraithe ag baint úsáide as an rogha `--database` agus tú ag glaoch ar an ordú:djadmin: check. - `files`: Seiceálann cumraíocht a bhaineann le comhaid. - samhlacha : Seiceálacha ar shainmhínithe samhail, réimse agus bainisteoir. - `slándála`: Seiceálann cumraíocht a bhaineann le slándáil. - `comhartha`: Seiceálacha ar dhearbhuithe comhartha agus ar chlárúcháin láimhseálaithe. - `sites`: Seiceálacha: MOD: cumraíocht django.contrib.sites. - `staticfiles`: Seiceálacha: MOD: cumraíocht django.contrib.staticfiles. - `templates`: Seiceálann cumraíocht a bhaineann le teimpléad. - `translation`: Seiceálann cumraíocht a bhaineann le haistriúchán. - `urls`: Seiceálann cumraíocht URL. Is féidir roinnt seiceálacha a chlárú le clibeanna iolracha. ## Seiceálacha lárchórais ### Tacaíocht asincrónach Fíoraíonn na seiceálacha seo a leanas do shocrú dú:doc: /topics/async: - **Async.E001**: Níor chóir duit an athróg comhshaoil: envvar: DJANGO\_ALLOW\_ASYNC\_UNSAFE a shocrú in imscaradh. \Díchumasaíonn sé seo: ref: cosaint sábháilteachta async. ### Comhoiriúnacht ar ais Tugann seiceálacha comhoiriúnachta rabhadh faoi fadhbanna féideartha a d'fhéadfadh tarlú - **2\_0.W001**: Tá 'bealach \`\`ag do phatrún URL\` `` `ina bhfuil `` (? P \<```, tosaíonn sé le ``^```, nó críochnaíonn sé le `$`. Is dócha gur maoirseacht é seo agus é ag imirce ó url () chuig: func: ~django.urls.path. - \\*\*4\_0.E001\*\*: Amhail Django 4.0, ní mór do na luachanna sa socrú: CSRF\_TRUSTED\_ORIGINS tosú le scéim (de ghnáth `http: //` nó `https: //`) ach fuarthas . ### Cáistí Fíoraíonn na seiceálacha seo a leanas go bhfuil do shuíomh: 'CACHES' cumraithe i gceart: - **Caches.E001**: Ní mór duit taisce 'default' a shainiú i do shuíomh: 'CACHES'. - \\*\*Caches.W002\*\*: D'fhéad \fadh do chumraíocht \`\` do taisce a nochtadh nó go mbeidh éilliú ar do chuid sonraí mar gheall ar a: setting: LOCATION \`a mheaitseál/tá istigh aige/ina bhfuil: setting: \`Media\_root/:SETTING: STATIC\_ROOT/:SETTING: STATICFILES\_DIRS. - \\\*\*Caches.W003\*\*: Tá do chás : socrú: SUÍOMH coibhneasta. Úsáid cosán iomlán ina ionad. ### Bunachar Sonraí #### MySQL agus MariaDB Má tá MySQL nó MariaDB á úsáid agat, déanfar na seiceálacha seo a leanas: - **MySQL.E001**: Ní cheadaíonn MySQL/MariaDB `charfield` uathúil `` `max_long `` \> 255 a bheith aige. \* Athraíodh an seiceáil seo go\* `MySQL.W003` i Django 3.1 toisc go mbraitheann an fíor-uasmhéid ar go leor fachtóirí. \* - \\*\*MySQL.W002\*\*: Níl Mód Dicht MySQL/MariaDB socraithe le haghaidh nasc bunachar sonraí . Féach freisin: ref: \`mysql-sql-mod. - **MySQL.W003**: B'fhéidir nach gceadóidh MySQL/MariaDB `charfield` uathúil `` `max_long `` \> 255 a bheith aige. ### Comhaid a bhainistiú Fíoraíonn na seiceálacha seo a leanas do shocrú dú:doc: /topics/files: - \\*\*Files.E001\*\*: Tagraíonn an socrú: FILE\_UPLOAD\_TEMP\_DIR don eolaire nach bhfuil ann . ### Réimsí múnla - **Fields.e001**: Ní chóir go gcríochnóidh ainmneacha réimse le béim. - **Fields.E002**: Ní chóir go mbeadh `"__"` in ainmneacha réimse. - **Fields.e003**: Is focal forchoimeádta é pk\` nach féidir a úsáid mar ainm réimse. - **Fields.e004**: caithfidh “roghanna” a bheith ina mapáil (m.sh. foclóir) nó athraitheach (m.sh. liosta nó tuple). - **Fields.E005**: caithfidh “roghanna” a bheith ina mapáil ar luachanna iarbhír chuig ainmneacha inléite don duine nó ina n-athrá ina bhfuil “(luach iarbhír, ainm inléite don duine) `tiúpla` (luach iarbhír, ainm inléite don duine) . - **Fields.e006**: caithfidh `db_index` a bheith `` `None ``, True\` nó `False`. - **Fields.E007**: Ní mór go mbeadh `Null=True` ag eochracha bunscoile. - **Fields.e008**: Caithfidh gach bailíodóirí a bheith inghlaonta. - \\*\*Fields.E009\*\*: tá ```max_length ``ró-bheag chun an luach is faide i `roghnaí``` (\`\` carachtair) a fheistiú. - **Fields.e010**: Ba chóir go mbeadh réamhshocrú \\`\`\`inghlaonta in ionad sampla ionas nach mbeidh sé roinnte idir gach cás réimse. - **Fields.e011**: Ní thacaíonn ``` `luachanna réamhshocraithe bunachar sonraí le nathanna (``db_default ```). - \\*\*Fields.e012\*\*: Ní féidir \`\` a úsáid i `db_default`. - **fields.E013**: `CompositePrimaryKey` must be named `pk`. - **Fields.e100**: `Autofield` caithfidhs primary\_key=True a shocrú. - **Fields.e110**: `BooleanField` ní ghlacanns le luachanna null. \* Bhí an seiceáil seo le feiceáil sular cuireadh tacaíocht do luachanna neall i Django 2.1. \* - **Fields.e120**: Caithfidh `charfield`s tréith max\_length a shainiú. - **Fields.e121**: caithfidh max\_length a bheith ina sláimhir dhearfach. - \\*\*Fields.w122\*\*: déantar neamhaird ar ```max_length ``nuair a úsáidtear é le``` . - **Fields.e130**: Ní mór do `Decimalfield`s tréith `decimal_places` a shainiú. - **Fields.e131**: caithfidh `decimal_places` a bheith ina sláimhir neamh-dhiúltach. - **Fields.e132**: Ní mór do `Decimalfield`s tréith `max_digits` a shainiú. - **Fields.e133**: caithfidh `max_digits` a bheith ina sláimhir dhearfach. - **Fields.e134**: caithfidh `max_digits` a bheith níos mó nó comhionann le `deach_places`. - **Fields.e140**: Caithfidh `allow_files` nó allow\_folders\` a bheith socraithe go True `filePathfield`. - **Fields.e150**: `GenericipAddressField` ní féidir `blank=true` a bheith ags má tá `NULL=False`, toisc go stóráiltear luachanna bána mar neamhaill. - **Fields.e160**: Tá na roghanna auto\_now\`, auto\_now\_add\`, agus `default` go comhpháirteach. Ní fhéadfaidh ach ceann amháin de na roghanna seo a bheith i láthair. - **Fields.w161**: Luach réamhshocraithe seasta ar fáil. - \\*\*Fields.w162\*\*: \Ní thacaíonn `` `le hinnéacs bunachar sonraí ar cholúin` ``. - **Fields.w163**: Ní thacaíonn `` `le tuairimí ar cholúin (` `db_comment ``). - **Fields.e170**: Ní féidir le `default` BinaryField\` a bheith ina shreang. Úsáid ábhar bytes ina ionad. - **Fields.e180**: \`\` ní thacaíonn `` `JsonField ``s. - \\*\*Fields.e190\*\*: \Ní thacaíonn \`\` le bailiú bunachar sonraí ar s. - **Fields.E220**: Ní thacaíonn \`\` `` `GeneratedField ``s. - **Fields.E221**: Ní thacaíonn `` ` `` \`\` neamh-leanúnacha `GeneratedField `s. - **Fields.e222**: \`\` ní thacaíonn ``` ``GeneratedField ```s leanúnacha. - **Fields.e223**: Tá earráidí ag `GeneratedField.output_Field`:... - **Fields.w224**: Tá rabhaidh ag `GeneratedField.output_Field`:... - **Fields.e900**: `Ipaddressfield` baineadh seachas tacaíocht in imirce stairiúla. - **Fields.w900**: Tá `iPaddressField` curtha in iúl. Bainfear tacaíocht dó (ach amháin in imirce stairiúla) i Django 1.9. \* Bhí an seiceáil seo le feiceáil i Django 1.7 agus 1.8\*. - **Fields.w901**: Tá `CommaseParatedIntegerField` curtha in iúl. Bainfear tacaíocht dó (ach amháin in imirce stairiúla) i Django 2.0. \* Bhí an seiceáil seo le feiceáil i Django 1.10 agus 1.11\*. - **Fields.e901**: baintear `CommaseParatedIntegerField` ach amháin le haghaidh tacaíochta in imirce stairiúla. - **Fields.w902**: Tá `FloatRangeField` díluaite agus bainfear é i Django 3.1. \* Bhí an seiceáil seo le feiceáil i Django 2.2 agus 3.0\*. - **Fields.w903**: Tá `NullBooleanField` as dul in iúl. Bainfear tacaíocht dó (ach amháin in imirce stairiúla) i Django 4.0. \* Bhí an seiceáil seo le feiceáil i Django 3.1 agus 3.2\*. - **Fields.e903**: baintear `Nullbooleanfield` ach amháin le haghaidh tacaíochta in imirce stairiúla. - **Fields.W904**: `Django.Contrib.Postgres.Fields.jsonField` atá díluaite. Bainfear tacaíocht dó (ach amháin in imirce stairiúla) i Django 4.0. \* Bhí an seiceáil seo le feiceáil i Django 3.1 agus 3.2\*. - **Fields.e904**: `Django.contrib.postgres.fields.jsonfield` baintear seachas tacaíocht in imirce stairiúla. - **Fields.w905**: `Django.Contrib.Postgres.Fields.CicharField` atá díluaite. Bainfear tacaíocht dó (ach amháin in imirce stairiúla) i Django 5.1. \* Bhí an seiceáil seo le feiceáil i Django 4.2 agus 5.0\*. - **Fields.e905**: `Django.contrib.postgres.fields.cicharfield` baintear seachas tacaíocht in imirce stairiúla. - **Fields.w906**: `Django.Contrib.Postgres.Fields.CiemailField` atá díluaite. Bainfear tacaíocht dó (ach amháin in imirce stairiúla) i Django 5.1. \* Bhí an seiceáil seo le feiceáil i Django 4.2 agus 5.0\*. - **Fields.e906**: `Django.contrib.postgres.fields.ciemailfield` baintear seachas tacaíocht in imirce stairiúla. - **Fields.w907**: `Django.contrib.postgres.fields.citextField` atá míchuige. Bainfear tacaíocht dó (ach amháin in imirce stairiúla) i Django 5.1. \* Bhí an seiceáil seo le feiceáil i Django 4.2 agus 5.0\*. - **Fields.e907**: `Django.contrib.postgres.fields.citextField` baintear seachas tacaíocht d'imirce stairiúla. #### Réimsí comhad - **Fields.e200**: ní argóint bailí é `unique` le haghaidh filefield\`. \* Baintear an seic seo i Django 1.11\*. - **Fields.e201**: Ní argóint bailí é `primary_key` do filefield\`. - **Fields.e202**: Caithfidh argóint `upload_` filefield\`\` cosán coibhneasta a bheith ina chosán coibhneasta, ní cosán iomlán. - **Fields.e210**: Ní féidir `ImageField` a úsáid toisc nach bhfuil Pillow suiteáilte. #### Réimsí gaolmhara - **Fields.E300**: Sainmhíníonn réimse gaol le samhail \\`\`\`, nach bhfuil suiteáilte, nó atá teibí. - \\*\*Fields.E301\*\*: Sainmhíníonn réimse gaol leis an tsamhail . \\`\`atá malartaithe amach. - \\*\*Fields.E302\*\*: Rochtaineoir droim ```. ``le haghaidh```. \. \\Buaileann `le hainm réimse`. \. \\`\`. - \\*\*Fields.E303\*\*: Ainm fiosrúcháin ar ais do ```. . Buaileann ``le hainm réimse```. \. \\`\`. - \\*\*Fields.E304\*\*: Rochtaineoir droim ```. ``le haghaidh```. \. \\Buaileann `le rochtain droim ar ais do`. \. \\`\`. - \\*\*Fields.E305\*\*: Ainm fiosrúcháin ar ais do ```. . Buaileann ``le hainm fiosrúcháin droim le haghaidh```. \. \\`\`. - \\\*\*Fields.E306\*\*: Tá an t-ainm \`\` neamhbhailí\`\` related\_name\`\` don réimse `. `. - \\*\*Fields.E307\*\*: An réimse ```. . Dearbhaíodh ``le tagairt leisciúil do```. \\\`\`, ach níl an aip\\`\` suiteáilte nó ní sholáthraíonn sé samhail \`\`. - \\*\*Fields.E308\*\*: Ní chóir go gcríochnóidh ainm fiosrúcháin droim le béim. - \\*\*Fields.E309\*\*: Ní chóir go mbeadh `` `__' `` in ainm fiosrúcháin droim . - \\\*\*Fields.E310\*\*: Níl aon fho-thacar de na réimsí ```, ``,... ar mhúnla``` uathúil. - \\*\*Fields.E311\*\*: ```. Caithfidh ``a bheith uathúil toisc go ndéanann``` ForeignKey\`\` tagairt dó. - \\\*\*Fields.E312\*\*: Níl an `to_field` \`\` ann ar an tsamhail ghaolmhar \`. \\`\`. - **Fields.e320**: Sonraíonn réimse `on_delete=set_null`, ach ní féidir a bheith neall. - **Fields.e321**: Sonraíonn an réimse `on_delete=set_default`, ach níl aon luach réamhshocraithe aige. - **Fields.e330**: Ní féidir `ManyTomanyField`s a bheith uathúil. - \\*\*Fields.E331\*\*: Sonraíonn an Réimse gaol go leor trí mhúnla , nár suiteáiltear. - **Fields.E332**: Níor chóir go leor réimsí le go leor le táblaí idirmheánacha a bheith siméadrach. \* Bhí an seiceáil seo le feiceáil roimh Django 3.0. \* - \\*\*Fields.E333\*\*: Úsáidtear an tsamhail mar mhúnla idirmheánach le `` `, ach tá níos mó ná dhá eochair eachtracha aige le` ``, atá débhríoch. Ní mór duit a shonrú cén dá eochair eachtracha ba chóir do Django a úsáid tríd an argóint eochairfhocal through\_fields. - \\*\*Fields.E334\*\*: Úsáidtear an tsamhail mar mhúnla idirmheánach le `` `, ach tá níos mó ná eochair eachtrach amháin aige ó` ``, atá débhríoch. Ní mór duit a shonrú cén eochair eachtrach ba chóir do Django a úsáid tríd an argóint eochairfhocal through\_fields. - \\*\*Fields.E335\*\*: Úsáidtear an tsamhail mar mhúnla idirmheánach le `` `, ach tá níos mó ná eochair eachtrach amháin aige le` ``, atá débhríoch. Ní mór duit a shonrú cén eochair eachtrach ba chóir do Django a úsáid tríd an argóint eochairfhocal through\_fields. - \\\*\*Fields.E336\*\*: Úsáidtear an tsamhail mar mhúnla idirghabhála le ``` , ach níl eochair eachtrach ai ge do `` ``` nó . - \\*\*Fields.e337\*\*: Sonraíonn an Réimse `through_fields` ach ní sholáthraíonn sé ainmneacha an dá réimse nasc ba chóir a úsáid don ghaol trí . - \\\*\*Fields.E338\*\*: Níl aon réimse \`\` sa tsamhail idirghabhálaí . - \\*\*Fields.E339\*\*: `` . Ní eochair eachtrach é ` ``. - \\\*\*Fields.E340\*\*: Tagann tábla idirghabhálaí an réimse `` `le hainm tábla ``/`. `. - **Fields.w340**: Níl aon éifeacht ag `null` ar ManyTomanyField\`. - **Fields.w341**: `` `ManyTomanyField `` ní thacaíonn validators . - **Fields.w342**: Tá an éifeacht chéanna ag socrú `Unique=True` ar ForeignKey\` le OneTooneField\` a úsáid. - **Fields.w343**: Níl aon éifeacht ag `limit_choices_to` ar `ManyTomanyField` le samhail `thr`. \* Bhí an seiceáil seo le feiceáil roimh Django 4.0. \* - \\\*\*Fields.W344\*\*: Tagann tábla idirghabhálaí an réimse `` `le hainm tábla `` \
/`. `. - **Fields.w345**: Níl aon éifeacht ag `related_name` ar `ManyTomanyField` le caidreamh siméadrach, m.sh. le “féin”. - **Fields.w346**: Níl aon éifeacht ag `db_comment` ar ManyTomanyField\`. - **fields.E347**: Field defines a relation involving model `` which has a `CompositePrimaryKey` and such relations are not supported. ### Samhla - **Models.E001**: \`\` ní den fhoirm `app_label.app_name `. - **Samhlach.E002**: `` `tagairtí` `` , nach bhfuil suiteáilte\, nó atá teibí. - \\*\*Samhlach.E003\*\*: Tá dhá chaidreamh comhionanna go leor ag an tsamhail tríd an tsamhail idirmheánach `. `. - **Models.e004**: ní féidir id\` a úsáid mar ainm réimse ach amháin má leagann an réimse `primary_key=true` freisin. - \\\*\*Samhlach.E005\*\*: Tá an réimse \`\` ó mhúmhúnla tuismitheora \\`\`\`i gcomhrac leis an réimse\`\` `` ó mhúmhúnla tuismitheora` ``. - \\\*\*Samhlach.E006\*\*: Buaileann an réimse \`\` leis an réimse `` ó mhúnla . - \\*\*Samhlach.E007\*\*: Tá ainm colún `` `ag an réimse `` \\`\`a úsáideann réimse eile. - **Models.e008**: caithfidh index\_together liosta nó tuple a bheith ina liosta. \* Bhí an seiceáil seo le feiceáil roimh Django 5.1. \* - **Models.E009**: Caithfidh gach eilimint index\_together a bheith ina liostaí nó tiúplaí. \* Bhí an seiceáil seo le feiceáil roimh Django 5.1. \* - **Models.e010**: caithfidh `unique_together` a bheith ina liosta nó tuple. - **Models.E011**: Caithfidh gach eilimint unique\_together a bheith ina liostaí nó tiúplaí. - \\*\*Models.E012\*\*: tagraíonn ```sriantacha/indexes/unique_together ``don réimse nach bhfuil ann``` . - \\*\*Models.E013\*\*: Tagraíonn `` `limits/indexes/unique_together `` do `ManyTomanyField` \`\` ```` ```ManyTomanyField`` ```` `ManyToManyField` ní thacaítear le `ManyTomanyField`s don rogha sin. - **Models.e014**: caithfidh “ordú” a bheith ina tuple nó liosta (fiú mura dteastaíonn uait ach réimse amháin a ordú). - \\*\*Models.E015\*\*: tagraíonn ```ordú ``don réimse nach bhfuil ann, an réimse gaolmhar, nó an cuardach``` . - \\\*\*Models.E016\*\*: tagraíonn ```sriantacha/indexes/unique_together ``do réimse``` `nach bhfuil áitiúil don mhúnla` . - \\*\*Models.E017\*\*: Tá réimsí samhlacha i samhail seachfhreastalaí . - \\*\*Models.E018\*\*: Ainm colún uathghinithe rófhada don réimse ``` `. Is é an fad uasta `` ``` do bhunachar sonraí . - \\*\*Models.E019\*\*: Ainm colún uathghinithe rófhada do réimse M2M ``` `. Is é an fad uasta `` ``` don bhunachar sonraí . - **Models.E020**: Tá an modh ranga `.check ()` athsháraithe faoi láthair. - **Models.E021**: ní féidir `ording` agus `order_with_respect_to` a úsáid le chéile. - \\*\*Models.E022\*\*: Tá tagairt leisciúil do \\`\`\`. \\\`\`, ach níl an aip\\`\` suiteáilte nó ní sholáthraíonn sé samhail \`\`. - **Models.E023**: Ní féidir leis an ainm samhail \\`\`\`tosú ná deireadh a chur le béim mar a imbhuaileann sé le comhréiteach cuardaigh na fiosrúcháin. - **Models.E024**: Ní féidir béim dhúbailte a bheith san ainm samhail \\`\`\`toisc go mbuaileann sé leis an gcomhréir cuardaigh fiosrúcháin. - **Models.E025**: Buaileann an maoin \\`\`\`le rochtaineoir réimse gaolmhar. - **Models.E026**: Ní féidir níos mó ná réimse amháin a bheith ag an tsamhail le `primary_key=true`. - \\*\*Models.W027\*\*: Ní thacaíonn le srianta seiceála. - \\\*\*Models.E028\*\*: `db_table` `` ` `` `` úsáidtear le samhlacha iolracha:` `` . - \\*\*Models.E029\*\*: níl ainm innéacs `` `uathúil do mhúnla` ``. - \\*\*Models.E030\*\*: níl ainm innéacs `` `uathúil i measc samhlacha:` ``. - \\*\*Samhlach.E031\*\*: níl ainm srianta `` `uathúil do mhúnla` ``. - \\*\*Modells.E032\*\*: níl ainm srianta \`\` uathúil i measc samhlacha: \\`\`\`. - **Models.E033**: Ní \féidir leis an ainm innéacs tosú le béim nó le huimhir. - \\*\*Models.E034\*\*: Ní féidir ainm an t-innéacs `` `a bheith níos faide ná carachtair` ``. - \\\*\*Models.W035\*\*: `db_table` \`\` \`\` úsáideann múnlaí iolracha: . - **Models.W036**: `Ní thacaíonn` le srianta uathúla le coinníollacha. - **Models.W037**: Ní thacaíonn \\`\`\`le hinnéacsanna le coinníollacha. - **Models.W038**: Ní thacaíonn \\`\`\`le srianta uathúla in-iarchurtha. - **Models.W039**: Ní thacaíonn \\`\`\`le srianta uathúla le colúin neamh-eochair. - **Models.W040**: Ní thacaíonn \\`\`\`le hinnéacsanna le colúin neamh-eochair. - \\*\*Models.E041\*\*: tagraíonn ```srianta ``don réimse ceangailte``` . - **models.E042**: `` cannot be included in the composite primary key. - **Models.W042**: Eochair phríomhchruthaithe go huathoibríoch a úsáidtear nuair nach sainmhínítear príomhchineál eochair, de réir réamhshocraithe `Django.db.Models.AutoField`. - **Models.W043**: Ní thacaíonn \\`\`\`le hinnéacsanna ar nathanna. - **Models.W044**: Ní thacaíonn \\`\`\`le srianta uathúla ar nathanna. - **Models.W045**: \Tá léiriú ```RawSQL () ``i srian seiceála``` agus ní bhailíochtfar é le linn an tsamhail \`\`full\_clean () \`. - **Models.W046**: `Ní thacaíonn` le tuairimí ar tháblaí (\\`\`db\_table\_comment\`\`). - **Models.W047**: Ní thacaíonn \\`\`\`le srianta uathúla le neamhaill ar leith. - **models.E048**: `constraints/indexes/unique_together` refers to a `CompositePrimaryKey` ``, but `CompositePrimaryKey`s are not supported for that option. ### Orduithe Bainistíochta The following checks verify custom management commands are correctly configured: - **commands.E001**: The `migrate` and `makemigrations` commands must have the same `autodetector`. ### Slándáil Ní dhéanann na seiceálacha slándála do shuíomh slán. Ní dhéanann siad iniúchadh ar chód, ní dhéanann siad braite ionbhrúite, ná ní dhéanann siad aon rud an-chasta. Ina ionad sin, cabhraíonn siad le seicliosta uathoibrithe, torthaí íseal crochta a dhéanamh, a chabhróidh leat slándáil do shuíomh a fheabhsú. B'fhéidir nach mbeidh cuid de na seiceálacha seo oiriúnach do do chumraíocht imscartha áirithe. Mar shampla, má dhéanann tú d'atreorú HTTP go HTTPS i gcothromaitheoir ualaigh, bheadh sé greannach rabhadh a thabhairt i gcónaí faoi gan cumasú: setting: SECURE\_SSL\_REDIRECT. Úsáid: SETTING: SILENCED\_SYSTEM\_CHECKS chun seiceálacha neamhriachtanacha a thostú. Reáchtáiltear na seiceálacha seo a leanas má úsáideann tú an roghna:option: check --deploy: - **Security.W001**: Níl agat:class: Django.middleware.securityMiddleware i d:setting: MIDDLEWARE mar sin an:setting: SECURE\_HSTS\_SECONDS, :setting: SECURE\_CONTENT\_TYPE\_NOSNIFF, :setting: SECURE\_REFERRER\_POLICY, :setting: SECURE\_CROSS\_ORIGIN\_OPENER\_POLICY, agus:setting: SECURE\_SSL\_REDIRECT ní bheidh aon éifeacht ag socruithe. - **Security.W002**: Níl agat:class: django.middleware.clickjacking.xframeOptionsMiddleware i do: setting: MIDDLEWARE, mar sin ní sheirbheálfar ceannteideal 'x-frame-options'\` do leathanaigh. Mura bhfuil cúis mhaith ann le do shuíomh a sheirbheáil i bhfráma, ba cheart duit smaoineamh ar an gceannteideal seo a chumasú chun cabhrú le hionsaithe clickjacking a chosc. - **Security.w003**: Ní cosúil go bhfuil tú ag úsáid cosaint bréagán iarratais tras-láithreáin ionsuite Django tríd an middleware (:class: django.middleware.csrf.csrfViewMiddleware níl i d:setting: MIDDLEWARE). Is é an midleware a chumasú an cur chuige is sábháilte chun a chinntiú nach bhfágann tú aon phoill. - **Security.W004**: Níor shocraigh tú luach don socrú: setting: SECURE\_HSTS\_SECONDS. \Mura ndéantar do shuíomh iomlán a sheirbheáil ach thar SSL, b'fhéidir gur mhaith leat smaoineamh ar luach a shocrú agus cumasú:ref: HTTP Slándáil Iompair Docht . Bí cinnte an doiciméadú a léamh ar dtús; d'fhéadfadh fadhbanna tromchúiseacha, dochúisithe a bheith ina chúis le - **Security.W005**: Níor shocraigh tú an socrú:setting: SECURE\_HSTS\_INCLUDE\_SUBDOMAINS go `True`. Gan seo, d'fhéadfadh do shuíomh a bheith leochaileach d'ionsaí trí nasc neamhchinnte le fo-fhearann. Socraigh é seo go “True” ach má tá tú cinnte gur chóir gach fofhearann de do fhearann a sheirbheáil go heisiach trí SSL. - **Security.W006**: Níl socrú do: SETTING: SECURE\_CONTENT\_TYPE\_NOSNIFF socraithe go `True`, mar sin ní sheirbheálfar ceannteideal `'X-Content-Type-Options: nosniff` do leathanaigh. Ba chóir duit smaoineamh ar an gceannteideal seo a chumasú chun an brabhsálaí a chosc ó chineál - **Security.W007**: Níl do shocrú `SECURE_BROWSER_XSS_FILTER` socraithe go `True`, mar sin ní sheirbheálfar ceannteideal `` `X-XSS: 1; mod=bloc `` do leathanaigh. Ba cheart duit smaoineamh ar an gceannteideal seo a chumasú chun scagadh XSS an bhrabhsálaí a ghníomhachtú agus cuidiú le hi \* Baintear an seiceáil seo i Django 3.0 mar ní thuilleann brabhsálaí nua-aimseartha onóir ar cheannteanntáir\* `X-XSS-Protection` \* a thuilleadh. \* - **Security.W008**: do: SETTING: Níl an socrú SECURE\_SSL\_REDIRECT socraithe go `True`. Mura chóir go mbeadh do shuíomh ar fáil thar naisc SSL agus neamh-SSL araon, b'fhéidir gur mhaith leat an socrú seo a shocrú go `True` nó cothromóir ualaigh nó freastalaí seachfhreastalaí seachfhreastalaí a chumrú chun gach nasc a atreorú chuig HTTPS. - **Security.W009**: Tá níos lú ná 50 carachtar ag your:SETTING: SECRET\_KEY, níos lú ná 5 charachtar uathúla, nó tá sé réamhshocraithe le `django-insecure-'` a léiríonn gur ghin Django é go huathoibríoch. Gin luach fada randamach le do thoil, ar shlí eile beidh go leor de ghnéithe criticiúla slándála Django leochaileach ó ionsaí. - **Security.W010**: Tá agat:mod: django.contrib.sessions i d:setting: INSTALLED\_APPS ach níl socraí:setting: SESSION\_COOKIE\_SECURE chuig `True`. Má úsáideann fianán seisiúin slán amháin, bíonn sé níos deacra do shniffers tráchta líonra seisiúin úsáideora a fhuadadh. - **Security.W011**: Tá aicme: Django.contrib.sessions.middleware.SessionMiddleware agat:setting: MIDDLEWARE, ach níl socraí:setting: SESSION\_COOKIE\_SECURE go True\`. Má úsáideann fianán seisiúin slán amháin, bíonn sé níos deacra do shniffers tráchta líonra seisiúin úsáideora a fhuadadh. - **Security.w012**: :setting: Níl SESSION\_COOKIE\_SECURE socraithe go `True`. Má úsáideann fianán seisiúin slán amháin, bíonn sé níos deacra do shniffers tráchta líonra seisiúin úsáideora a fhuadadh. - **Security.W013**: Tá agat:mod: django.contrib.sessions i d:setting: INSTALLED\_APPS, ach níl socraí:setting: SESSION\_COOKIE\_HTTPONLY go `True`. Trí úsáid a bhaint as fianán seisiúin HttpOnly, bíonn sé níos deacra d'ionsaithe scripteála tras-láithreáin seisiúin úsáideora a fhuadadh. - **Security.W014**: Tá aicme: Django.contrib.sessions.middleware.SessionMiddleware agat:setting: MIDDLEWARE, ach níl socraí:setting: SESSION\_COOKIE\_HTTPONLY chuig True\`. Trí úsáid a bhaint as fianán seisiúin HttpOnly, bíonn sé níos deacra d'ionsaithe scripteála tras-láithreáin seisiúin úsáideora a fhuadadh. - **Security.w015**: :setting: Níl SESSION\_COOKIE\_HTTPONLY socraithe go `True`. Trí úsáid a bhaint as fianán seisiúin HttpOnly, bíonn sé níos deacra d'ionsaithe scripteála tras-láithreáin seisiúin úsáideora a fhuadadh. - **Security.w016**: :setting: Níl CSRF\_COOKIE\_SECURE socraithe go `True`. Má úsáideann fianán CSRF slán amháin, bíonn sé níos deacra do shniffers tráchta líonra an comhartha CSRF a ghoid. - **Security.w017**: :setting: Níl CSRF\_COOKIE\_HTTPONLY socraithe go `True`. Trí úsáid a bhaint as fianán CSRF `HttpOnly` bíonn sé níos deacra d'ionsaithe scripteála tras-láithreáin an comhartha CSRF a ghoid. \* Baintear an seiceáil seo i Django 1.11 mar níl aon sochar praiticiúil ar fáil an\*:socrú: CSRF\_COOKIE\_HTTPONLY . \* - **Security.W018**: Níor chóir go mbeadh: socrú: DEBUG socraithe go `True` ag imscaradh. - **Security.W019**: Tá agat:class: django.middleware.clickjacking.xframeOptionsMiddleware i do: setting: MIDDLEWARE, ac:setting: X\_FRAME\_OPTIONS socraithe go 'DENY'. Mura bhfuil cúis mhaith ann le do shuíomh freastal ar chodanna eile de féin i bhfráma, ba cheart duit é a athrú go \`\`DENY'. - **Security.w020**: :setting: Níor chóir go mbeadh ALLOWED\_HOSTS folamh i imscaradh. - **Security.W021**: Níor shocraigh tú an socrú:setting: SECURE\_HSTS\_PRELOAD go `True`. Gan seo, ní féidir do shuíomh a chur isteach chuig liosta réamhluchtaithe an bhrabhsálaí. - **Security.W022**: Níor shocraigh tú an socrú:setting: SECURE\_REFERRER\_POLICY. Gan seo, ní sheolfaidh do shuíomh ceannteideal Atreora-Polasaí. Ba chóir duit smaoineamh ar an gceannteideal seo a chumasú chun príobháide - **SECURITY.E023**: Tá an socrú:setting: SECURE\_REFERRER\_POLICY socraithe agat go luach neamhbhailí. - **SECURITY.E024**: Tá socrú agata:setting: SECURE\_CROSS\_ORIGIN\_OPENER\_POLICY socraithe agat go luach neamhbhailí. - **Security.W025**: Tá níos lú ná \50 carachtar, níos lú ná 5 charachtar uathúla ag your:SETTING: SECRET\_KEY\_FALLBACKS \[n\] \`, nó tá sé réamhshocraithe le \`'django-insecure-'\`\` a léiríonn gur ghin Django é go huathoibríoch. Gin luach fada randamach le do thoil, ar shlí eile beidh go leor de ghnéithe criticiúla slándála Django leochaileach ó ionsaí. Fíoraíonn na seiceálacha seo a leanas go bhfuil do shocruithe a bhaineann le slándáil cumraithe i gceart - **Security.e100**: caithfidh `` `DEFAULT_HASHING_ALGORITHM `` a bheith `` `sha1' `` nó sha256'. \* Bhí an seiceáil seo le feiceáil i Django 3.1 agus 3.2\*. - **Security.E101**: Ní ghlacann an dearcadh teip CSRF path.to.view' an líon ceart argóintí. - **Security.E102**: Ní fhéadfaí an dearcadh teip CSRF path.to.view' a allmhairiú. ### Comharthaí - \\*\*Signals.E001\*\*: Bhí \`\` ceangailte leis an g \comhartha \`\` le tagairt leisciúil don seol \tóir `. `, ach níl an aip\\`\` suiteáilte nó ní sholáthraíonn sé samhail \`\`. ### Teimpléid Fíoraíonn na seiceálacha seo a leanas go bhfuil do shuíomh: SETTING: TEMPLATES cumraithe i gceart: - **Templates.E001**: Tá `APP_DIRS': True` agat i d:socrú: TEMPLATES ach sonraigh ```'loaders' ``i `OPTIONS``` freisin. Bain `APP_DIRS` nó bain an rogha ``` `loaders'`. * Baintear an seiceáil seo i Django 5.1 mar d'fhéadfadh seiceálacha córais a ardú anois* ``ImproperlyConfigured ``` ina ionad. \* - \\*\*Templates.E002\*\*: `string_if_invalid` in:setting: `Templates` OPTIONS ní mór a bheith ina shreang ach fuair sé: `{value}` (`{type}`). - \\*\*Templates.E003\*\*: \`\` úsáid \tear le haghaidh iolracha modúil clibeanna teimpléad: ``` `. * Athraíodh an seiceáil seo chu* ``Templates.W003 ``` *i Django 4.1.2*. - \\*\*Templates.W003\*\*: `` `úsáid tear le haghaidh iolracha modúil clibeanna teimpléad:` ``. ### Aistriúchán Déantar na seiceálacha seo a leanas ar do chumraíocht aistriúcháin: - \\*\*Translation.E001\*\*: Tá luach neamhbhailí curtha ar fáil agat don socrú: LANGUAGE\_CODE: . - \\*\*Translation.E002\*\*: Tá cód teanga neamhbhailí curtha ar fáil agat sa socrú: LANGUAGES: . - \\*\*Translation.E003\*\*: Tá cód teanga neamhbhailí curtha ar fáil agat sa socrú: LANGUAGES\_BIDI: . - **Translation.E004**: Tá luach curtha ar fáil agat don socrú:setting: LANGUAGE\_CODE nach bhfuil sa socrúchán: LANGUAGES. ### URLanna Déantar na seiceálacha seo a leanas ar do chumraíocht URL: - **URLS.W001**: Úsáideann do phatrún URL ```: func: `~django.urls.include` le ``route ``ag críochnú le ``$```. Bain an dollar ón “bealach” chun fadhbanna a sheachaint lena n-áirítear URLanna. - **URLS.w002**: Tá ```bealach ``ag do phatrún URL``` ```ag tosú le ``/```. Bain an slasc seo mar níl sé gan ghá. Má dhírítear an patrún seo in an:func: ~django.urls.include, déan cinnte go bhfuil rianú `/` ag an bpatrún: :func: ~django.urls.include. - **URLS.w003**: Tá ``` ainm `` ``` \`\` patrún URL\` `lena n-áirítear`: \\`\`. Bain an colon, chun tagairtí spás ainmneacha débhríoch a sheachaint. - \\*\*URLS.e004\*\*: Tá do phatrún URL `` `neamhbhailí. Déan cinnte go bhfuil `urlpatterns `` liosta de:func: ~django.urls.path agus/nó :func: ~django.urls.re\_path cásanna. - \\*\*URLS.w005\*\*: Níl spás ainmneacha URL uathúil. B'fhéidir nach mbeidh tú in ann gach URL sa spás ainmneacha seo a aisiompú. - **URLS.E006**: Caithfidh an socrú: Socrú: Media\_URL/:Setting: STATIC\_URL deireadh a chur le slash. - **URLS.E007**: Ní ghlacann an radharc saincheaptha `HandlerXXX` `` `path.to.view' `` an líon ceart argóintí (...). - **URLS.E008**: Ní fhéadfaí an radharc saincheaptha `HandlerXXX` path.to.view'\` a allmhairiú. - \\\*\*URLS.E009\*\*: Tá radharc \neamhbhailí ag do phatrún URL `` `, pas `` .as\_view () `` in ionad` `` . - \\\*\*URLS.w010\*\*: Tá \`\` gan chomhoiriúnú do phatrún URL . ## Seiceálacha aipeanna `contrib` ### `Riarach` Déantar seiceálacha riaracháin go léir mar chuid den chlib admin . Déantar na seiceálacha seo a leanas ar haon:class: ~django.contrib.admin.modelAdmin (nó fo-aicme) atá cláraithe leis an suíomh riaracháin: - **admin.e001**: Caithfidh luach `raw_id_fields` a bheith ina liosta nó tuple. - \\\*\*Admin.E002\*\*: Tagraíonn luach ```raw_id_fields [n] ``do``` `, nach réimse de` . - **Admin.E003**: Caithfidh luach raw\_id\_fields \[n\] a bheith ina eochair eachtrach nó ina réimse go leor. - **Admin.e004**: Caithfidh luach réimsí a bheith ina liosta nó tiúpla. - **admin.e005**: Sonraítear `fieldsets` agus fields\` araon. - **Admin.e006**: Tá réimsí dúbailte i luach réimsí réimsí dúbailte. - **admin.e007**: Caithfidh luach `fieldsets` a bheith ina liosta nó tuple. - **admin.e008**: Caithfidh luach fieldsets \[n\] a bheith ina liosta nó tuple. - **Admin.E009**: Caithfidh luach fieldsets \[n\] a bheith ar fad 2. - **Admin.e010**: Caithfidh luach fieldsets \[n\] \[1\] a bheith ina fhoclóir. - **admin.e011**: Caithfidh luach ```fieldsets [n] [1] ``an eochair ``réimsí``` a bheith ann. - **admin.e012**: Tá réimsí dúbailte ann i fieldsets \[n\] \[1\] . - \\*\*admin.e013\*\*: Ní féidir le luach ```fields [n] /filter_horizontal [n] /filter_vertical [n] /fieldsets [n] [m] ``an `manyTomanyField``` a áireamh, toisc go sonraíonn an réimse sin samhail caidrimh de láimh. - **admin.e014**: Caithfidh luach `eisiúint` a bheith ina liosta nó tuple. - **admin.e015**: Tá réimsí dúbailte i luach `eisiúint`. - **admin.e016**: Caithfidh luach `foirme` oidhreacht ó `BaseModelForm`. - **admin.e017**: Caithfidh luach `filter_vertical` a bheith ina liosta nó tuple. - **admin.e018**: Caithfidh luach `filter_horizontal` a bheith ina liosta nó tuple. - \\\*\*admin.e019\*\*: Tagraíonn luach ```filter_vertical [n] /filter_horizontal [n] ``do``` `, nach réimse de` . - **admin.e020**: Caithfidh luach filter\_vertical \[n\] /filter\_horizontal \[n\] a bheith ina réimse go leor. - **admin.e021**: Caithfidh luach `radio_fields` a bheith ina fhoclóir. - \\\*\*Admin.E022\*\*: Tagraíonn luach `radio_fields` do ``` , nach réimse de `` ```. - **Admin.E023**: Tagraíonn luach `radio_fields` do \`\` ``, nach sampla é de `ForeignKey``, agus nach bhfuil sainmhíniú \\`roghnaí aige. - \\*\*Admin.E024\*\*: Caithfidh luach ```radio_fields [] ``a bheith ``admin.horizontal``` nó `admin.vertical`. - **admin.e025**: Caithfidh luach `view_on_site` a bheith ina luach inghlaonta nó ina luach boolean. - **admin.e026**: Caithfidh luach `prepopulated_fields` a bheith ina fhoclóir. - \\\*\*admin.e027\*\*: Tagraíonn luach `prepopulated_fields` do ``` , nach réimse de `` ```. - **Admin.E028**: Tagraíonn luach `prepopulated_fields` do ``` , `` ``` \`\` Fields\`, ní chóir go mbeadh ina `DateTimeField`, `ForeignKey`, OneToOneField\`, nó réimse `ManyTomanyFi eld`. - \\*\*admin.e029\*\*: Caithfidh luach prepopulated\_fields \[\] a bheith ina liosta nó tuple. - \\\*\*admin.e030\*\*: Tagraíonn luach `prepopulated_fields` do ``` , nach réimse de `` ```. - **Admin.E031**: Caithfidh luach ordú a bheith ina liosta nó tuple. - **admin.e032**: An bhfuil an marcóir ordaithe randamach ```ag luach ``ordú```? , ach tá réimsí eile ann freisin. - \\\*\*Admin.E033\*\*: Tagraíonn luach `ordúna` do ``` , nach réimse de `` ``` é. - **admin.e034**: Caithfidh luach `readonly_fields` a bheith ina liosta nó tuple. - \\\*\*Admin.E035\*\*: Tagraíonn luach ``` readonly_fields [n] `do `` ```, \nach féidir glaoch é, tréith `` ` ``, nó tréith de \`\` . - **admin.e036**: Caithfidh luach `autocomplete_fields` a bheith ina liosta nó tuple. - \\\*\*Admin.E037\*\*: Tagraíonn luach ```autocomplete_fields [n] ``do``` `, nach réimse de` . - **admin.e038**: Caithfidh luach autocomplete\_fields \[n\] a bheith ina eochair eachtrach nó ina réimse go leor. - \\*\*Admin.e039\*\*: Caithfear riarachán do mhúnla `a chlárú chun tagairt a thabhairt dó ag` .autocomplete\_fields\`\`. - \\*\*admin.e040\*\*: ní mór \`\` `search_fields` a shainiú, toisc go \dtagraítear `.autocomplete_fields` dó. #### `Model Admin` Déantar na seiceálacha seo a leanas ar haon:class: ~django.contrib.admin.modelAdmin atá cláraithe leis an suíomh riaracháin: - **admin.e101**: Caithfidh luach save\_as a bheith ina boolean. - **admin.e102**: Caithfidh luach `save_on_top` a bheith ina boolean. - **admin.e103**: Caithfidh luach `inlines` a bheith ina liosta nó tuple. - \\*\*admin.e104\*\*: \`\` caithfidh ```oidhreacht ó ``InlineModelAdmin```. - **admin.e105**: Caithfidh ``` `tréith ``samhail ``` a bheith aige. - \\*\*Admin.E106\*\*: Caithfidh luach `.model` a bheith ina `Samhail`. - **admin.e107**: Caithfidh luach `list_display` a bheith ina liosta nó tuple. - \\\*\*Admin.E108\*\*: Tagraíonn luach ```list_display [n] ``do``` `,