萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 非同步除錯與線上除錯最佳實踐:錯誤日誌、記憶體限制與斷點技巧

核心配置:開發/生產環境通用的錯誤處理策略

將以下程式碼置於公共引入檔案(如 config.php、common.php)頂部:

<?php
// 1. 錯誤報告層級:開發環境建議 E_ALL,生產環境可排除 NOTICE
ini_set('error_reporting', E_ALL);              // 顯示所有錯誤
// ini_set('error_reporting', E_ALL ^ E_NOTICE); // 忽略 NOTICE

// 2. 禁止錯誤直接輸出到頁面(防資訊洩露、破壞 JSON/API 格式)
ini_set('display_errors', 'off');

// 3. 啟用錯誤日誌記錄
ini_set('log_errors', 'on');

// 4. 指定錯誤日誌儲存路徑(需可寫權限)
ini_set('error_log', 'C:/phpernote/php_error.log'); // Windows 路徑範例
// Linux 範例:/var/log/php/php_error.log

// 5. 常用效能保護設定
@ini_set('memory_limit', '500M');        // 最大記憶體 500MB
@ini_set('max_execution_time', '180');   // 最大執行時間 180 秒

經典斷點除錯函數:die() / exit()

等價關係

PHP 手冊明確註明:die() 是 exit() 的別名,兩者功能完全相同,皆為「輸出訊息並終止腳本執行」。

常見用法:or die() 模式

<?php
$file = fopen($filename, 'r') or die("抱歉,無法開啟: $filename");

執行邏輯:

  1. fopen() 成功 → 回傳資源 handle(非零整數,視為 true)→ 短路,不執行 die()。
  2. fopen() 失敗 → 回傳 false → 執行 die() 輸出訊息並終止腳本。

此模式利用 PHP 布林短路求值特性,簡潔實現「失敗即停止並報錯」。

變數檢視利器:var_dump() vs print_r()

特性var_dump()print_r()
輸出內容型別 + 值 + 結構(遞迴展開陣列/物件)易讀格式的值/結構
多變數支援var_dump($a, $b, $c)單一變數,第二參數 true 可回傳字串
指標影響無會將陣列指標移至末尾(需 reset() 歸位)
捕獲輸出搭配 ob_start()/ob_get_clean()print_r($var, true) 直接回傳字串

範例

<?php
$a = array(1, 2, array('a','b','c'));
var_dump($a);
// 輸出:array(3) { [0]=> int(1) [1]=> int(2) [2]=> array(3) { [0]=> string(1) "a" ... } }

$b = 3.1; $c = true;
var_dump($b, $c); // 多變數一次輸出

print_r($a);
// 輸出:Array ( [0] => 1 [1] => 2 [2] => Array ( [0] => a [1] => b [2] => c ) )

進階:自訂遞迴變數輸出函數

原文提供 ss_array_as_string()、ss_object_as_string() 等自訂函數,可輸出帶縮排的結構化字串,適合寫入日誌檔。現代專案建議直接使用 var_export($var, true) 或 json_encode($var, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) 替代。

線上除錯黃金法則

  1. 永不在生產環境開啟 display_errors,統一走日誌。
  2. 日誌分級:error_log() 手動記錄業務關鍵節點,區別於系統錯誤。
  3. 非同步除錯:API 介面可將除錯資訊寫入 Redis/資料庫,前端透過獨立介面查看,不干擾正常回應。
  4. Xdebug 遠端除錯:配合 IDE(PhpStorm/VS Code)設置斷點、單步執行、變數觀察,是大型專案必備。

建立「開發時可見、生產時可查」的除錯體系,是專業 PHP 工程師的基本功。

copyright © 萬盛學電腦網 all rights reserved