Whoops 需手动注册错误处理器才能生效，仅 composer require 不会自动启用；必须在入口文件顶部实例化 Whoops\Run 并调用 register()，且需确保未提前输出、环境允许、SAPI 兼容。
Whoops 不能靠 Composer “安装完就自动生效”——它必须手动注册为错误处理器，否则页面还是白屏或原始 PHP 错误。
composer require whoops/whoops 装的是什么
这条命令只是把 whoops/whoops 包下载到 vendor/ 并写入 composer.json，不改任何运行逻辑。Whoops 本身是个库，不是插件，没有“启用开关”。你得自己调用它的类、注册错误处理器，它才开始工作。
常见错误现象：composer require whoops/whoops 后刷新页面，错误还是白屏或原始 Parse error: syntax error... —— 因为根本没启动 Whoops。
- 它默认不接管任何错误，连
set_error_handler都不自动调用 - 不兼容 CLI 脚本的错误显示（除非你额外配置
Runners\Shell） - 若项目已用
error_reporting(0)或@抑制错误，Whoops 也捕获不到
PHP 中怎么手动启用 Whoops 错误页面
核心就两步：实例化 Whoops\Run，然后调用 register()。必须放在所有业务代码执行前（比如入口文件最顶部），否则部分错误可能已被 PHP 处理掉。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型用法（如 public/index.php 开头）：
if (getenv('APP_DEBUG') === 'true') {
$whoops = new \Whoops\Run();
$whoops->pushHandler(new \Whoops\Handler\PrettyPageHandler());
$whoops->register();
}
- 只在调试环境启用（如通过
APP_DEBUG控制），生产环境别开 -
PrettyPageHandler是 Web 页面版，CLI 下要用PlainTextHandler - 若用了框架（如 Laravel），别直接写这段——Laravel 自带 Whoops 集成，只需确保
APP_DEBUG=true且未被中间件提前终止响应
为什么有时候 Whoops 页面不显示 CSS/JS 资源
Whoops 的美化页面依赖内联 CSS 和 JS，但它不走 Web 服务器静态路由，而是由 PHP 输出完整 HTML。问题常出在输出被截断或 headers 已发送。
常见原因：
- 入口文件顶部有空格、BOM 或
echo/print提前输出，导致 headers sent 错误，Whoops 降级为纯文本 - 某些 SAPI（如 IIS FastCGI）对长错误页面支持差，会截断响应体
- Apache/Nginx 配置了
fastcgi_buffering off或类似限制，影响大 HTML 响应 - 使用了输出缓冲但未正确清理（如
ob_start()后没ob_end_flush()）
Whoops 看似简单，但生效链路很脆弱：Composer 安装只是起点，注册时机、环境判断、输出控制、SAPI 兼容性，缺一不可。最容易被忽略的是——它根本不会告诉你“我失败了”，只会静默退回原始错误。
