SAE 即時日誌介面 PHP SDK 完整實作：從官方 Python 版移植至 PHP

背景：SAE 官方僅提供 Python SDK

新浪雲 SAE 新增即時日誌查詢介面，可透過 API 篩選、下載即時日誌，極大提升除錯效率。但官方僅發布 Python 版本，PHP 開發者無法直接使用。本文提供完整 PHP 版 SDK 實作。

核心難點：SAE API 簽名認證機制

SAE API 採用 HMAC-SHA256 簽名驗證，請求 Header 必須包含：

• x-sae-accesskey：Access Key
• x-sae-timestamp：Unix 時間戳
• Authorization：SAEV1_HMAC_SHA256 base64(hmac_sha256(canonical_string, secret_key))

完整 PHP SDK 程式碼

<?php
class SaeApiHandler {
    private $accessKey, $secretKey, $timestamp;

    public function __construct($key, $sec) {
        $this->accessKey = $key;
        $this->secretKey = $sec;
        $this->timestamp = time();
    }

    // 魔術方法：支援陣列批次請求與單一請求
    public function __call($name, $args) {
        $ret = [];
        if (is_array($args[0])) {
            foreach ($args as $i => $arg) {
                $ret[$i] = isset($arg['fop'])
                    ? $this->$name($arg['service'], $arg['date'], $arg['ident'], $arg['fop'])
                    : $this->$name($arg['service'], $arg['date'], $arg['ident']);
            }
        } else {
            $ret = isset($args[3])
                ? $this->$name($args[0], $args[1], $args[2], $args[3])
                : $this->get($args[0], $args[1], $args[2]);
        }
        return $ret;
    }

    // 獲取日誌核心邏輯
    private function getLog($service, $date, $ident, $fop = null) {
        $uri = "/log/$service/$date/" . $_SERVER['HTTP_APPVERSION'] . "-$ident.log";
        if ($fop) $uri .= "?$fop";

        $ret = explode(PHP_EOL, $this->get($uri));
        array_splice($ret, 0, 7);  // 移除前 7 行 Header
        array_pop($ret);           // 移除最後空行
        return $ret;
    }

    // 底層 HTTP GET 請求
    private function get($uri) {
        $ch = curl_init("https://g.sae.sina.com.cn$uri");
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER     => $this->saeHeader($uri),
            CURLOPT_HEADER         => true,
        ]);
        $ret = curl_exec($ch);
        curl_close($ch);
        return $ret;
    }

    // 構建 SAE 請求 Header
    private function saeHeader($uri) {
        return [
            'Host: g.sae.sina.com.cn',
            'Accept: text/plain',
            'x-sae-accesskey: ' . $this->accessKey,
            'x-sae-timestamp: ' . $this->timestamp,
            'Authorization: ' . $this->getAuthorization($uri),
        ];
    }

    // 計算簽名 Authorization
    private function getAuthorization($uri) {
        $header = [
            'x-sae-timestamp' => $this->timestamp,
            'x-sae-accesskey' => strtolower($this->accessKey),
        ];
        ksort($header);

        $canonical = ['GET', $uri];
        foreach ($header as $k => $v) $canonical[] = "$k:$v";
        $stringToSign = implode(PHP_EOL, $canonical);

        $signature = base64_encode(hash_hmac('sha256', $stringToSign, $this->secretKey, true));
        return "SAEV1_HMAC_SHA256 $signature";
    }
}
?>

使用範例

<?php
define('SAE_ACCESSKEY', '你的AccessKey');
define('SAE_SECRETKEY', '你的SecretKey');

$api = new SaeApiHandler(SAE_ACCESSKEY, SAE_SECRETKEY);

// 單一請求
$log = $api->getLog('http', '2015-07-03', 'access', 'head/1/5');

// 批次請求（陣列參數）
$req1 = ['service'=>'http', 'date'=>'2015-07-03', 'ident'=>'access', 'fop'=>'head/1/5'];
$req2 = ['service'=>'http', 'date'=>'2015-07-03', 'ident'=>'error', 'fop'=>'tail/10'];
$logs = $api->getLog($req1, $req2);

var_dump($logs);
?>

參數說明

進階應用建議

• 日誌聚合分析：定時拉取存入 ELK / ClickHouse 做全文檢索與視覺化
• 異常告警：解析 error 日誌，關鍵字匹配觸發郵件/簡訊告警
• 效能監控：分析 access 日誌統計 QPS、響應時間、慢請求
• 安全審計：掃描可疑 IP、SQL 注入嘗試、異常 User-Agent

注意事項

• 需在 SA 開啟「即時日誌」服務並獲取 AccessKey/SecretKey
• $_SERVER['HTTP_APPVERSION'] 為 SAE 環境專有變數，本地測試需模擬
• 日誌保留時間有限，重要日誌請及時備份

此 SDK 填補了 SAE PHP 生態的空白，讓 PHP 開發者也能享受即時日誌 API 的便利。

1. 上一篇文章： PHP 物件鏈式操作核心原理深度解析：__call 與 __toString 魔術方法實戰
2. 下一篇文章： PHP 依賴注入（DI）與控制反轉（IoC）深度解析：從手動注入到容器化管理

PHP 綜合知識

PHP 多用戶頭像上傳實作：從登入驗證到檔案管理完整流程

專案情境與資料夾策略 為每位登入用戶建立專屬資料夾（以用戶名

PHP 網頁靜態化完全指南：真靜態、偽靜態與四大生成策略

為什麼要靜態化？ 極速回應：Nginx/Apache 直接

Yii Framework 教程 (29)：Zii CMenu 元件實戰 - 多級導航選單與麵包屑

CMenu 核心功能 以 HTML 無序清單 (<u

PHP 擴展開發入門：ext_skel 快速生成骨架與 Hello World 實戰

C/C++ 擴展 PHP 的利弊權衡 優點缺點 極致