Personnaliser les pages d'erreur

3 min de lecture07 novembre 2026

Une page d'erreur par défaut est utile au serveur, pas au visiteur. La personnaliser améliore la navigation et l'image du site, à condition de conserver le bon code HTTP et de ne rien révéler sur l'infrastructure.

1. Distinguer les codes

Code	Sens	Ce que voit le visiteur
`404`	ressource inexistante	il s'est trompé d'URL ou le contenu a été déplacé
`403`	accès refusé	il n'a pas les droits, ou un fichier protégé
`500`	erreur serveur	le code a échoué, sans détail public

Ne renvoyez pas 200 avec un message « page introuvable » : c'est un soft 404, que les moteurs de recherche et les outils de supervision interprètent mal. De même, ne masquez pas une 500 en 404 : vous perdriez l'alerte et le diagnostic.

2. Configurer Apache

À la racine du site, dans .htaccess :

Texte

ErrorDocument 404 /erreurs/404.html
ErrorDocument 500 /erreurs/500.html

Le chemin part de la racine web et commence par /. Le fichier doit exister et être lisible. Pour une 500, utilisez une page statique (.html), jamais un script PHP : si PHP est en cause, la page de secours échouerait à son tour et créerait une boucle.

3. Rédiger une page utile

Un titre clair : « Page introuvable ».
Une phrase qui explique quoi faire, sans jargon.
Un lien vers l'accueil et vers le centre d'aide (/help).
Une recherche interne si le site en propose une.
Une adresse de contact pour signaler un lien mort.

Ne publiez jamais : trace d'exécution, version de PHP ou du serveur, chemin absolu, requête SQL, nom d'utilisateur, adresse e-mail interne. Ces informations facilitent la reconnaissance d'une cible.

4. Respecter KeyHelp

Si KeyHelp fournit un réglage global pour les pages d'erreur, utilisez-le pour le domaine concerné. Évitez de modifier des fichiers de modèle partagés : vos changements pourraient affecter d'autres sites ou être écrasés lors d'une mise à jour.

Les erreurs réelles doivent être journalisées côté serveur. La page publique informe, le journal diagnostique. Configurez l'affichage des erreurs PHP sur off en production et consultez les journaux du domaine.

5. Vérifier

Bash

curl -I https://votre-domaine.fr/une-page-inexistante

Attendu : 404 et votre page personnalisée. Testez ensuite une 403 sur un fichier protégé, puis provoquez une 500 dans un dossier de test avec un script volontairement cassé, et supprimez ce script immédiatement.

Contrôlez aussi :

aucun détail technique dans le HTML ;
les liens de la page fonctionnent ;
le code HTTP est conservé (pas de 200) ;
la page reste accessible lorsque l'application principale est indisponible.

Une bonne page d'erreur ne répare pas la panne, mais elle évite au visiteur de partir sans comprendre où cliquer.