django.conf.urlsLien vers cette rubrique#patterns()Lien vers cette rubrique#Une fonction acceptant un préfixe et un nombre arbitraire de motifs d’URL, et renvoyant une liste de motifs d’URL au format attendu par Django.
\nLe premier paramètre reçu par patterns() est un préfixe textuel. Voici l’exemple de configuration d’URL présenté dans Présentation de Django:
from django.conf.urls import patterns, url\n\nurlpatterns = patterns('',\n url(r'^articles/([0-9]{4})/$', 'news.views.year_archive'),\n url(r'^articles/([0-9]{4})/([0-9]{2})/$', 'news.views.month_archive'),\n url(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', 'news.views.article_detail'),\n)\nDans cet exemple, chaque vue a un préfixe commun – 'news.views'. Au lieu de le taper pour chaque élément de la variable urlpatterns, vous pouvez utiliser le premier paramètre de la fonction patterns() pour définir un préfixe à appliquer à chaque vue.
Avec ceci, l’exemple ci-dessus peut être écrit de façon plus concise :
\nfrom django.conf.urls import patterns, url\n\nurlpatterns = patterns('news.views',\n url(r'^articles/([0-9]{4})/$', 'year_archive'),\n url(r'^articles/([0-9]{4})/([0-9]{2})/$', 'month_archive'),\n url(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', 'article_detail'),\n)\nRemarquez que l’on ne met pas de point (".") à la fin du préfixe. Django s’en charge automatiquement.
Les paramètres restants doivent être des tuples dans ce format :
\n(regular expression, Python callback function [, optional_dictionary [, optional_name]])\nLes paramètres optional_dictionary et optional_name sont décrits dans Transmission de paramètres supplémentaires à une vue.
static()Lien vers cette rubrique#Fonction utilitaire qui renvoie un motif d’URL pour servir les fichiers en mode débogage :
\nfrom 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)\nurl()Lien vers cette rubrique#urlpatterns doit être une liste d’instances url(). Par exemple :
urlpatterns = [\n url(r'^index/$', index_view, name="main-view"),\n ...\n]\nCette fonction accepte cinq paramètres, mais la plupart sont facultatifs :
\nurl(regex, view, kwargs=None, name=None, prefix='')\nLe paramètre kwargs permet de transmettre des paramètres supplémentaires à la fonction ou méthode de vue. Voir Transmission de paramètres supplémentaires à une vue pour un exemple.
Voir Nommage des motifs d’URL pour connaître l’utilité du paramètre name.
include()Lien vers cette rubrique#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”espace de noms d’application et l”espace de noms d’instance dans lesquels les éléments seront inclus.
\nHabituellement, 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 namespace peut être utilisé pour définir un espace de noms d’instance différent.
include() 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.
module – Module de configuration d’URL (ou nom de module)
namespace (string) – Espace de noms d’instance pour les lignes d’URL à inclure
app_name (string) – Espace de noms d’application pour les lignes d’URL à inclure
pattern_list – Liste d’instances django.conf.urls.url()
app_namespace (string) – Espace de noms d’application pour les lignes d’URL à inclure
instance_namespace (string) – Espace de noms d’instance pour les lignes d’URL à inclure
Voir Inclusion d’autres URLconfs et Espaces de noms d’URL et configurations d’URL incluses.
\n\nhandler400Lien vers cette rubrique#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.
\nPar défaut, il s’agit de 'django.views.defaults.bad_request'. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseBadRequest.
Consultez la documentation à propos de la vue 400 (mauvaise requête) pour plus d’informations.
\nhandler403Lien vers cette rubrique#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.
\nPar défaut, il s’agit de 'django.views.defaults.permission_denied'. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseForbidden.
Consultez la documentation à propos de la vue 403 (HTTP interdit) pour plus d’informations.
\nhandler404Lien vers cette rubrique#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.
\nPar défaut, il s’agit de 'django.views.defaults.page_not_found'. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseNotFound.
Consultez la documentation à propos de la vue 404 (HTTP non trouvé) pour plus d’informations.
\nhandler500Lien vers cette rubrique#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.
\nPar défaut, il s’agit de 'django.views.defaults.server_error'. Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseServerError.
Consultez la documentation à propos de la vue 500 (HTTP erreur interne de serveur) pour plus d’informations.
\n