--- title: "Feidhmeanna ``django.urls ``le húsáid in URLConfs" version: 5.2 locale: ga source: https://docs.djangoproject.com/ga/5.2/ref/urls/ canonical: https://djangodocs.dev/ga/5.2/ref/urls/ --- # Feidhmeanna django.urls le húsáid in URLConfs ## cosán () \`\` #### `path(route, view, kwargs=None, name=None)` Tugann eilimint ar ais lena n-áireamh in `urlpatterns`. Mar shampla: ``` from django.urls import include, path urlpatterns = [ path("index/", views.index, name="main-view"), path("bio//", views.bio, name="bio"), path("articles//", views.article, name="article-detail"), path("articles///", views.section, name="article-section"), path("blog/", include("blog.urls")), ..., ] ``` ### `beala` Ba chóir go mbeadh an argóint `route` ina teaghrán nó:func: ~django.utils.translation.gettext\_lazy () \`(féach:ref: \`translating-urlpatterns) ina bhfuil patrún URL. D'fhéadfadh lúibíní uillinne a bheith sa sreangán (cosúil le \\`\`\`thuas) chun cuid den URL a ghabháil agus é a sheoladh mar argóint eochairfhocal chuig an radharc. Féadfaidh sonraíocht tiontaire a bheith san áireamh sna lúibíní uillinne (cosúil leis an gcuid ```int ``de```) a chuireann teorainn leis na carachtair a mheaitseáiltear agus féadfaidh sé cineál an athróg a chuirtear chuig an radharc a athrú freisin. Mar shampla, meaitseálann \\`\`\`sreang dhigit deachúil agus athraíonn sé an luach go int\`. Agus iarratas á phróiseáil, tosaíonn Django ag an gcéad phatrún in urlpatterns agus déanann sé a bhealach síos an liosta, ag comparáid idir an URL iarrtha i gcoinne gach patrún go dtí go bhfaigheann sé ceann a mheaitseálann. Féach: ref: how django-processes-a-request le haghaidh tuilleadh sonraí. Ní mheaitseálann patrúin paraiméadair GET agus POST, nó an t-ainm fearainn. Mar shampla, in iarratas chuig `https://www.example.com/myapp/`, cuardóidh an URLConf `myapp/`. In iarratas chuig `https://www.example.com/myapp/?page=3`, cuardóidh an URLConf `myapp/` freisin. ### `` `amharc `` Is feidhm amharc é an argóint `view` nó toradh de:meth: ~django.views.generic.base.view.as\_view le haghaidh tuairimí rang-bhunaithe. Is féidir é a bheith freisin a:func: django.urls.include. Nuair a aimsíonn Django patrún meaitseála, glaonn sé an fheidhm amharc sonraithe le réad an:class: ~django.http.http.httpRequest mar an chéad argóint agus aon luachanna “gabháilte” ón mbealach mar argóintí eochairfhocal. ### `` `Kwargs `` Ligeann an argóint kwargs duit argóintí breise a chur ar aghaidh chuig an bhfeidhm nó an modh amharc. Féach:ref: views-extra-options mar shampla. ### ainm \` Ligeann ainmniú do URL duit tagairt a dhéanamh dó gan amhbhrí ó áiteanna eile i Django, go háirithe ó theimpléid laistigh de. Ligeann an ghné chumhachtach seo duit athruithe domhanda a dhéanamh ar phatrúin URL do thionscadail agus gan teagmháil le comhad amháin. Féach:ref: Patrúin URL a ainmniúch \\`maidir le cén fáth go bhfuil an argóint ainm úsáideach. ## re\_path () \`\` #### `re_path(route, view, kwargs=None, name=None)` Tugann eilimint ar ais lena n-áireamh in `urlpatterns`. Mar shampla: ``` from django.urls import include, re_path urlpatterns = [ re_path(r"^index/$", views.index, name="index"), re_path(r"^bio/(?P\w+)/$", views.bio, name="bio"), re_path(r"^blog/", include("blog.urls")), ..., ] ``` Ba chóir go mbeadh an argóint `route` ina teaghrán nó:func: ~django.utils.translation.gettext\_lazy () \`(féach:ref: \`translating-urlpatterns) ina bhfuil abairt rialta atá comhoiriúnach le modúl Python: py:mod: re. Is iondúil go n-úsáideann teaghráin comhréir sreangán amh (`r"`) ionas gur féidir leo seicheamh mar `\ d` a bheith iontu gan gá an cúlghabháil a éalú le cúltaca eile. Nuair a dhéantar meaitseáil, cuirtear grúpaí gabháilte ón léiriú rialta chuig an dearcadh - mar argóintí ainmnithe má ainmnítear na grúpaí, agus mar argóintí seasaimh a shlí eile. Cuirtear na luachanna ar aghaidh mar teaghráin, gan aon chineál comhshó. Nuair a chríochnaíonn `ród` le $\` caithfidh an URL iomlán a iarrtar, a mheaitseáil cois:attr: ~django.http.httpRequest.path\_info, an patrún abairt rialta a mheaitseáil (:py:func: re.fullmatch úsáidtear). Tá na hargóintí `dearca`, kwargs\` agus ainm mar an gcéanna le haghaidh: func: ~django.urls.path () . ## san áireamh () \` #### `include(module, namespace=None)` #### `include(pattern_list)` #### `include((pattern_list, app_namespace), namespace=None)` Feidhm a thógann cosán iomlán allmhairithe Python chuig modúl URLConf eile ba chóir a bheith “san áireamh” san áit seo. Go roghnach, is féidir an:term: spás ainmneacha feidhmchláir agus:term: spás ainmneacha sampla ina gcuirfear na hiontrálacha san áireamh iontu a shonrú freisin. De ghnáth, ba cheart an modúl san áireamh spás ainmneacha an fheidhmchláir a shonrú. Má shocraítear spás ainmneacha feidhmchláir, is féidir an argóint spás ainmneacha a úsáid chun spás ainmneacha sampla difriúil a shocrú. Glacann include () mar argóint freisin le hathrinneach a thugann patrúin URL ar ais nó le 2-tuple ina bhfuil athraitheach den sórt sin móide ainmneacha spás ainmneacha an fheidhmchláir. **Paraiméadair:** - `module` -- Modúl URLConf (nó ainm an mhodúil) - `namespace` ([`str`](https://docs.python.org/3/library/stdtypes.html#str)) -- Spás ainmneacha sampla do na hiontrálacha URL atá san áireamh - `pattern_list` -- Inathraithe o:func: ~django.urls.path agus/nó :func: ~django.urls.re\_path cásanna. - `app_namespace` ([`str`](https://docs.python.org/3/library/stdtypes.html#str)) -- Spás ainmneacha feidhmchláir do na hiontrálacha URL atá san áireamh Féach:ref: including-ear-urlconfs agus:ref: spaces-ainmnea-agus-include. ## tiontaire\_cláraigh () \`\` #### `register_converter(converter, type_name)` An fheidhm chun tiontaire a chlárú le húsáid in:func: ~django.urls.path () \`\`\`route\`s. Is aicme tiontaire é an argóint `tiontaire`, agus is é type\_name\` an t-ainm tiontaire le húsáid i bpatrúin cosáin. Féach:ref: cláraithe saincheapach-path-tionters mar shampla. > **Deprecated since Django 5.1** > > Deprecated since version 5.1: Tá an tiontaire atá ann cheana a shárú. # Feidhmeanna django.conf.urls le húsáid in URLConfs ## statach () \`\` #### `static.static(prefix, view=django.views.static.serve, **kwargs)` Feidhm chúntóra chun patrún URL a thabhairt ar ais chun comhaid a sheirbheáil i mód dífhabhtaithe: ``` from django.conf import settings from django.conf.urls.static import static urlpatterns = [ # ... the rest of your URLconf goes here ... ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) ``` ## `Handler400` #### `handler400` Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ba chóir a ghlaoch má sheol an cliant HTTP iarratas a d'fhág riocht earráide agus freagra le cód stádais 400. De réir réamhshocraithe, is é seo: func: django.views.defaults.bad\_request. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí `request` agus `exception` agus tuairisceann sé an:class: ~django.http.httpResponseBadRequest. ## `Handler403` #### `handler403` Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ar chóir a ghlaoch mura bhfuil na ceadanna a theastaíonn ag an úsáideoir chun rochtain a fháil ar acmhainn. De réir réamhshocraithe, is é seo: func: django.views.defaults.permission\_denied. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí `request` agus `exception` agus tuairisceann sé an:class: ~django.http.httpResponseForbidden. ## Handler404 \`\` #### `handler404` Is féidir glaoch, nó sreang a léiríonn cosán iomlán iompórtála Python chuig an radharc ar chóir a ghlaoch mura n-oireann aon cheann de na patrúin URL. De réir réamhshocraithe, is é seo: func: django.views.defaults.page\_not\_found. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí `request` agus `exception` agus tuairisceann sé an:class: ~django.http.httpResponseNotFound. ## `Handler500` #### `handler500` Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ar chóir a ghlaoch i gcás earráidí freastalaí. Tarlaíonn earráidí freastalaí nuair a bhíonn earráidí rith agat i gcód amharc. De réir réamhshocraithe, is é seo: func: django.views.defaults.server\_error. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le argóint `request` agus filleann sé an:class: ~django.http.httpResponseservererror.