{"title":"Fonctions utilitaires django.conf.urls","version":"1.11","locale":"fr","docname":"ref/urls","url":"/fr/1.11/ref/urls/","canonical":"https://djangodocs.dev/fr/1.11/ref/urls/","summary":"Fonction utilitaire qui renvoie un motif d’URL pour servir les fichiers en mode débogage.","html":"<span id=\"django-conf-urls-utility-functions\"></span><h1>Fonctions utilitaires <code class=\"docutils literal notranslate\">django.conf.urls</code><a class=\"heading-anchor\" href=\"#module-django.conf.urls\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<section id=\"static\">\n<h2><code class=\"docutils literal notranslate\">static()</code><a class=\"heading-anchor\" href=\"#static\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py function\">\n<dt class=\"sig sig-object py\" id=\"django.conf.urls.static.static\">\n<span class=\"sig-prename descclassname\">static.</span><span class=\"sig-name descname\">static</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">prefix</em>, <em class=\"sig-param\">view<span class=\"o\">=</span><span class=\"default_value\">django.views.static.serve</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>kwargs</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.conf.urls.static.static\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Fonction utilitaire qui renvoie un motif d’URL pour servir les fichiers en mode débogage :</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span> <span class=\"nn\">django.conf</span> <span class=\"kn\">import</span> settings\n<span class=\"kn\">from</span> <span class=\"nn\">django.conf.urls.static</span> <span class=\"kn\">import</span> static\n\nurlpatterns <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"c1\"># ... the rest of your URLconf goes here ...</span>\n<span class=\"p\">]</span> <span class=\"o\">+</span> static<span class=\"p\">(</span>settings<span class=\"o\">.</span>MEDIA_URL<span class=\"p\">,</span> document_root<span class=\"o\">=</span>settings<span class=\"o\">.</span>MEDIA_ROOT<span class=\"p\">)</span>\n</code></pre></div>\n</section>\n<section id=\"url\">\n<h2><code class=\"docutils literal notranslate\">url()</code><a class=\"heading-anchor\" href=\"#url\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py function\">\n<dt class=\"sig sig-object py\" id=\"django.conf.urls.url\">\n<span class=\"sig-name descname\">url</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">regex</em>, <em class=\"sig-param\">view</em>, <em class=\"sig-param\">kwargs<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">name<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.conf.urls.url\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p><code class=\"docutils literal notranslate\">urlpatterns</code> doit être une liste d’instances <code class=\"docutils literal notranslate\">url()</code>. Par exemple :</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span> <span class=\"nn\">django.conf.urls</span> <span class=\"kn\">import</span> include<span class=\"p\">,</span> url\n\nurlpatterns <span class=\"o\">=</span> <span class=\"p\">[</span>\n    url<span class=\"p\">(</span><span class=\"sa\">r</span><span class=\"s1\">&#39;^index/$&#39;</span><span class=\"p\">,</span> index_view<span class=\"p\">,</span> name<span class=\"o\">=</span><span class=\"s1\">&#39;main-view&#39;</span><span class=\"p\">),</span>\n    url<span class=\"p\">(</span><span class=\"sa\">r</span><span class=\"s1\">&#39;^weblog/&#39;</span><span class=\"p\">,</span> include<span class=\"p\">(</span><span class=\"s1\">&#39;blog.urls&#39;</span><span class=\"p\">)),</span>\n    <span class=\"o\">...</span>\n<span class=\"p\">]</span>\n</code></pre></div>\n<p>Le paramètre <code class=\"docutils literal notranslate\">regex</code> devrait être une chaîne ou une valeur <a class=\"reference internal\" href=\"/fr/1.11/ref/utils/#django.utils.translation.ugettext_lazy\" title=\"django.utils.translation.ugettext_lazy\"><code class=\"xref py py-func docutils literal notranslate\">ugettext_lazy()</code></a> (voir <a class=\"reference internal\" href=\"/fr/1.11/topics/i18n/translation/#translating-urlpatterns\"><span class=\"std std-ref\">Traduction de motifs d’URL</span></a>) contenant une expression régulière compatible avec le module <a class=\"reference external\" href=\"https://docs.python.org/3/library/re.html#module-re\" title=\"(disponible dans Python v3.14)\"><code class=\"xref py py-mod docutils literal notranslate\">re</code></a> de Python. Les chaînes utilisent typiquement la syntaxe des chaînes brutes (<code class=\"docutils literal notranslate\">r''</code>) afin qu’elles puissent contenir des séquences telles que <code class=\"docutils literal notranslate\">\\d</code> sans devoir échapper la barre oblique inverse avec une autre barre.</p>\n<p>Le paramètre <code class=\"docutils literal notranslate\">view</code> est une fonction de vue ou le résultat de <a class=\"reference internal\" href=\"/fr/1.11/ref/class-based-views/base/#django.views.generic.base.View.as_view\" title=\"django.views.generic.base.View.as_view\"><code class=\"xref py py-meth docutils literal notranslate\">as_view()</code></a> pour les vues fondées sur des classes. Cela peut aussi être une inclusion <a class=\"reference internal\" href=\"#django.conf.urls.include\" title=\"django.conf.urls.include\"><code class=\"xref py py-func docutils literal notranslate\">include()</code></a>.</p>\n<p>Le paramètre <code class=\"docutils literal notranslate\">kwargs</code> permet de transmettre des paramètres supplémentaires à la fonction ou méthode de vue. Voir <a class=\"reference internal\" href=\"/fr/1.11/topics/http/urls/#views-extra-options\"><span class=\"std std-ref\">Transmission de paramètres supplémentaires à une vue</span></a> pour un exemple.</p>\n<p>Voir <a class=\"reference internal\" href=\"/fr/1.11/topics/http/urls/#naming-url-patterns\"><span class=\"std std-ref\">Nommage des motifs d’URL</span></a> pour connaître l’utilité du paramètre <code class=\"docutils literal notranslate\">name</code>.</p>\n</section>\n<section id=\"include\">\n<h2><code class=\"docutils literal notranslate\">include()</code><a class=\"heading-anchor\" href=\"#include\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py function\">\n<dt class=\"sig sig-object py\" id=\"django.conf.urls.include\">\n<span class=\"sig-name descname\">include</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">module</em>, <em class=\"sig-param\">namespace<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">app_name<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.conf.urls.include\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dt class=\"sig sig-object py\">\n<span class=\"sig-name descname\">include</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">pattern_list</em><span class=\"sig-paren\">)</span></dt>\n<dt class=\"sig sig-object py\">\n<span class=\"sig-name descname\">include</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">(pattern_list</em>, <em class=\"sig-param\">app_namespace)</em>, <em class=\"sig-param\">namespace=None</em><span class=\"sig-paren\">)</span></dt>\n<dt class=\"sig sig-object py\">\n<span class=\"sig-name descname\">include</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">(pattern_list</em>, <em class=\"sig-param\">app_namespace</em>, <em class=\"sig-param\">instance_namespace)</em><span class=\"sig-paren\">)</span></dt>\n<dd><p>Une fonction acceptant un chemin d’importation Python complet vers un autre module de configuration d’URL devant être « inclus » à cet endroit. Il est possible d’indiquer aussi l”<a class=\"reference internal\" href=\"/fr/1.11/topics/http/urls/#term-application-namespace\"><span class=\"xref std std-term\">espace de noms d’application</span></a> et l”<a class=\"reference internal\" href=\"/fr/1.11/topics/http/urls/#term-instance-namespace\"><span class=\"xref std std-term\">espace de noms d’instance</span></a> dans lesquels les éléments seront inclus.</p>\n<p>Habituellement, l’espace de noms d’application doit être défini par le module inclus. Si un espace de noms d’application est défini, le paramètre <code class=\"docutils literal notranslate\">namespace</code> peut être utilisé pour définir un espace de noms d’instance différent.</p>\n<p><code class=\"docutils literal notranslate\">include()</code> accepte aussi en paramètre soit un objet itérable renvoyant des motifs d’URL, un tuple binaire contenant l’objet itérable avec les noms des espaces de noms d’application, ou un tuple ternaire contenant un tel objet itérable accompagné des noms des espaces de noms d’application et d’instance.</p>\n<dl class=\"field-list simple\">\n<dt class=\"field-odd\">Paramètres<span class=\"colon\">:</span></dt>\n<dd class=\"field-odd\"><ul class=\"simple\">\n<li><p><strong>module</strong> – Module de configuration d’URL (ou nom de module)</p></li>\n<li><p><strong>namespace</strong> (<a class=\"reference external\" href=\"https://docs.python.org/3/library/stdtypes.html#str\" title=\"(disponible dans Python v3.14)\"><em>str</em></a>) – Espace de noms d’instance pour les lignes d’URL à inclure</p></li>\n<li><p><strong>app_name</strong> (<a class=\"reference external\" href=\"https://docs.python.org/3/library/stdtypes.html#str\" title=\"(disponible dans Python v3.14)\"><em>str</em></a>) – Espace de noms d’application pour les lignes d’URL à inclure</p></li>\n<li><p><strong>pattern_list</strong> – Liste d’instances <a class=\"reference internal\" href=\"#django.conf.urls.url\" title=\"django.conf.urls.url\"><code class=\"xref py py-func docutils literal notranslate\">django.conf.urls.url()</code></a></p></li>\n<li><p><strong>app_namespace</strong> (<a class=\"reference external\" href=\"https://docs.python.org/3/library/stdtypes.html#str\" title=\"(disponible dans Python v3.14)\"><em>str</em></a>) – Espace de noms d’application pour les lignes d’URL à inclure</p></li>\n<li><p><strong>instance_namespace</strong> (<a class=\"reference external\" href=\"https://docs.python.org/3/library/stdtypes.html#str\" title=\"(disponible dans Python v3.14)\"><em>str</em></a>) – Espace de noms d’instance pour les lignes d’URL à inclure</p></li>\n</ul>\n</dd>\n</dl>\n</dd></dl>\n\n<p>Voir <a class=\"reference internal\" href=\"/fr/1.11/topics/http/urls/#including-other-urlconfs\"><span class=\"std std-ref\">Inclusion d’autres URLconfs</span></a> et <a class=\"reference internal\" href=\"/fr/1.11/topics/http/urls/#namespaces-and-include\"><span class=\"std std-ref\">Espaces de noms d’URL et configurations d’URL incluses</span></a>.</p>\n<aside class=\"version-note version-deprecated\" data-version=\"1.9\" role=\"note\">\n<p class=\"version-note-title\">Deprecated since Django 1.9</p><p><span class=\"versionmodified deprecated\">Obsolète depuis la version 1.9: </span>La prise en charge du paramètre <code class=\"docutils literal notranslate\">app_name</code> est obsolète et sera supprimée dans Django 2.0. Indiquez plutôt <code class=\"docutils literal notranslate\">app_name</code> de la manière présentée dans <a class=\"reference internal\" href=\"/fr/1.11/topics/http/urls/#namespaces-and-include\"><span class=\"std std-ref\">Espaces de noms d’URL et configurations d’URL incluses</span></a>.</p>\n<p>La possibilité de passer un tuple de 3 éléments est également obsolète et sera supprimée dans Django 2.0. Passez un tuple à 2 éléments contenant la liste des motifs et l’espace de noms d’application, et utilisez à la place le paramètre <code class=\"docutils literal notranslate\">namespace</code>.</p>\n<p>Enfin, la prise en charge d’un espace de noms d’instance sans espace de noms d’application est maintenant obsolète et sera supprimée dans Django 2.0. Indiquez l’espace de noms d’application ou supprimez l’espace de noms d’instance.</p>\n</aside>\n</section>\n<section id=\"handler400\">\n<h2><code class=\"docutils literal notranslate\">handler400</code><a class=\"heading-anchor\" href=\"#handler400\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py data\">\n<dt class=\"sig sig-object py\" id=\"django.conf.urls.handler400\">\n<span class=\"sig-name descname\">handler400</span><a class=\"heading-anchor\" href=\"#django.conf.urls.handler400\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée si le client HTTP a envoyé une requête qui a provoqué une condition d’erreur et une réponse avec un code de statut 400.</p>\n<p>Par défaut, il s’agit de <code class=\"docutils literal notranslate\">'django.views.defaults.bad_request'</code>. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse <a class=\"reference internal\" href=\"/fr/1.11/ref/request-response/#django.http.HttpResponseBadRequest\" title=\"django.http.HttpResponseBadRequest\"><code class=\"xref py py-class docutils literal notranslate\">HttpResponseBadRequest</code></a>.</p>\n<p>Consultez la documentation à propos de la <a class=\"reference internal\" href=\"/fr/1.11/ref/views/#http-bad-request-view\"><span class=\"std std-ref\">vue 400 (mauvaise requête)</span></a> pour plus d’informations.</p>\n</section>\n<section id=\"handler403\">\n<h2><code class=\"docutils literal notranslate\">handler403</code><a class=\"heading-anchor\" href=\"#handler403\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py data\">\n<dt class=\"sig sig-object py\" id=\"django.conf.urls.handler403\">\n<span class=\"sig-name descname\">handler403</span><a class=\"heading-anchor\" href=\"#django.conf.urls.handler403\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée si l’utilisateur n’a pas les droits nécessaires pour accéder à une ressource.</p>\n<p>Par défaut, il s’agit de <code class=\"docutils literal notranslate\">'django.views.defaults.permission_denied'</code>. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse <a class=\"reference internal\" href=\"/fr/1.11/ref/request-response/#django.http.HttpResponseForbidden\" title=\"django.http.HttpResponseForbidden\"><code class=\"xref py py-class docutils literal notranslate\">HttpResponseForbidden</code></a>.</p>\n<p>Consultez la documentation à propos de la <a class=\"reference internal\" href=\"/fr/1.11/ref/views/#http-forbidden-view\"><span class=\"std std-ref\">vue 403 (HTTP interdit)</span></a> pour plus d’informations.</p>\n</section>\n<section id=\"handler404\">\n<h2><code class=\"docutils literal notranslate\">handler404</code><a class=\"heading-anchor\" href=\"#handler404\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py data\">\n<dt class=\"sig sig-object py\" id=\"django.conf.urls.handler404\">\n<span class=\"sig-name descname\">handler404</span><a class=\"heading-anchor\" href=\"#django.conf.urls.handler404\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée si aucun des motifs d’URL ne correspond.</p>\n<p>Par défaut, il s’agit de <code class=\"docutils literal notranslate\">'django.views.defaults.page_not_found'</code>. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse <a class=\"reference internal\" href=\"/fr/1.11/ref/request-response/#django.http.HttpResponseNotFound\" title=\"django.http.HttpResponseNotFound\"><code class=\"xref py py-class docutils literal notranslate\">HttpResponseNotFound</code></a>.</p>\n<p>Consultez la documentation à propos de la <a class=\"reference internal\" href=\"/fr/1.11/ref/views/#http-not-found-view\"><span class=\"std std-ref\">vue 404 (HTTP non trouvé)</span></a> pour plus d’informations.</p>\n</section>\n<section id=\"handler500\">\n<h2><code class=\"docutils literal notranslate\">handler500</code><a class=\"heading-anchor\" href=\"#handler500\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py data\">\n<dt class=\"sig sig-object py\" id=\"django.conf.urls.handler500\">\n<span class=\"sig-name descname\">handler500</span><a class=\"heading-anchor\" href=\"#django.conf.urls.handler500\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée en cas d’erreur de serveur. Les erreurs de serveur se produisent lorsque des erreurs d’exécution apparaissent dans le code des vues.</p>\n<p>Par défaut, il s’agit de <code class=\"docutils literal notranslate\">'django.views.defaults.server_error'</code>. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse <a class=\"reference internal\" href=\"/fr/1.11/ref/request-response/#django.http.HttpResponseServerError\" title=\"django.http.HttpResponseServerError\"><code class=\"xref py py-class docutils literal notranslate\">HttpResponseServerError</code></a>.</p>\n<p>Consultez la documentation à propos de la <a class=\"reference internal\" href=\"/fr/1.11/ref/views/#http-internal-server-error-view\"><span class=\"std std-ref\">vue 500 (HTTP erreur interne de serveur)</span></a> pour plus d’informations.</p>\n</section>","rootId":"module-django.conf.urls","toc":[{"title":"static()","anchor":"static","children":[]},{"title":"url()","anchor":"url","children":[]},{"title":"include()","anchor":"include","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":"Référence de l’API","url":"/fr/1.11/ref/"}],"prev":{"docname":"ref/urlresolvers","title":"Fonctions utilitaires django.urls","url":"/fr/1.11/ref/urlresolvers/"},"next":{"docname":"ref/utils","title":"Utilitaires Django","url":"/fr/1.11/ref/utils/"},"formats":{"html":"/fr/1.11/ref/urls/","markdown":"/fr/1.11/ref/urls.md","json":"/fr/1.11/ref/urls.json"},"source":"https://github.com/django/django/blob/stable/1.11.x/docs/ref/urls.txt","official":"https://docs.djangoproject.com/fr/1.11/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","fr","ja","id","pt-br","ko","es","el","pl"]}