README

该包提供美观、可定制和本地化的错误页面，并为Laravel提供两个预定义视图。

默认情况下，当禁用调试模式且请求不期望JSON响应时，将显示优雅的错误页面。

安装

本版本（1.*）与Laravel 4.2兼容

composer require mscharl/pretty-error-page:1.*

将服务提供者'Mscharl\PrettyErrorPage\PrettyErrorPageServiceProvider'添加到您的app.php提供者数组中。

发布公共资产

php artisan asset:publish

定制

您可以通过以下步骤轻松定制本包的输出

配置

php artisan config:publish mscharl/pretty-error-page

配置值

• always_pretty bool|null
  • null（默认）仅在关闭调试模式时使用优雅的错误页面
  • true始终显示优雅的错误页面（除非期望JSON响应）
  • false从不显示优雅的错误页面

翻译

不幸的是，默认情况下不支持发布如config-或view-文件的语言文件。但您仍然可以自定义翻译，因为它们是定制通用或特定错误输出的最简单方法。您不需要编辑视图中的任何内容。翻译将自动根据抛出的HTTP状态码加载。

翻译将按以下顺序由包查找

pretty-error-page-customized::404.title > pretty-error-page-customized::general.title > pretty-error-page::404.title > pretty-error-page::general.title

定制特定错误代码的翻译

在app/lang/packages/mscharl/pretty-error-page/[langcode]中创建一个[errorcode].php文件。

定制回退翻译

在app/lang/packages/mscharl/pretty-error-page/[langcode]中创建一个generic.php文件。

必需的翻译键

<?php

return [
    'title' => 'Whoops!',
    'header_title' => 'Whoops! Something went wrong.',
    'description' => 'Something went wrong.',

    'submit_bug' => 'If this problem presits, pleace contact our <a href=":link">Support-Team</a>',
];

视图

php artisan asset:publish mscharl/pretty-error-page

您可以选择覆盖预定义模板，或者仅为特定错误代码添加自定义错误页面。

布局

• mail.blade.php：此文件用于渲染可以由收到错误的用户发送的电子邮件正文，以通知您发生的情况。
• default.blade.php：此文件用于定义错误页面的通用布局。每个错误模板都应该扩展此布局以简化。

邮件

• 共享变量

  • $message：错误信息
  • $exception：完整的PHP异常

• partials/log.blade.php：此文件定义可以发送给您的日志。日志将自动包含在每封邮件中，通过邮件布局。

• [langcode].blade.php：具有此语言代码的语言的电子邮件正文

页面

错误页面。有一个简单的命名系统。如果显示错误页面，将使用特定的错误代码作为主文件名，例如 503。如果找不到，将使用 5xx。如果仍然找不到，将使用 any 作为后备。

• 404.blade.php：预定义的 404 错误页面
• 503.blade.php：预定义的 503 错误页面
• any.blade.php：未找到特定页面时的后备错误页面

它看起来像什么？

404

通用