PHP 類方法線上性能監控：零侵入式執行時間記錄方案

PHP 類方法線上性能監控：零侵入式執行時間記錄方案

某專案模組線上效能極差，排查無果。老板要求在不影響現有效能的前提下，記錄該模組所有類方法的執行時間以定位瓶頸。這引出兩大核心挑戰：

1. 如何無侵入式監聽所有類方法的執行耗時？
2. 如何在本身效能已差的系統中實施監控而不雪上加霜？

方案一：利用 PHP 內置擴展 xhprof / xhgui

專業級效能分析工具，採樣式採集，對效能影響極小（通常 < 5%）。部署步驟：

• 安裝 xhprof 擴展（PECL）
• 配置 xhgui Web 介面存儲 MongoDB/MySQL
• 在入口檔案啟用：xhprof_enable(XHPROF_FLAGS_CPU + XHPROF_FLAGS_MEMORY)

方案二：自定義 AOP 風格攔截器（基於魔術方法或註解）

若無法安裝擴展，可實現輕量級攔截：

class Profiler {
    public static function wrap($class, $method, $args) {
        $start = microtime(true);
        $result = call_user_func_array([$class, $method], $args);
        $duration = microtime(true) - $start;
        // 異步寫入日誌/Redis，避免阻塞
        self::asyncLog($class, $method, $duration);
        return $result;
    }
    private static function asyncLog(...) { /* 使用 Swoole/Workerman 或簡單 file_put_contents(FILE_APPEND) */ }
}

配合 runkit 或 uopz 擴展在運行時重寫類方法，實現零代碼修改接入。

方案三：開源 APM 產品（SkyWalking, Pinpoint, Elastic APM）

支援 PHP 探針，提供分布式追蹤、拓撲圖、慢 SQL 分析，適合微服務架構。

最佳實踐建議

• 優先採用採樣式專業工具（xhprof/APM），避免全量記錄導致磁體/網路壓力。
• 監控數據異步落地，絕不在請求鏈路中同步寫入。
• 設置採樣率（如 10%），平衡觀測度與開銷。
• 結合慢查詢日誌、資料庫 EXPLAIN 綜合分析。

「不影響現有效能」的關鍵在於：採樣而非全量、異步而非同步、專業工具而非手工埋點。