PHP 函數中 static 變量的特性與應用場景

前言

在閱讀開源項目（如 PHPWind）源碼時，常見到函數內部使用 static 關鍵字聲明變量。這與全局變量有異曲同工之妙，但作用域僅限於函數內部，且能在多次調用間保持值的持久化。本文通過實例深入解析其行為。

代碼示例

function sendHeader($num, $rtarr = null) {
    static $sapi = null;
    if ($sapi === null) {
        $sapi = php_sapi_name();
    }
    return $sapi++;
}

echo sendHeader(1)."<br>";
echo sendHeader(2)."<br>";
echo sendHeader(3)."<br>";

輸出結果

apache2handler
apache2handles
apache2handlet

核心機制解析

1. 初始化僅執行一次

static $sapi = null; 在函數首次調用時初始化，後續調用將跳過初始化，直接使用上次保留的值。這異於普通局部變量（每次調用重新創建）與全局變量（全局可見）。

2. 值的持久化與累加

例中 $sapi++ 導致返回值每次遞增：首次返回 php_sapi_name() 結果（如 "apache2handler"），第二次在字符串末尾追加 "s"，第三次追加 "t"。這演示了 static 變量跨調用保持狀態的能力。

3. 作用域對比

典型應用場景

• 緩存昂貴操作結果：如資料庫連接、配置解析、API 客戶端實例化，避免重複開銷。
• 遞歸/迭代計數器：在遞歸函數中統計調用深度或次數，無需通過參數傳遞。
• 單例模式輔助：在工廠函數中靜態保存實例引用。

注意事項

• static 變量只能初始化為字面量或常量表達式，不能使用函數返回值直接初始化（需在函數體內判斷賦值）。
• 並發環境（如 Swoole、PHP-FPM 多進程）下，static 變量在進程間隔離，不共享狀態。
• 過度使用會降低代碼可測試性，單元測試時難以重置狀態。

總結

static 在函數內部提供了一種「有狀態的函數」能力，介於純函數與對象實例之間。善用它能簡化代碼，但需權衡可維護性與測試性。

摘自：zaric