使用pack() 與fwrite() 寫入二進制日誌文件

M66 2025-05-28

在PHP中，將數據以二進制形式寫入日誌文件，可以有效減少存儲空間並提高讀取性能。 pack()函數配合fwrite()是實現這一目的的重要工具。本文將通過一個實例，介紹如何使用這兩個函數將結構化數據寫入二進制日誌文件，並解釋相關技術細節。

為什麼選擇二進制日誌？

與傳統的文本日誌相比，二進制日誌的優勢在於：

更緊湊：使用字節對齊的方式存儲數據，節省磁盤空間；
更高效：讀取和解析速度快，適合高並發場景；
更安全：日誌結構不易被人為修改。

當然，缺點是可讀性差，因此建議只用於內部使用或作為性能優化的一部分。

pack() 的作用

pack()用於將PHP變量打包成二進製字符串。它的基本語法是：

 string pack(string $format, mixed ...$values)

其中$format是格式字符串，定義了要如何打包每個值，比如：

L ：無符號長整型（4字節，機器字節序）
N ：無符號長整型（4字節，大端字節序）
a ：NUL填充字符串
f ：單精度浮點數（4字節）

示例：記錄用戶訪問日誌

我們以記錄用戶訪問日誌為例。每條記錄包含以下字段：

用戶ID（4字節無符號整數）
時間戳（4字節無符號整數）
頁面URL長度（2字節無符號整數）
頁面URL（變長字符串）

 <?php

function write_log($user_id, $timestamp, $url) {
    $fp = fopen("access.log", "ab"); // 以二進制追加方式打開日誌文件
    if (!$fp) {
        die("無法打開日誌文件");
    }

    $url = parse_url($url, PHP_URL_PATH); // 只記錄路徑部分，避免日誌中包含敏感參數
    $url_length = strlen($url);

    if ($url_length > 65535) {
        $url = substr($url, 0, 65535); // 最大隻能存儲2字節長度的URL
        $url_length = 65535;
    }

    // 打包固定長度數據：用戶ID + 時間戳 + URL長度
    $header = pack("L L n", $user_id, $timestamp, $url_length);

    // 寫入日誌文件
    fwrite($fp, $header);
    fwrite($fp, $url);

    fclose($fp);
}

// 示例調用
write_log(123456, time(), "https://m66.net/user/profile?id=987");
?>

上面的代碼做了以下幾件事：

使用pack("LL n", ...)將用戶ID、時間戳和URL長度編碼為二進制格式；
使用fwrite()分別寫入頭部和URL正文；
每條記錄格式清晰且緊湊，可用於後續快速讀取或分析。

如何讀取日誌

寫入之後，可以使用如下方式讀取並解碼這些二進制日誌：

 <?php

function read_logs($filename) {
    $fp = fopen($filename, "rb");

    while (!feof($fp)) {
        $header = fread($fp, 10); // 4位元組用戶ID + 4位元組時間戳 + 2位元組URL長度
        if (strlen($header) < 10) break;

        $data = unpack("Luser_id/Ltimestamp/nurl_len", $header);
        $url = fread($fp, $data['url_len']);

        echo "用戶ID: {$data['user_id']}, 時間: " . date('Y-m-d H:i:s', $data['timestamp']) . ", URL: $url\n";
    }

    fclose($fp);
}

// 示例調用
read_logs("access.log");
?>

小結

通過pack()和fwrite() ，我們可以高效地將結構化數據寫入二進制日誌文件，適合記錄大量頻繁訪問的日誌信息。雖然二進制日誌不易直接查看，但可以通過程序批量讀取和分析，提升系統的性能與可維護性。

在實際應用中，還可以將該方法擴展到記錄用戶行為軌跡、接口調用日誌、性能分析數據等多個場景，是一種值得借鑒的高效日誌處理方式。

pack
fwrite