Как работает маршрутизация URL?

Question

Accepted Answer

**Маршрутизация URL** (URLconf) сопоставляет входящие URL-адреса запросов с **представлениями**, которые их обрабатывают. Django сопоставляет запрашиваемый URL с списком шаблонов и вызывает соответствующее представление, извлекая любые параметры из URL. ## Определение шаблонов URL ```python # urls.py from django.urls import path from . import views urlpatterns = [ path("", views.home, name="home"), # / path("articles/", views.article_list, name="article_list"), # /articles/ path("articles//", views.article_detail, name="detail"), # /articles/5/ path("articles//", views.by_slug, name="by_slug"), # /articles/my-post/ ] ``` Каждый `path()` сопоставляет шаблон URL функции представления. Django пытается их в порядке сверху вниз и использует первое совпадение. ## Захват параметров URL ```python path("articles//", 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) ``` Преобразователи пути (``, ``, ``, ``) захватывают и преобразуют части URL, передавая их в представление как аргументы. ## Именованные URL и обратное разрешение (важно!) ```python path("articles//", views.article_detail, name="detail") # the `name` ``` ```python # 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 ``` ```html Read more ``` **Именованные URL** критически важны: обращаясь к URL по их `name` (через `{% url %}` в шаблонах и `reverse()` в коде) вместо жесткого кодирования путей, вы можете изменить структуру URL в одном месте без нарушения каждой ссылки — практика DRY и безопасная для рефакторинга. ## Включение URL-адресов приложения (модульная маршрутизация) ```python # 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()` делегирует префикс URL на собственный `urls.py` приложения, сохраняя маршрутизацию модульной и каждое приложение независимым. ## Почему это важно Маршрутизация URL фундаментальна для каждого приложения Django — она определяет структуру URL вашего сайта и показывает, как запросы достигают правильного представления. Понимание этого — необходимое ежедневное знание: знание того, как определять шаблоны URL, захватывать и преобразовывать параметры из URL (преобразователи пути, такие как ``), и организовывать маршрутизацию модульно с `include()` (делегирование на URLconfs для каждого приложения) необходимо для создания любого многостраничного приложения или API. Критически важна практика **именованного URL / обратного разрешения** — обращение к URL по их `name` через `{% url %}` и `reverse()` вместо жесткого кодирования путей — которая воплощает философию DRY Django и является значительным выигрышем в плане поддерживаемости: она позволяет перестроить URL в одном месте без поиска и обновления каждой жестко закодированной ссылки по всем шаблонам и коду. Это лучшая практика, которая отличает хорошо построенные проекты Django от хрупких. Маршрутизация URL соединяет точку входа (URL) с логикой (представлениями), завершая картину обработки запросов наряду с моделями и шаблонами, делая это основным материалом, который необходимо знать для организации и обслуживания любого приложения Django.