Tacaíonn Django le sonraí Unicode i ngach áit.
\nInsíonn an doiciméad seo duit cad is gá duit a bheith ar an eolas má tá tú ag scríobh feidhmchláir a úsáideann sonraí nó teimpléid atá ionchódaithe i rud éigin eile seachas ASCII.
\nDéan cinnte go bhfuil do bhunachar sonraí cumraithe chun a bheith in ann sonraí sreangán treallach a stóráil De ghnáth, ciallaíonn sé seo ionchódú UTF-8 nó UTF-16 a thabhairt dó. Má úsáideann tú ionchódú níos sriantacha - mar shampla, latin1 (iso8859-1) - ní bheidh tú in ann carachtair áirithe a stóráil sa bhunachar sonraí, agus caillfear faisnéis.
\nÚsáideoirí MySQL, féach ar an `lámhleabhar MySQL `_ le haghaidh sonraí maidir le conas ionchódú tacar carachtair bunachar sonraí a shocrú nó a athrú.
Úsáideoirí PostgreSQL, féach ar an `lámhleabhar PostgreSQL `_ le haghaidh sonraí maidir le bunachair sonraí a chruthú leis an ionchódú ceart.
Úsáideoirí Oracle, féach ar an lámhleabhar Oracle le haghaidh sonraí maidir le conas ionchódú tacar carachtar bunachar sonraí a shocrú (alt 2) nó a athrú (alt 11).
Úsáideoirí SQLite, níl aon rud is gá duit a dhéanamh. Úsáideann SQLite UTF-8 i gcónaí le haghaidh ionchódú inmheánach.
Tiontaíonn cúltaca bunachar sonraí go léir Django teaghráin go huathoibríoch ina ionchódú cuí chun labhairt leis an mbunachar sonraí. Déanann siad teaghráin a aisghabhadh ón mbunachar sonraí a thiontú go huathoi Ní gá duit fiú a rá le Django cén ionchódú a úsáideann do bhunachar sonraí: déantar é sin a láimhseáil go trédhearcach.
\nLe haghaidh tuilleadh, féach an chuid “An API bunachar sonraí” thíos.
\nAon uair a úsáideann tú teaghráin le Django - m.sh. i lorg bunachar sonraí, rindreáil teimpléad nó áit ar bith eile - tá dhá rogha agat chun na teaghráin sin a ionchódú. Is féidir leat gnáthteaghráin nó bytestrings a úsáid (ag tosú le 'b').
\n\nMura n-úsáideann do chód ach sonraí ASCII, tá sé sábháilte do ghnáthshreangáin a úsáid, agus iad a chur timpeall ar uacht, toisc gur fo-thacar de UTF-8 é ASCII.
\nNá bíodh a mhealladh ag smaoineamh má tá do socrú: setting: DEFAULT_CHARSET socraithe ar rud éigin seachas utf-8' is féidir leat an t-ionchódú eile sin a úsáid i do theagraí bytestrings! :setting: Ní bhaineann DEFAULT_CHARSET ach leis na teaghráin a ghintear mar thoradh ar rindreáil teimpléid (agus ríomhphost). Glacfaidh Django le hionchódú UTF-8 i gcónaí le haghaidh bytestrings inmheánacha. Is é an chúis leis seo ná nach bhfuil an socrú: setting: DEFAULT_CHARSET faoi do smacht i ndáiríre (más tusa an forbróir feidhmchláir). Tá sé faoi smacht an duine atá ag suiteáil agus ag úsáid d'iarratas - agus má roghnaíonn an duine sin suíomh difriúil, caithfidh do chód leanúint ar aghaidh ag obair. Mar sin, ní féidir leis brath ar an suíomh sin.
I bhformhór na gcásanna nuair a bhíonn Django ag déileáil le teaghráin, tiontóidh sé iad go teaghráin sula ndéanfaidh sé aon rud eile. Mar sin, mar riail ghinearálta, má théann tú i mbytestring, bí réidh le sreang a fháil ar ais sa toradh.
\nSeachas teaghráin agus bytestrings, tá tríú cineál réad cosúil le sreanga ann a d'fhéadfá teacht ar aghaidh agus Django á úsáid agat. Tugann gnéithe idirnáisiúnaithe an chreat coincheap “aistriúcháin leisciúil” isteach - sreang atá marcáilte mar aistrithe ach nach gcinntear a thoradh aistriúcháin iarbhír go dtí go n-úsáidtear an réad i sreang. Tá an ghné seo úsáideach i gcásanna nach bhfuil an láithreán aistriúcháin ar eolas go dtí go n-úsáidtear an sreang, cé go bhféadfadh gur cruthaíodh an teaghrán ar dtús nuair a allmhairíodh an cód den chéad uair.
\nDe ghnáth, ní bheidh ort a bheith buartha faoi aistriúcháin leisciúla. Bí ar an eolas má scrúdaíonn tú réad agus maíonn sé gur django.utils.functional é. __proxy__ réad, is aistriúchán leisciúil é. Ag glaoch ar `str () ``leis an aistriúchán leisciúil mar gheobhaidh an argóint teaghrán sa réigiún reatha.
Le haghaidh tuilleadh sonraí faoi rudaí aistriúcháin leisciúil, féach ar an doiciméadach:doc: </topics/i18n/index> idirnáisiúnaíon.
\nToisc go dtagann roinnt oibríochtaí teaghráin suas arís agus arís eile, seolann Django le cúpla feidhm úsáideach ar chóir go mbeadh sé níos éasca oibriú le rudaí sreangán agus bytestring.
\nTá cúpla feidhm sa mhodúl django.utils.encoding atá áisiúil chun tiontú anall agus anall idir teaghráin agus bytestrings.
smart_str (s, encoding='utf-8', strings_only=false, errors='strict') ``athraíonn a ionchur go sreang. Sonraíonn an paraiméadar ``ionchód an ionchódú ionchuir. (Mar shampla, úsáideann Django é seo go hinmheánach agus sonraí ionchuir foirme á bpróiseáil, nach bhféadfadh a bheith ionchódaithe UTF-8.) Mar thoradh ar an bparaiméadar strings_only, má tá sé socraithe go True, ní thiontófar uimhreacha Python, booleans agus None go sreang (coinníonn siad a gcineálacha bunaidh). Glacann an paraiméadar earráidí ``aon cheann de na luachanna a nglacann feidhm ``str () Python lena láimhseáil earráide.
force_str (s, encoding='utf-8', strings_only=false, errors='strict') ``comhionann le ``smart_str () i mbeagnach gach cás. Is é an difríocht nuair is é an chéad argóint a: ref: aistriúchán leisciúil <lazy-translations>`sampla. Cé go gcaomhnóidh ``smart_str () ``aistriúcháin leisciúla, cuireann ``force_str ()` iallach ar na rudaí sin chuig teaghrán (is cúis leis an aistriúchán tarlú). De ghnáth, beidh tú ag iarraidh ``smart_str () ``a úsáid. Mar sin féin, tá ``force_str () ``úsáideach i gclibeanna teimpléad agus scagairí a bhfuil teaghrán aige go hiomlán* le bheith ag obair leo, ní amháin rud is féidir a thiontú go sreang.
Tá smart_bytes (s, encoding='utf-8', strings_only=false, errors='strict') ``go bunúsach a mhalairt de ``smart_str (). Cuireann sé iallach ar an gcéad argóint chuig bytestring. Tá an t-iompar céanna ag an bparaiméadar strings_only agus le haghaidh smart_str () ``agus ``force_str (). Is séimeantaic beagán difriúil é seo ó fheidhm 'str () ``tógáilte Python, ach tá an difríocht ag teastáil i gcúpla áit laistigh de inmheánacha Django.
De ghnáth, ní bheidh ort ach ``force_str () ``a úsáid. Glaoigh air chomh luath agus is féidir ar aon sonraí ionchuir a d'fhéadfadh a bheith ina shreang nó ina mbeagán, agus as sin ar aghaidh, is féidir leat an toradh a chóireáil mar shreang i gcónaí.
\nCaithfidh creataí gréasáin déileáil le URLanna (ar cineál IRI iad). Riachtanas amháin a bhaineann le URLanna ná go ndéantar iad a ionchódú ag baint úsáide as carachtair ASCII amháin. <3986>Mar sin féin, i <3987>dtimpeallacht idirnáisiúnta, b'fhéidir go mbeidh ort URL a thógáil ó an:rfc: IRI `-- go han-scaoilte, a:rfc: `URI a d'fhéadfadh carachtair Unicode a bheith ann. Úsáid na feidhmeanna seo chun IRI a lua agus a thiontú go URI:
\nThe django.utils.encoding.iri_to_uri() function, which implements the\nconversion from IRI to URI as required by RFC 3987 Section 3.1.
Feidhmeanna:func: urllib.parse.quote agus:func: urllib.parse.quote_plus ó leabharlann caighdeánach Python.
Tá cuspóirí beagán difriúil ag an dá ghrúpa feidhmeanna seo, agus tá sé tábhachtach iad a choinneáil díreach. De ghnáth, úsáidfeá ``quote () ``ar na codanna aonair den chosán IRI nó URI ionas go ndéantar aon charachtair áirithe mar '&' nó '% 'a ionchódú i gceart. Ansin, cuireann tú `iri_to_uri () ``i bhfeidhm ar an IRI iomlán agus athraíonn sé aon charachtair neamh-ASCII go dtí na luachanna cearta ionchódaithe.
\n\nNí athróidh an fheidhm ``iri_to_uri () ``carachtair ASCII a cheadaítear ar shlí eile i URL. Mar sin, mar shampla, ní ionchódaítear an carachtar '%' a thuilleadh nuair a chuirtear ar aghaidh chuig ``iri_to_uri () ``. Ciallaíonn sé seo gur féidir leat URL iomlán a chur chuig an bhfeidhm seo agus ní chuirfidh sé praiseach ar an sreang fiosrúcháin nó aon rud mar sin.
\nD'fhéadfadh sampla rudaí a shoiléiriú anseo:
\n>>> from urllib.parse import quote\n>>> from django.utils.encoding import iri_to_uri\n>>> quote("Paris & Orléans")\n'Paris%20%26%20Orl%C3%A9ans'\n>>> iri_to_uri("/favorites/François/%s" % quote("Paris & Orléans"))\n'/favorites/Fran%C3%A7ois/Paris%20%26%20Orl%C3%A9ans'\nMá fhéachann tú go cúramach, is féidir leat a fheiceáil nár luadh dúbailte an chuid a ghinigh le quote () ``sa dara sampla nuair a cuireadh chuig `iri_to_uri (). Is gné an-tábhachtach agus úsáideach é seo. Ciallaíonn sé gur féidir leat do IRI a thógáil gan a bheith buartha faoi an bhfuil carachtair neamh-ASCII ann agus ansin, ag an deireadh, glaoch ar `iri_to_uri () `ar an toradh.
Similarly, Django provides django.utils.encoding.uri_to_iri() which\nimplements the conversion from URI to IRI as per RFC 3987 Section 3.2.
Sampla chun a thaispeáint:
\n>>> from django.utils.encoding import uri_to_iri\n>>> uri_to_iri("/%E2%99%A5%E2%99%A5/?utf8=%E2%9C%93")\n'/♥♥/?utf8=✓'\n>>> uri_to_iri("%A9hello%3Fworld")\n'%A9hello%3Fworld'\nSa chéad shampla, ní luaitear na carachtair UTF-8. Sa dara ceann, fanann na hinchódaithe céatadáin gan athrú toisc go bhfuil siad lasmuigh den raon bailí UTF-8 nó go léiríonn siad carachtar forchoimeádta.
\nTá feidhmeanna iri_to_uri () ``agus ``uri_to_iri () idempotent, rud a chiallaíonn go bhfuil an méid seo a leanas fíor i gcónaí:
iri_to_uri(iri_to_uri(some_string)) == iri_to_uri(some_string)\nuri_to_iri(uri_to_iri(some_string)) == uri_to_iri(some_string)\nMar sin is féidir leat glaoch go sábháilte air arís agus arís eile ar an URI/IRI céanna gan fadhbanna luachana dúbailte a chur i mbaol.
\nToisc go gcuirtear gach teaghráin ar ais ón mbunachar sonraí mar rudaí str, beidh luachanna Unicode i réimsí samhail atá bunaithe ar charachtar (CharField, TextField, URLField, srl.) Nuair a aisghabhann Django sonraí ón mbunachar sonraí. Is é seo* i gcónaí* an cás, fiú dá bhféadfadh na sonraí oiriúnach i mbytestring ASCII.
\nIs féidir leat dul isteach i mbytestrings agus tú ag cruthú samhail nó ag daonrú réimse, agus déanfaidh Django é a thiontú go teaghráin nuair is gá dó.
\nNí féidir ach carachtair ASCII a bheith ag URLanna. Má tá URL á thógáil agat ó phíosaí sonraí a d'fhéadfadh a bheith neamh-ASCII, bí cúramach na torthaí a ionchódú ar bhealach atá oiriúnach do URL. Láimhseálann an fheidhm: Func: ~django.urls.reverse é seo duit go huathoibríoch.
\nMá tá URL á thógáil agat de láimh (ie, ní ag baint úsáide as an bhfeidhm reverse () `), beidh ort aire a thabhairt don ionchódú tú féin. Sa chás seo, bain úsáid as na feidhmeanna ``iri_to_uri () ``agus ``quote () a doiciméadaíodh thuas. Mar shampla:
from urllib.parse import quote\nfrom django.utils.encoding import iri_to_uri\n\n\ndef get_absolute_url(self):\n url = "/person/%s/?x=0&y=0" % quote(self.location)\n return iri_to_uri(url)\nTugann an fheidhm seo URL ionchódaithe i gceart fiú má tá self.location rud cosúil le “Thug Jack cuairt ar Pháras & Orléans”. (Go deimhin, níl an glao `iri_to_uri () ``riachtanach go docht sa sampla thuas, toisc go mbainfí na carachtair neamh-ASCII go léir agus iad ag lua sa chéad líne.)
Úsáid teaghráin agus teimpléid á chruthú de láimh:
\nfrom django.template import Template\n\nt2 = Template("This is a string template.")\nBut the common case is to read templates from the filesystem. If your template\nfiles are not stored with a UTF-8 encoding, adjust the TEMPLATES\nsetting. The built-in django backend\nprovides the 'file_charset' option to change the encoding used to read\nfiles from disk.
Rialaíonn an socrú: SETTING: DEFAULT_CHARSET ionchódú teimpléid rindreáilte. Tá sé seo socraithe go UTF-8 de réir réamhshocraithe.
\n\nMá tá sé ar intinn agat ligean d'úsáideoirí comhaid a uaslódáil, ní mór duit a chinntiú go bhfuil an timpeallacht a úsáidtear chun Django a reáchtáil cumraithe chun oibriú le hainmneacha comhaid nach Mura bhfuil do thimpeallacht cumraithe i gceart, beidh eisceachtaí UnicodeEncodeError agat agus tú ag sábháil comhaid le hainmneacha comhaid nó ábhar ina bhfuil carachtair neamh-ASCII.
\nAthraíonn tacaíocht chórais chomhaid d'ainmneacha comhaid UTF-8 agus d'fhéadfadh sé go mbraitheann sé ar an gcomhshaol. Seiceáil do chumraíocht reatha i bhlaosc idirghníomhach Python trí rith:
\nimport sys\n\nsys.getfilesystemencoding()\nBa chóir go n-aschur sé seo “UTF-8".
\nTá an t-athróg comhshaoil LANG freagrach as an ionchódú a bhfuil súil leis a shocrú ar ardáin Unix. Téigh i gcomhairle leis na cáipéisíocht do do chóras oibriúcháin agus do fhreastalaí feidhmchláir chun an comhréir agus an suíomh cuí Féach na:doc: /howto/deployment/wsgi/modwsgi le haghaidh samplaí.
\nI do thimpeallacht forbartha, b'fhéidir go mbeidh ort socrú a chur le do ~.bashrc atá cosúil le:
export LANG="en_US.UTF-8"\nIs réimse deacair é aighneacht foirme HTML. Níl aon ráthaíocht ann go mbeidh faisnéis ionchódú san aighneacht, rud a chiallaíonn go bhféadfadh go mbeadh ar an gcreat tuairim a dhéanamh ar ionchódú sonraí curtha isteach.
\nGlacann Django cur chuige “leisciúil” maidir le sonraí foirme a dhíchódú. Ní dhíchódaítear na sonraí i réad HttpRequest` ach nuair a rochtaíonn tú air. Déanta na fírinne, ní dhíchódaítear an chuid is mó de na sonraí ar chor ar bith. Níl aon díchódú i bhfeidhm orthu ach na struchtúir sonraí HttpRequest.get` agus HttpRequest.post ``. Tabharfaidh an dá réimse sin a gcuid baill ar ais mar shonraí Unicode. Tugann gach tréithe agus modh eile ``HttpRequest sonraí ar ais go díreach mar a chuir an cliant isteach iad.
De réir réamhshocraithe, úsáidtear an socrú: setting: DEFAULT_CHARSET mar an ionchódú glactha le haghaidh sonraí foirme. Más gá duit é seo a athrú le haghaidh foirm áirithe, is féidir leat an tréith encoding a shocrú ar shampla HttpRequest`. Mar shampla:
def some_view(request):\n # We know that the data must be encoded as KOI8-R (for some reason).\n request.encoding = "koi8-r"\n ...\nIs féidir leat an t-ionchódú a athrú fiú tar éis duit rochtain a fháil ar Request.get nó request.post, agus úsáidfidh gach rochtain ina dhiaidh sin an t-ionchódú nua.
Ní chaithfidh mórchuid na bhforbróirí a bheith buartha faoi ionchódú foirme a athrú, ach is gné úsáideach é seo d'iarratais a labhraíonn le córais oidhreachta nach féidir leat a n-ionchódú a rialú.
\nNí dhíchódálann Django sonraí uaslódála comhad, toisc go ndéileálfar leis na sonraí sin de ghnáth mar bhailiúcháin béite, seachas teaghráin. Athródh aon díchódú uathoibríoch ann brí sruth na mbetaí.
\n