{"title":"URLconf で使用するための django.urls 関数","version":"6.0","locale":"ja","docname":"ref/urls","url":"/ja/6.0/ref/urls/","canonical":"https://djangodocs.dev/ja/6.0/ref/urls/","summary":"urlpatterns に含める要素を返します。","html":"
\n

URLconf で使用するための django.urls 関数Link to this heading#

\n
\n

path()Link to this heading#

\n
\n
\npath(route, view, kwargs=None, name=None)Link to this definition#
\n
\n\n

urlpatterns に含める要素を返します。例えば：

\n
Code
from django.urls import include, path\n\nurlpatterns = [\n    path("index/", views.index, name="main-view"),\n    path("bio/<username>/", views.bio, name="bio"),\n    path("articles/<slug:title>/", views.article, name="article-detail"),\n    path("articles/<slug:title>/<int:section>/", views.section, name="article-section"),\n    path("blog/", include("blog.urls")),\n    ...,\n]\n
\n
\n

routeLink to this heading#

\n

The route argument should be a string or\ngettext_lazy() (see\nURL パターンを翻訳する) that contains a URL pattern. The string\nmay contain angle brackets (like <username> above) to capture part of the\nURL and send it as a keyword argument to the view. The angle brackets may\ninclude a converter specification (like the int part of <int:section>)\nwhich limits the characters matched and may also change the type of the\nvariable passed to the view. For example, <int:section> matches a string\nof decimal digits and converts the value to an int.

\n

リクエストを処理する際、Djangoは urlpatterns の最初のパターンから処理を開始し、リストを順番に進みながら、リクエストされたURLと各パターンを比較します。一致するパターンが見つかるまでこの比較を行い、最初に一致したパターンが処理されます。詳細については、Django のリクエスト処理 を参照してください。

\n

URLパターンは、GETやPOSTのパラメータやドメイン名にはマッチしません。例えば、https://www.example.com/myapp/ へのリクエストでは、URLconfは myapp/ を探します。また、https://www.example.com/myapp/?page=3 へのリクエストでも、URLconfは同様に myapp/ を探します。

\n
\n
\n

viewLink to this heading#

\n

view 引数は、ビュー関数、またはクラスベースビューの場合は as_view() の結果です。また、view 引数には、django.urls.include() を指定することもできます。

\n

Djangoが一致するパターンを見つけると、指定されたビュー関数を呼び出し、最初の引数として HttpRequest オブジェクトを渡し、ルートから「キャプチャされた」値をキーワード引数として渡します。

\n
\n
\n

kwargsLink to this heading#

\n

kwargs 引数を使用すると、ビュー関数またはメソッドに追加の引数を渡すことができます。例については、追加的なオプションをビュー関数に渡す を参照してください。

\n
\n
\n

nameLink to this heading#

\n

URL に名前付けをしておけば Django のどこからでも明確に参照でき、とくにテンプレートの中で有効です。この便利な機能のおかげで、プロジェクトのURLにグローバルな変更を加える場合にも1つのファイルを変更するだけで済むようになります。

\n

name 引数が有用な理由については、URL パターンの命名 を参照してください。

\n
\n
\n
\n

re_path()Link to this heading#

\n
\n
\nre_path(route, view, kwargs=None, name=None)Link to this definition#
\n
\n\n

urlpatterns に含める要素を返します。例えば：

\n
Code
from django.urls import include, re_path\n\nurlpatterns = [\n    re_path(r"^index/$", views.index, name="index"),\n    re_path(r"^bio/(?P<username>\\w+)/$", views.bio, name="bio"),\n    re_path(r"^blog/", include("blog.urls")),\n    ...,\n]\n
\n

The route argument should be a string or\ngettext_lazy() (see\nURL パターンを翻訳する) that contains a regular expression compatible\nwith Python's re module. Strings typically use raw string syntax\n(r'') so that they can contain sequences like \\d without the need to\nescape the backslash with another backslash. When a match is made, captured\ngroups from the regular expression are passed to the view -- as named arguments\nif the groups are named, and as positional arguments otherwise. The values are\npassed as strings, without any type conversion.

\n

When a route ends with $ the whole requested URL, matching against\npath_info, must match the regular expression\npattern (re.fullmatch() is used).

\n

The view, kwargs and name arguments are the same as for\npath().

\n
\n
\n

include()Link to this heading#

\n
\n
\ninclude(module, namespace=None)Link to this definition#
\n
\ninclude(pattern_list)
\n
\ninclude((pattern_list, app_namespace), namespace=None)
\n

この場所に "含める" べき他のURLconfモジュールへのフルPythonインポートパスを取る関数です。オプションで、エントリが含まれる application namespace と instance namespace も指定できます。

\n

通常、アプリケーションの名前空間は、include されたモジュールによって指定されるべきです。アプリケーションの名前空間が設定されている場合、 namespace 引数を使用して異なるインスタンスの名前空間を設定できます。

\n

include() は、URL パターンを返すイテレータ、またはそのようなイテレータに加えてアプリケーションの名前空間の名前を含む 2値タプルを引数として受け入れることもできます。

\n
\n
パラメータ:
\n
    \n

  • module -- URLconf モジュール（またはモジュール名）

    • \n

  • namespace (str) -- インクルードされる URL エントリのインスタンス名前空間

    • \n

  • pattern_list -- path() および/または re_path() のインスタンスのイテラブル。

    • \n

  • app_namespace (str) -- include される URL エントリのアプリケーション名前空間

    • \n
\n
\n
\n
\n\n

他の URLconfs をインクルードする および URLの名前空間とインクルードされた URLconfs を参照してください。

\n
\n
\n

register_converter()Link to this heading#

\n
\n
\nregister_converter(converter, type_name)Link to this definition#
\n
\n\n

The function for registering a converter for use in path()\nroutes.

\n

converter 引数はコンバータークラスであり、 type_name はパスパターンで使用するコンバーター名です。例については 独自のパスコンバータを登録する を参照してください。

\n
\n
\n
\n

URLconf で使用するための django.conf.urls の関数Link to this heading#

\n
\n

static()Link to this heading#

\n
\n
\nstatic.static(prefix, view=django.views.static.serve, **kwargs)Link to this definition#
\n
\n\n

デバッグモードでファイルを配信するための URL パターンを返すヘルパー関数です:

\n
Code
from django.conf import settings\nfrom django.conf.urls.static import static\n\nurlpatterns = [\n    # ... the rest of your URLconf goes here ...\n] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)\n
\n
\n
\n

handler400Link to this heading#

\n
\n
\nhandler400Link to this definition#
\n
\n\n

呼び出し可能オブジェクト、またはエラー状態を引き起こし、ステータスコードが400のレスポンスを送信した場合に呼び出されるべきビューへの完全なPythonインポートパスを表す文字列です。 HTTPクライアントがリクエストを送信した場合に該当します。

\n

デフォルトでは、これは django.views.defaults.bad_request() です。カスタムビューを実装する場合は、request および exception 引数を受け入れ、 HttpResponseBadRequest を返すことを確認してください。

\n
\n
\n

handler403Link to this heading#

\n
\n
\nhandler403Link to this definition#
\n
\n\n

呼び出し可能オブジェクト、またはユーザーがリソースへのアクセスに必要な権限を持っていない場合に呼び出されるべきビューの完全な Python インポートパスを表す文字列。

\n

デフォルトでは、これは django.views.defaults.permission_denied() です。カスタムビューを実装する場合には、request と exception 引数を受け入れ、 HttpResponseForbidden を返すことを確認してください。

\n
\n
\n

handler404Link to this heading#

\n
\n
\nhandler404Link to this definition#
\n
\n\n

呼び出し可能オブジェクト、もしくは、URL パターンに一致するものがない場合に呼び出されるべきビューへの完全な Python インポートパスを表す文字列。

\n

デフォルトでは、これは django.views.defaults.page_not_found() です。カスタムビューを実装する場合は、request と exception 引数を受け取り、HttpResponseNotFound を返すようにしてください。

\n
\n
\n

handler500Link to this heading#

\n
\n
\nhandler500Link to this definition#
\n
\n\n

呼び出し可能オブジェクト、もしくはサーバーエラーが発生した場合に呼び出されるべきビューを完全なPythonインポートパスで表した文字列です。サーバーエラーは、ビューコード内で実行時エラーが発生した時に起こります。

\n

デフォルトでは、これは django.views.defaults.server_error() です。独自のビューを実装する場合は、request 引数を受け取り、 HttpResponseServerError を返すことを確認してください。

\n
\n
\n","rootId":"","toc":[{"title":"URLconf で使用するための django.urls 関数","anchor":"","children":[{"title":"path()","anchor":"path","children":[{"title":"route","anchor":"route","children":[]},{"title":"view","anchor":"view","children":[]},{"title":"kwargs","anchor":"kwargs","children":[]},{"title":"name","anchor":"name","children":[]}]},{"title":"re_path()","anchor":"re-path","children":[]},{"title":"include()","anchor":"include","children":[]},{"title":"register_converter()","anchor":"register-converter","children":[]}]},{"title":"URLconf で使用するための django.conf.urls の関数","anchor":"module-django.conf.urls","children":[{"title":"static()","anchor":"static","children":[]},{"title":"handler400","anchor":"handler400","children":[]},{"title":"handler403","anchor":"handler403","children":[]},{"title":"handler404","anchor":"handler404","children":[]},{"title":"handler500","anchor":"handler500","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/6.0/ref/"}],"prev":{"docname":"ref/urlresolvers","title":"django.urls ユーティリティ関数","url":"/ja/6.0/ref/urlresolvers/"},"next":{"docname":"ref/utils","title":"Django ユーティリティ (django.utils)","url":"/ja/6.0/ref/utils/"},"formats":{"html":"/ja/6.0/ref/urls/","markdown":"/ja/6.0/ref/urls.md","json":"/ja/6.0/ref/urls.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/urls.txt","official":"https://docs.djangoproject.com/ja/6.0/ref/urls/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}