【Django】urls.py：ルーティングの書き方（urlpatterns、path、include）

urls.pyとは

urls.pyはブラウザから送られるHTTPリクエストに対して、どのページを表示するかという指示を記載します。

より詳しく解説すると、どのページ（テンプレート）を表示するかはviews.py内に記述し、urls.pyにはviews.py内のどの関数を実行するかを記述します。

このことをルーティングといいます。

ルーティングを図に表すと次のようになります。

このルーティングを実際にプログラミングする方法を次項から解説していきます。

urls.pyの例（プロジェクトとアプリケーション）

urls.pyはプロジェクト内と各アプリケーション内に存在します。

アプリケーションのurls.pyは自動で作成されないため、自身で作成する必要があります。

それぞれのurls.py例を以下に記します。

urls.py：プロジェクトフォルダ

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('five.urls')),
]

プロジェクトフォルダのurls.pyには、デフォルトでは管理画面のルーティングであるpath('admin/', admin.site.urls)のみが記述されています。

上記ではアプリケーションfiveのurls.pyを連結する記述が追加されています。

urls.py：アプリケーションフォルダ（five）

from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='index'),
path('test/', views.index, name='test'),
]

HTTPリクエストから送られたURLにマッチするパスをurls.pyから探します。

マッチするパスを探すときはプロジェクトフォルダのurls.pyを上から順番に探していきます。

urlpatterns

urlpatternsという変数には、リスト型で「URL」と実行する「関数またはクラス」を指定します。
つまりurlpatternsのリスト内にルーティングを記載するということです。

ブラウザから送られたHTTPリクエストのURLと、urlpatternsに格納されたルーティングを順番に比較していきます。

urlpatternsに指定するURLや関数はpath関数を使用します。

path関数

urls.pyで使用するpath関数は、次のように使用します。

第一引数にはURLを指定し、第二引数には関数を指定します。
HTTPリクエストからリクエストされたURLに対応する関数またはクラスが実行されます。

プロジェクト内のurls.pyではこの後解説するinclude関数も指定します。

第二引数：関数またはクラス

path関数の第二引数には、views.pyの関数やクラスを指定します。

# 関数ベースビューの場合
path(URL, views.関数名, name=URL名称)

# クラスベースビューの場合
path(URL, views.クラス名.as_view(), name=URL名称)

name引数

name引数でURLの名称を指定できます。
そうすることにより、テンプレート内やviews.pyでその名称でURLを指定できるようになります。

nameで指定したURL名称は主に以下３つのパターンで使用されます。

• テンプレート：aタグのhref属性で指定
• views.py：redirectで使用
• views.py：reverseで使用

以下にテンプレートのaタグで使用した場合の例を記します。

# name引数で指定したURL名称の使用例 name= 'office54'の場合
<a href="{% url 'office54' %}">

aタグのhref属性に{% url 'URL名称' %}として指定します。

name引数を使うメリットとしては、指定が簡単であるということ。
そしてURLを変更してもname引数を変更していなければ、テンプレートやviews.py側を変更する必要がないということです。

include関数

path関数の第二引数にinclude関数を使うことができます。
include関数により、アプリケーション内のurls.pyを連結することができます。

引数にはアプリケーションフォルダ内のurls.pyを指定します。

include関数は主にプロジェクト内のurls.pyに使用します。

# プロジェクトフォルダのurls.py
path('', include('five.urls'))

# アプリケーションフォルダのurls.py
path('', views.index, name='index'),
path('test/', views.test, name='test'),

上記のプロジェクトフォルダでは、include関数でアプリケーションfive内のurls.pyを指定しています。

「https://ドメイン名/test/」にアクセスがあると、views.pyのtest関数が実行されます。