FirePHP 是一款經典的 Firefox + Firebug 組合調試工具,讓 PHP 通過 HTTP 響應標頭將調試信息發送到瀏覽器控制台,實現「像調試 JS 一樣調試 PHP」。雖然 Firebug 已停止維護(現代 Firefox 內建開發者工具),但 FirePHP 的原理與思想對理解現代調試協議(如 Chrome Logger、PHP Debug Bar)極具參考價值。本文記錄完整安裝配置與使用流程。

下載獨立版 FirePHPCore(或用 Composer:composer require firephp/firephp-core),放入專案可訪問目錄(如 lib/FirePHPCore/)。
<?php
// 1. 載入核心類
require_once 'lib/FirePHPCore/fb.php';
// 2. 必須啟用輸出緩衝(FirePHP 通過 HTTP Header 發送數據,需在輸出前設置 Header)
ob_start();
// 3. 可選:開啟 FirePHP 嚴格模式(開發環境建議開啟)
// FirePHP::getInstance()->setEnabled(true);
?>
fb() 函數<?php
$var = ['a' => 'pizza', 'b' => 'cookies', 'c' => 'celery'];
// 1. 簡單輸出變量
fb($var);
// 2. 帶標籤輸出
fb($var, '用戶偏好數組');
// 3. 指定類型:警告
fb($var, FirePHP::WARN);
// 4. 指定類型:信息
fb($var, FirePHP::INFO);
// 5. 指定類型:錯誤(帶標籤)
fb($var, '帶錯誤類型的數組', FirePHP::ERROR);
?>

FirePHP::TRACE自動記錄調用堆疊(文件、行號、類、方法),無需手動傳參:
<?php
function hello() {
fb('Hello World!', FirePHP::TRACE);
}
function greet() {
hello();
}
greet(); // 呼叫鏈:greet() -> hello()
?>

<?php
$firephp = FirePHP::getInstance(true);
// 群組相關日誌(控制台可摺疊)
$firephp->group('用戶登錄流程');
fb($_POST, 'POST 數據');
fb($user, '用戶對象');
$firephp->groupEnd();
// 表格化顯示陣列
$table = [
['ID', 'Name', 'Email'],
[1, 'Alice', 'alice@example.com'],
[2, 'Bob', 'bob@example.com']
];
$firephp->table('用戶列表', $table);
// 計時器
$firephp->time('DB 查詢');
// ... 執行查詢 ...
$firephp->timeEnd('DB 查詢'); // 控制台顯示耗時
?>
FirePHP 通過 HTTP Header 傳輸調試數據,若生產環境未禁用,敏感信息(SQL、變量值、堆疊)將暴露給任何打開開發者工具的用戶。
<?php
// 入口文件統一控制
define('APP_DEBUG', true); // 或從環境變量讀取
if (APP_DEBUG) {
require_once 'lib/FirePHPCore/fb.php';
ob_start();
} else {
// 定義空函數防止報錯
function fb() {}
define('FirePHP', new class { const WARN=1; const INFO=2; const ERROR=3; const TRACE=4; });
}
?>
| 工具 | 特點 | 適用場景 |
|---|---|---|
Chrome Logger (PHP: ccampbell/chromephp) | Chrome 原生 DevTools 整合,API 類似 FirePHP | 現代 Chrome 開發首選 |
PHP Debug Bar (maximebf/debugbar) | 獨立工具欄,支援 Laravel/Symfony/原生,功能極豐富 | 全棧專案、性能分析 |
| Xdebug + IDE (PhpStorm/VS Code) | 斷點、單步執行、變量檢查、性能分析 | 深度調試、複雜邏輯、生產環境排查 |
| Telescope (Laravel) | 請求、查詢、隊列、彌補、郵件、通知可視化 | Laravel 專案監控 |
FirePHP 開創了「HTTP Header 傳輸調試數據」的先河。雖然工具老舊,但其核心思想——非侵入式、結構化、瀏覽器控制台集中展示——被現代調試工具繼承發揚。理解 FirePHP 有助於你快速上手 Chrome Logger、Debug Bar 等新工具,並在無法安裝 Xdebug 的受限環境中(如某些共享主機)仍能優雅調試。