PHP 利用 popen 實現 RRDtool 圖表動態輸出

無需暫存檔：直接輸出 RRDtool 產生的圖表

RRDtool 是強大的時間序列資料繪圖工具，但預設需輸出至檔案。透過 PHP 的 popen() 建立管道，可直接讀取 RRDtool 的標準輸出並以圖片串流回應客戶端，實現真正的動態圖表服務。

核心實作原理

1. 構建 RRDtool graph 命令，輸出目標設為 -（標準輸出）
2. 使用 popen(command, 'r') 開啟讀取管道
3. 循環讀取管道資料至變數
4. 設定正確的 HTTP 標頭（Content-Type、Content-Length）
5. 直接輸出二進位圖片資料

完整程式碼範例

<?php
error_reporting(E_ALL);

// RRDtool 繪圖命令：注意 graph 後的 "-" 代表輸出到 stdout
$command = '/opt/rrdtool/bin/rrdtool graph - ' .
    '--start=-86400 --end=-300 ' .
    '--title="流量監控" --height=400 --width=800 ' .
    'DEF:traffic_in="/var/lib/rrd/traffic_in.rrd":traffic_in:AVERAGE ' .
    'AREA:traffic_in#FF0000:"入站流量" ' .
    '2>&1';  // 將 stderr 導向 stdout 捕捉錯誤訊息

// 關閉 session 避免鎖定影響長時間執行
session_write_close();

// 執行命令並讀取輸出
$handle = popen($command, 'r');
$imageData = '';
while (!feof($handle)) {
    $imageData .= fgets($handle, 4096);
}
$exitCode = pclose($handle);

// 錯誤處理
if ($exitCode !== 0 || empty($imageData)) {
    header('Content-Type: text/plain; charset=utf-8');
    die("RRDtool 執行失敗 (exit code: $exitCode)\n輸出:\n$imageData");
}

// 輸出 PNG 圖片
header('Content-Type: image/png');
header('Content-Length: ' . strlen($imageData));
header('Last-Modified: ' . gmdate('D, d M Y H:i:s', time()) . ' GMT');
header('Cache-Control: public, max-age=300');  // 快取 5 分鐘
echo $imageData;
?>

關鍵技術細節

常見問題與解決

• 權限不足：確保 PHP 執行身分（如 www-data）有 RRDtool 執行權限與 RRD 檔案讀取權限
• 路徑問題：使用 RRDtool 完整路徑，或將其加入系統 PATH
• 中文亂碼：在 RRDtool 命令中指定 --font DEFAULT:12:/path/to/simhei.ttf 設定中文字型
• 記憶體耗盡：大尺寸圖表請分塊輸出或增加 PHP memory_limit

應用場景擴展

此模式同樣適用於其他命令列繪圖工具（如 gnuplot、Graphviz），或任何需動態產生二進位內容（PDF、Excel、圖片）的場景。