Repolode
filp

filp/whoops

PHP 错误处理框架,用可读的调试错误页和 JSON/XML 响应替代默认的错误输出。

Star
13,226
Fork
599
未关闭 Issue
7
最近提交
7天前

这是什么?

Whoops 是一个可堆叠的 PHP 错误处理框架。它的主要输出是面向 Web 项目的详细错误页面,展示异常信息、调用栈以及出错位置附近的源代码,便于开发阶段快速定位问题。

除了 HTML 页面,Whoops 还内置了用于 CLI 应用的纯文本输出处理器,以及返回 JSON 和 XML 的处理器,适合 AJAX 请求和接口场景。处理器可以叠加使用,闭包或可调用对象也能直接注册为处理器。错误中引用的文件还可以直接在编辑器或 IDE 中打开。

该库没有必需的依赖,可通过 Composer 安装。Laravel、Mezzio 等框架已内置它,Slim、CakePHP、Zend 等框架也有社区集成方案。

核心功能

  • 01基于堆栈的错误处理机制,可串联多个处理器
  • 02带调用栈和源代码上下文的美观 HTML 错误页
  • 03提供 JSON、XML 和纯文本响应处理器
  • 04可在编辑器或 IDE 中直接打开错误涉及的文件
  • 05无必需依赖,可通过 Composer 安装

适用场景

  • 在开发阶段调试 PHP Web 应用
  • 为 AJAX 或 API 接口返回结构化的错误响应
  • 在 PHP 命令行工具中输出可读的错误信息

快速上手

  1. 1

    使用 Composer 将 Whoops 安装到你的 PHP 项目中

    composer require filp/whoops
  2. 2

    在代码中注册美化错误页面处理器

标签

常见问题

whoops 是什么?
PHP 错误处理框架,用可读的调试错误页和 JSON/XML 响应替代默认的错误输出。 Whoops 是一个可堆叠的 PHP 错误处理框架。它的主要输出是面向 Web 项目的详细错误页面,展示异常信息、调用栈以及出错位置附近的源代码,便于开发阶段快速定位问题。
whoops 可以免费使用吗?用的什么许可证?
whoops 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
whoops 还在维护吗?
活跃维护中。whoops 最近一次提交是在 2026年10月18日。
whoops 适合用来做什么?
在开发阶段调试 PHP Web 应用 为 AJAX 或 API 接口返回结构化的错误响应 在 PHP 命令行工具中输出可读的错误信息
whoops 怎么安装和运行?
使用 Composer 将 Whoops 安装到你的 PHP 项目中: composer require filp/whoops 在代码中注册美化错误页面处理器
在哪里获取 whoops?
源代码和安装说明在 GitHub 上:https://github.com/filp/whoops

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目