Whoops必须手动注册为错误处理器才能生效，仅用composer安装无效；需在入口文件顶部启用error_reporting、实例化Run并pushHandler后调用register()，Laravel中还需禁用Ignition并手动注册。

Whoops 插件不能“安装”，它必须通过 Composer 加载并由框架或应用主动启用；不配置错误处理器，装了也看不到美化页面。

composer require whoops/whoops 装完就完事了？

装包只是第一步，whoops/whoops 本身不自动接管 PHP 错误——它是个库，不是插件。你得手动注册 Run 实例为错误处理器。

• 常见错误现象：composer require whoops/whoops 后报错照旧是白屏或原始 Parse error，页面毫无变化
• 典型使用场景：CLI 脚本、裸 PHP 入口、Laravel 以外的轻量框架（如 Slim、Lumen）需自行集成
• 关键步骤：
  • 确保 error_reporting(E_ALL) 和 ini_set('display_errors', '1') 已开启（否则 Whoops 根本收不到错误）
  • 在入口文件最顶部（早于任何输出）实例化并注册：

    $whoops = new \Whoops\Run();
    $whoops->pushHandler(new \Whoops\Handler\PrettyPageHandler());
    $whoops->register();

为什么 Laravel 里装了 whoops 却没生效？

Laravel 5.5+ 默认禁用 Whoops——开发环境用的是自己的 Ignition，而 whoops/whoops 与之冲突，不会被自动启用。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 常见错误现象：运行 php artisan serve 后 500 错误仍显示 Ignition 页面，不是 Whoops 风格
• 解决路径：
  • 删掉 facade/ignition（或 spatie/laravel-ignition），再清缓存：php artisan config:clear
  • 在 app/Providers/AppServiceProvider.php 的 boot() 中手动注册：

    if (app()->environment('local')) {
        $whoops = new \Whoops\Run();
        $whoops->pushHandler(new \Whoops\Handler\PrettyPageHandler());
        $whoops->register();
    }

  • 注意：Laravel 10+ 默认不加载 whoops/whoops，即使 composer require 成功，也得自己写注册逻辑

PHP 版本和 SAPI 类型影响 Whoops 显示效果

Whoops 的 PrettyPageHandler 在 CLI 下不渲染 HTML，在 Apache/FPM 下才显示彩色页面；PHP 8.1+ 的某些错误类型（如 TypeError）默认不被捕获，需显式设置。

• 参数差异：new \Whoops\Handler\PrettyPageHandler() 支持传入配置数组，比如关闭代码高亮：

  new \Whoops\Handler\PrettyPageHandler(['editor' => 'vscode'])

• 兼容性影响：
  • PHP 7.4–8.2 完全支持；PHP 8.3 尚未正式验证，部分用户反馈 UnhandledMatchError 不触发 Whoops
  • CLI 模式下只会输出纯文本堆栈（非 HTML），别指望看到蓝色面板
  • 如果用了 OPcache 且启用了 opcache.enable_cli=1，修改代码后可能仍显示旧错误，需 opcache_reset()

真正卡住人的地方往往不是装不上，而是错误没被送到 Whoops 手里——检查 error_reporting 是否被框架覆盖、是否提前 echo 导致 header 发送失败、有没有其他 set_error_handler 抢先注册。谁先调用 register()，谁就管事。