aloframework/handlers

AloFramework 的错误和异常处理器

3.0 2016-11-07 21:47 UTC

README

AloFramework 的强大错误和异常处理器。如果传递实现了 AloFramework 的对象,它将自动记录错误和异常,并根据服务器的错误报告设置输出信息,根据是否在 HTTP 或 CLI 调用期间引发错误而改变其格式。

最新发布 API 文档:https://aloframework.github.io/handlers/

License Latest Stable Version Total Downloads

安装

安装可通过 Composer 进行。

composer require aloframework/handlers

使用

  • 要启用异常处理器,请调用 \AloFramework\Handlers\ExceptionHandler::register()
  • 要启用错误处理器,请调用 \AloFramework\Handlers\ErrorHandler::register()
  • 要启用关闭处理器,请调用 \AloFramework\Handlers\ShutdownHandler::register()

日志记录

本包中必须记录每个错误和异常。您可以为获得更多控制权而提供自己的记录器;如果没有,将使用 aloframework/log 以及其默认设置。

配置

配置是通过 AloFramework\Handlers\Config 命名空间中的类完成的。

常规

  • CFG_CSS_PATH - 样式 HTML 输出的 CSS 文件路径。默认为 src 目录中的 error.min.css
  • CFG_TRACE_MAX_DEPTH - 显示调试回溯项的最大数量 [50]
  • CFG_BACKGROUND - CLI 输出的背景颜色 [默认]
  • CFG_FOREGROUND_NOTICE - CLI 输出通知级别的文字颜色 [青色]
  • CFG_FOREGROUND_WARNING - CLI 输出警告级别的文字颜色 [黄色]
  • CFG_FOREGROUND_ERROR - CLI 输出错误/异常级别的文字颜色 [红色]
  • CFG_FORCE_HTML - 是否在 CLI 模式下强制 HTML 输出 [false]

错误处理器配置

  • CFG_ERROR_LEVEL - 要处理哪些错误级别。默认为 error_reporting() 的值。
  • CFG_LOG_ERROR_LOCATION - 是否在日志中包含错误位置 [true]

异常处理器配置

  • CFG_EXCEPTION_DEPTH - 在异常处理器中输出之前异常的最大数量 [10]
  • CFG_LOG_EXCEPTION_LOCATION - 是否在日志中包含异常位置 [true]