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**は重要です。パスをハードコードするのではなく、`name`を使って（テンプレートでは`{% url %}`、コードでは`reverse()`を使って）URLを参照することで、URLの構造を1か所変更できても、すべてのリンクが壊れることがありません。これは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()`でルーティングをモジュール化する方法（アプリごとのURLconfに委譲）を知ることは、複数ページのアプリまたはAPIを構築するために必要です。非常に重要なのは、**名前付きURL/逆解決**の実践です。パスをハードコードするのではなく、`{% url %}`と`reverse()`で`name`を使ってURLを参照することです。これはDjangoのDRYの哲学を体現し、保守性の大きな勝利です。テンプレートとコード全体でハードコードされたリンクを探して更新することなく、1か所でURLを再構成できます。これは、よく構築されたDjangoプロジェクトと脆いプロジェクトを区別するベストプラクティスです。 URLルーティングはエントリーポイント（URL）をロジック（ビュー）に接続し、モデルとテンプレートと共に、リクエスト処理の全体像を完成させます。これはDjangoアプリケーションの整理と保守のための中心的で必須の知識材料です。