4.18. Pages d'erreur

Lorsqu'une page est introuvable ou qu'une autre erreur se produit dans votre application, une page d'erreur standard s'affiche. L'apparence de la page d'erreur est contrôlée par les templates d'erreur. Il existe deux modèles d'erreur: error/404 qui est utilisé pour l'erreur "404 Page Not Found" (illustrée à la figure 4.10), et error/index qui s'affiche lorsqu'une erreur générique se produit (par exemple, lorsqu'une exception non gérée est levée quelque part L'application).

Figure 4.10. 404 Page d'erreur

Le fichier module.config.php contient plusieurs paramètres sous la clé view_manager, que vous pouvez utiliser pour configurer l'apparence de vos templates d'erreur:

<?php
return [
    //...
    
    'view_manager' => [    
        'display_not_found_reason' => true,
        'display_exceptions'       => true,
        //...
        'not_found_template'       => 'error/404',
        'exception_template'       => 'error/index',    
        'template_map' => [
            //...
            'error/404' => __DIR__ . '/../view/error/404.phtml',
            'error/index'=> __DIR__ . '/../view/error/index.phtml',
        ],
        //...
    ],
];

• Le paramètre display_not_found_reason détermine s'il faut afficher les informations détaillées sur l'erreur "Page introuvable".
• Le paramètre display_exceptions définit s'il faut afficher les informations sur une exception non gérée ainsi que sa stack trace.
• Le not_found_template définit le nom de la vue pour l'erreur 404.
• Le paramètre exception_template spécifie le nom de la vue pour les exception non gérées.

Vous mettez généralement les paramètres display_not_found_reason et display_exceptions sur false lorsque vous êtes en production car vous ne souhaitez pas que les visiteurs du site voient les détails des erreurs sur votre site. Cependant, vous serez toujours en mesure de récupérer les informations détaillées de ces erreurs dans le fichier error.log d'Apache.