讓ThinkPHP6異常處理更優雅：集成Whoops實現美觀調試頁面

gitbox 2025-06-26

引言

在使用ThinkPHP6 進行開發時，我們經常會遇到各種運行時異常。默認情況下，框架提供的異常頁面較為簡陋，調試體驗不夠理想。為了改善這一點，可以藉助Whoops 這個優秀的錯誤處理庫，為開發過程提供更直觀的異常展示界面。

什麼是Whoops？

Whoops 是一個專為PHP 應用設計的開源異常處理庫，它不僅能詳細展示錯誤信息，還以更美觀的方式呈現堆棧跟踪、錯誤文件位置等內容。通過集成Whoops，開發人員可以更快速地定位和修復問題。

安裝Whoops 庫

我們可以通過Composer 工具輕鬆引入Whoops，執行以下命令進行安裝：

 composer require filp/whoops

在ThinkPHP6 中配置Whoops

創建中間件

首先，在項目的app目錄下新建一個中間件文件WhoopsFilter.php ，代碼如下：

 
namespace app\middleware;

use think\facade\Config;
use think\exception\Handle;

class WhoopsFilter extends Handle
{
    public function render($request, \Throwable $e)
    {
        if (Config::get('app.app_debug')) {
            $whoops = new \Whoops\Run;
            $whoops->pushHandler(new \Whoops\Handler\PrettyPageHandler);
            $whoops->register();
        }
        return parent::render($request, $e);
    }
}

註冊中間件

接著，打開app/middleware.php文件，將上述中間件添加到返回數組中：

 
return [
    // ...
    \app\middleware\WhoopsFilter::class,
    // ...
];

啟用調試模式

為了讓Whoops 正常工作，需確保項目處於調試模式。在config/app.php配置文件中，找到並修改如下配置項：

 
'app_debug' => true,

效果演示

一旦完成上述配置，我們就可以體驗Whoops 的調試頁面了。下面是一個簡單的控制器方法，用於模擬錯誤輸出：

 
public function index()
{
    $undefinedVariable = 'Hello, Whoops!';
    echo $undefinedVariable;
}

訪問該方法後，你將看到一個圖形化、交互性強的錯誤頁面，包含詳細的堆棧信息、變量上下文和出錯代碼位置，極大提升了調試效率。

總結

通過將Whoops 集成進ThinkPHP6 項目中，我們可以有效替代原生的異常展示方式，使調試過程更加高效與友好。特別是在開發階段，它能夠幫助開發者更快地發現問題所在，是一個值得推薦的調試工具。