4.18. Páginas de Error

Cuando una página no se puede encontrar o algún otro error sucede dentro de nuestra aplicación web se muestra una página de error estándar. La apariencia de esta página es controlada por las plantillas de error. Existen dos plantillas de error: error/404 que se usada para el error "404 Page Not Found" (ver figura 4.10) y error/index que se muestra cuando un error genérico ocurre (tal como una excepción no manejada lanzada desde cualquier lugar dentro de la aplicación).

Figura 4.10. 404 Error Page

El archivo de configuración module.config.php contiene varios parámetros bajo la llave view_manager que podemos usar para configurar la apariencia de nuestras plantillas de error:

<?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',
        ],
        //...
    ],
];

• El parámetro display_not_found_reason controla si se muestra la información detallada sobre el error "Page not Found".
• El parámetro display_exceptions define si se muestra la información sobre una excepción no manejada y su traza.
• El parámetro not_found_template define el nombre de la plantilla para el error 404.
• El parámetro exception_template específica el nombre de la plantilla para el error de excepción no manejada.

Típicamente colocamos los parámetros display_not_found_reason y display_exceptions en false para entornos de producción porque no queremos que los visitantes del sitio vean los detalles de los errores del sitio. Sin embargo, aún seremos capaces de ver la información detallada en el archivo error.log de Apache.