Penghalaan URL (URLconf) memetakan URL permintaan masuk kepada view yang mengendalikannya. Django memadankan URL yang diminta dengan senarai corak dan memanggil view yang sepadan, mengekstrak sebarang parameter daripada URL.
django.urls path
. views
urlpatterns = [
path(, views.home, name=),
path(, views.article_list, name=),
path(, views.article_detail, name=),
path(, views.by_slug, name=),
]
Setiap path() memetakan satu corak URL kepada satu fungsi view. Django mencubanya dari atas ke bawah dan menggunakan padanan pertama.
path("articles/<int:pk>/", views.article_detail) # captures an integer as `pk`
# the view receives the captured value as a parameter
def article_detail(request, pk): # pk = 5 for /articles/5/
article = Article.objects.get(pk=pk)
Penukar laluan (<int:pk>, <slug:slug>, <str:name>, <uuid:id>) menangkap dan menukar jenis bahagian URL, lalu menghantarnya kepada view sebagai argumen.
path("articles/<int:pk>/", views.article_detail, name="detail") # the `name`
# generate URLs by NAME instead of hardcoding them — DRY and refactor-safe
from django.urls import reverse
url = reverse("detail", kwargs={"pk": 5}) # → "/articles/5/"
redirect("detail", pk=5) # in views
<!-- in templates -->
<a href="{% url 'detail' pk=article.pk %}">Read more</a>
URL bernama adalah amat penting: dengan merujuk URL melalui name mereka (melalui {% url %} dalam templat dan reverse() dalam kod) dan bukannya menetapkan laluan secara hardcode, anda boleh menukar struktur URL di satu tempat tanpa merosakkan setiap pautan — amalan yang DRY dan selamat untuk pemfaktoran semula.
# project urls.py — delegate to each app's URLconf
from django.urls import include, path
urlpatterns = [
path("blog/", include("blog.urls")), # /blog/... handled by the blog app
path("shop/", include("shop.urls")),
path("admin/", admin.site.urls),
]
include() mewakilkan satu awalan URL kepada urls.py aplikasi itu sendiri, mengekalkan penghalaan secara bermodul dan setiap aplikasi berdikari.
Penghalaan URL adalah asas kepada setiap aplikasi Django — ia mentakrifkan struktur URL laman anda dan merupakan cara permintaan sampai ke view yang betul.
Memahaminya adalah pengetahuan harian yang penting: mengetahui cara mentakrif corak URL, menangkap dan menukar jenis parameter daripada URL (penukar laluan seperti <int:pk>), dan menyusun penghalaan secara bermodul dengan include() (mewakilkan kepada URLconf setiap aplikasi) adalah perlu untuk membina mana-mana aplikasi berbilang halaman atau API.
Yang amat penting ialah amalan URL bernama / penyelesaian songsang — merujuk URL melalui name mereka melalui {% url %} dan reverse() dan bukannya menetapkan laluan secara hardcode — yang menjelmakan falsafah DRY Django dan merupakan kelebihan kebolehselenggaraan yang besar: ia membolehkan anda menstruktur semula URL di satu tempat tanpa perlu mencari dan mengemas kini setiap pautan hardcode di seluruh templat dan kod.
Ini ialah amalan terbaik yang membezakan projek Django yang dibina dengan baik daripada yang rapuh.
Penghalaan URL menghubungkan titik masuk (URL) kepada logik (view), melengkapkan gambaran pengendalian permintaan bersama-sama model dan templat, menjadikannya bahan teras yang mesti diketahui untuk menyusun dan menyelenggara mana-mana aplikasi Django.