| 常數 | 級別 | 建議 |
| E_ERROR | 致命運行錯誤 | 必須修復,腳本終止 |
| E_WARNING | 運行警告 | 監控告警,不終止腳本 |
| E_NOTICE | 運行通知 | 開發環境開啟,生產可關閉 |
| E_DEPRECATED | 棄用警告 | 規劃遷移,不阻塞 |
| E_STRICT | 編碼標準建議 | 開發環境開啟 |
斷點調試利器:die()/exit()
兩者完全等價(die 是 exit 別名),用於立即終止腳本並可選輸出訊息。
經典用法:資源獲取失敗即停止
$fp = fopen($file, 'r') or die("無法開啟檔案: $file");
// 等價於
if (!($fp = fopen($file, 'r'))) {
die("無法開啟檔案: $file");
}
短路求值原理
expr1 or expr2:若 expr1 為真,expr2 不執行(短路)。fopen 成功返回 resource(真),失敗返回 false(假)觸發 die()。
調試技巧:分段驗證
<?php
// 1. 驗證輸入
$data = $_POST['data'] ?? null;
var_dump($data); die('DEBUG: 輸入驗證'); // 觀察原始輸入
// 2. 驗證業務邏輯
$result = process($data);
var_dump($result); die('DEBUG: 處理結果'); // 觀察處理後資料
// 3. 驗證資料庫
$stmt = $pdo->query("SELECT * FROM logs");
var_dump($stmt->fetchAll()); die('DEBUG: DB查詢'); // 觀察查詢結果
?>
變數檢視三大神器
1. var_dump():結構化詳細輸出
<?php
$a = [1, 2, ['a','b','c']];
$b = 3.1;
$c = true;
var_dump($a, $b, $c);
/* 輸出:
array(3) {
[0]=> int(1)
[1]=> int(2)
[2]=> array(3) { [0]=> string(1) "a" [1]=> string(1) "b" [2]=> string(1) "c" }
}
float(3.1)
bool(true)
*/
?>
- 顯示型別、長度、值、巢狀結構
- 支援多參數:
var_dump($a, $b, $c)
- 配合
<pre> 閱讀更清晰
2. print_r():人類可讀格式
<?php
$a = ['a'=>'apple', 'b'=>'banana', 'c'=>['x','y','z']];
print_r($a);
/* 輸出:
Array
(
[a] => apple
[b] => banana
[c] => Array
(
[0] => x
[1] => y
[2] => z
)
)
*/
// 捕獲輸出而不直接顯示
$output = print_r($a, true);
error_log($output); // 寫入錯誤日誌
?>
- 較簡潔,適合陣列/物件概覽
print_r($var, true) 返回字串而非輸出
- ⚠ 會將陣列指標移至末尾,後續
foreach 需 reset()
3. 自定義遞歸輸出函數(支援物件/資源/遞歸引用)
<?php
function debug_var($var, $depth = 0) {
$indent = str_repeat(' ', $depth);
static $seen = [];
if (is_object($var)) {
$id = spl_object_id($var);
if (isset($seen[$id])) return "$indent*RECURSION* " . get_class($var) . "\n";
$seen[$id] = true;
$out = "$indent" . get_class($var) . " Object\n";
foreach ($var as $k => $v) {
$out .= "$indent [$k] => " . debug_var($v, $depth+1);
}
return $out;
}
if (is_array($var)) {
$id = spl_object_id($var); // PHP 7.2+ 陣列也有 object id
if (isset($seen[$id])) return "$indent*RECURSION* Array\n";
$seen[$id] = true;
$out = "$indentArray\n";
foreach ($var as $k => $v) {
$out .= "$indent [$k] => " . debug_var($v, $depth+1);
}
return $out;
}
if (is_resource($var)) return "$indentResource (" . get_resource_type($var) . ")\n";
if (is_null($var)) return "$indentNULL\n";
if (is_bool($var)) return "$indentBool(" . ($var ? 'true' : 'false') . ")\n";
if (is_float($var)) return "$indentFloat($var)\n";
if (is_int($var)) return "$indentInt($var)\n";
return "$indentString(" . strlen($var) . ") \"$var\"\n";
}
// 使用
error_log(debug_var($complex_data));
?>
進階調試工具推薦
| 工具 | 類型 | 特點 |
| Xdebug | PHP 擴展 | 斷點、堆疊追蹤、分析器、代碼覆蓋率,IDE 整合(PhpStorm/VS Code) |
| Tideways | PHP 擴展/SaaS | 生產級 APM,低開銷,支援分布式追蹤 |
| Blackfire | SaaS/擴展 | 性能分析、測試基準、CI/CD 整合 |
| Monolog | Composer 套件 | 結構化日誌、多處理器(檔案、Slack、Elasticsearch、Syslog) |
| Laravel Telescope / Symfony Profiler | 框架工具 | 請求、查詢、隊列、快取、事件可視化 |
生產環境調試清單
- ✅ 錯誤日誌寫入獨立檔案,配置
logrotate 輪轉
- ✅ 日誌包含:時間、請求 ID、用戶 ID、URL、IP、堆疊追蹤
- ✅ 敏感資料(密碼、Token、PII)在日誌中脫敏
- ✅ 關鍵業務節點埋點日誌(資訊級),便於鏈路追蹤
- ✅ 異常監控告警(ELK/Grafana/Sentry/PagerDuty)
- ✅ 定期歸檔、審計日誌完整性
總結
生產環境調試的核心是「可觀測性」:ini_set 配置奠基,error_log 記錄真相,var_dump/print_r 瞬時切片,Xdebug/APM 深度剖析。嚴禁在生產開啟 display_errors、使用 die() 殘留代碼、記錄敏感明文。建立結構化、分級、可查詢的日誌體系,才是長久之計。
copyright ©
萬盛學電腦網 all rights reserved