URL 라우팅은 어떻게 동작하나요?

Question

URL 라우팅은 어떻게 동작하나요?

Accepted Answer

**URL 라우팅**(URLconf)은 들어오는 요청 URL을 그것을 처리하는 **view**에 매핑합니다. Django는 요청된 URL을 패턴 목록과 대조하여 해당 view를 호출하고, 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 패턴을 view 함수에 매핑합니다. Django는 위에서 아래로 시도하며 첫 번째 일치 항목을 사용합니다. ## URL 파라미터 캡처하기 ```python path("articles//", views.article_detail) # 정수를 `pk`로 캡처 # view는 캡처된 값을 파라미터로 받음 def article_detail(request, pk): # /articles/5/ 의 경우 pk = 5 article = Article.objects.get(pk=pk) ``` 경로 변환기(``, ``, ``, ``)는 URL의 일부를 캡처하고 타입 변환하여 view에 인자로 전달합니다. ## 이름 있는 URL과 역방향 해석(중요!) ```python path("articles//", views.article_detail, name="detail") # `name` ``` ```python # URL을 하드코딩하는 대신 NAME으로 생성 — DRY하고 리팩터링에 안전 from django.urls import reverse url = reverse("detail", kwargs={"pk": 5}) # → "/articles/5/" redirect("detail", pk=5) # view에서 ``` ```html Read more ``` **이름 있는 URL**은 매우 중요합니다. 경로를 하드코딩하는 대신 URL을 `name`으로 참조함으로써(template의 `{% url %}`과 코드의 `reverse()`를 통해), 모든 링크를 깨뜨리지 않고 한 곳에서 URL 구조를 변경할 수 있습니다. DRY하고 리팩터링에 안전한 관행입니다. ## app URL 포함하기(모듈식 라우팅) ```python # 프로젝트 urls.py — 각 app의 URLconf에 위임 from django.urls import include, path urlpatterns = [ path("blog/", include("blog.urls")), # /blog/... 는 blog app이 처리 path("shop/", include("shop.urls")), path("admin/", admin.site.urls), ] ``` `include()`는 URL 접두사를 app 자체의 `urls.py`에 위임하여, 라우팅을 모듈식으로 유지하고 각 app을 자체 완결적으로 만듭니다. ## 왜 중요한가 URL 라우팅은 모든 Django 애플리케이션의 근본입니다. 사이트의 URL 구조를 정의하며, 요청이 올바른 view에 도달하는 방법입니다. 이를 이해하는 것은 필수적인 일상 지식입니다. URL 패턴을 정의하고, URL에서 파라미터를 캡처하고 타입 변환하며(`` 같은 경로 변환기), `include()`로 라우팅을 모듈식으로 구성(app별 URLconf에 위임)하는 방법을 아는 것은 모든 다중 페이지 앱이나 API를 구축하는 데 필요합니다. 결정적으로 중요한 것은 **이름 있는 URL / 역방향 해석** 관행입니다. 경로를 하드코딩하는 대신 `{% url %}`과 `reverse()`를 통해 URL을 `name`으로 참조하는 것으로, Django의 DRY 철학을 구현하며 유지보수성 면에서 큰 이점입니다. 이는 template과 코드 전체에서 하드코딩된 모든 링크를 찾아 수정하지 않고도 한 곳에서 URL을 재구성할 수 있게 합니다. 이는 잘 구축된 Django 프로젝트와 취약한 프로젝트를 구분하는 모범 사례입니다. URL 라우팅은 진입점(URL)을 로직(view)에 연결하여, model과 template과 함께 요청 처리의 전체 그림을 완성합니다. 모든 Django 애플리케이션을 구성하고 유지보수하는 데 핵심적이고 반드시 알아야 할 자료입니다.