Kit de Développement Logiciel Open Source

Les erreurs HTTP 403 et HTTP 404 sont automatiquement interceptées par ZnetDK qui déclenche alors en réponse, l'affichage de la vue /engine/core/view/httperror.php.

Pré-requis à l'affichage de la vue httperror.php

L'affichage de la vue /engine/core/view/httperror.php est déclenché par le serveur Http Apache grâce à la directive ErrorDocument invoquée dans le fichier de configuration .htaccess situé dans le répertoire racine de l'application.

En standard, le fichier .htaccess est configuré pour une installation de ZnetDK dans le sous-répertoire www/znetdk, où www est le répertoire de publication web du serveur Apache. En conséquence, la page principale de l'application index.php indiquée pour la directive ErrorDocument, est préfixée du chemin relatif /znetdk/, tel que cela est illustré ci-dessous :

ErrorDocument 403 /znetdk/index.php?control=httperror&action=403
ErrorDocument 404 /znetdk/index.php?control=httperror&action=404

Si vous choisissez en revanche d'installer ZnetDK directement à la racine du répertoire www (le fichier index.php est alors directement situé dans le répertoire www), alors modifiez le chemin de la directive ErrorDocument comme montré ci-dessous.

ErrorDocument 403 /index.php?control=httperror&action=403
ErrorDocument 404 /index.php?control=httperror&action=404

Enfin, selon le même principe, si le répertoire d'installation de ZnetDK retenu est par exemple www/myapp, le chemin à indiquer en conséquence est le suivant :

ErrorDocument 403 /myapp/index.php?control=httperror&action=403
ErrorDocument 404 /myapp/index.php?control=httperror&action=404

Personnalisation de la vue httperror.php

La vue standard /engine/core/view/httperror.php se limite à l'affichage minimaliste de l'erreur HTTP et d'un lien de retour vers la page d'accueil, comme cela est illustré sur la photo ci-contre.

Pour personnaliser le texte de l'erreur affiché ou encore pour ajouter une image en guise d'illustration, cette vue peut être surchagée en créant une vue de même nom httperror.php dans le répertoire /applications/default/app/view.

La méthode \core\General::getHttpErrorCode() peut être appelée si besoin par la vue pour disposer du code HTTP de l'erreur et conditionner éventuellement l'affichage de son contenu en fonction du code de l'erreur.

Enfin, si votre application supporte plusieurs langues d'affichage (voir rubrique Gestion multilingue), alors la vue httperror.php peut être déclinée pour chaque langue supportée, en créant par exemple les vues httperror_fr.php, httperror_en.php ou encore httperror_es.php.