Lorsque vous développez avec Django, il est fréquent de vouloir afficher une page 404 personnalisée en utilisant un code comme raise Http404("Page not found.").
Dans cet article, nous allons examiner de manière pratique les causes d'apparition de l'erreur 404, comment connecter les modèles, et la gestion des erreurs 403/500.

1. Moyens représentatifs de provoquer une erreur 404

Nous avons catégorisé les cas où une erreur 404 se produit dans Django, et il semble que cela pourrait être l'un des 4 cas suivants.

1. raise Http404("Description")

C'est la méthode la plus basique pour provoquer explicitement une erreur 404.

from django.http import Http404

def my_view(request):
    if not condition:
        raise Http404("Page not found.")

2. get_object_or_404()

C'est une fonction utilitaire fréquemment utilisée dans Django. Elle génère automatiquement une erreur 404 si l'objet n'existe pas.

from django.shortcuts import get_object_or_404

post = get_object_or_404(Post, pk=pk)

3. Gestion des exceptions après utilisation de Model.objects.get()

Dans ce cas, vous devez également provoquer manuellement une erreur 404.

from django.http import Http404
from django.core.exceptions import ObjectDoesNotExist

try:
    post = Post.objects.get(pk=pk)
except ObjectDoesNotExist:
    raise Http404("Post not found.")

4. Lorsque le URLConf ou le View n'existe pas

Contrairement aux 1~3 ci-dessus, ce n'est pas une erreur 404 que le développeur a intentionnellement provoquée, mais lorsque l'utilisateur accède à une URL qui n'existe pas, Django génère automatiquement une erreur 404 en interne.

2. Méthodes de personnalisation

Conditions préalables

1. Le nom du modèle doit être 404.html.
2. Les éléments suivants doivent être configurés dans settings.py :
3. DEBUG = False
4. ALLOWED_HOSTS configuré
5. Le modèle 404.html doit être dans un emplacement accessible à Django.

Position du modèle

Exemple de connexion manuelle par handler404

# views.py
def custom_404_view(request, exception):
    return render(request, 'myapp/errors/404.html', status=404)

# urls.py
handler404 = 'myapp.views.custom_404_view'

3. Est-il possible de personnaliser les erreurs 403 et 500 ?

✔ Django permet de personnaliser les pages d'erreur suivantes en plus de la 404 :

✔ Les conditions de base sont identiques

• Le modèle ne sera appliqué que si DEBUG = False.
• Le modèle doit exister sous TEMPLATES['DIRS'] ou en utilisant APP_DIRS=True.
• Si nécessaire, les handlers handler403, handler400, handler500 peuvent être enregistrés manuellement pour les relier à des vues spécifiques.

Résumé