PHP static 靜態變量深度解析：局部靜態 vs 全局靜態的生命週期與陷阱

static 關鍵字在 PHP 中有兩種截然不同的語境：函數內局部靜態變量、類中靜態屬性/方法。本文聚焦函數級局部靜態變量，對比全局變量，揭示其獨特生命週期與使用陷阱。

局部靜態變量：函數的「記憶體」

function counter() {
    static $count = 0; // 僅初始化一次
    $count++;
    echo $count . "\n";
}

counter(); // 1
counter(); // 2
counter(); // 3
// $count 在函數調用間保持值，但作用域僅限函數內

四大核心特性

經典應用：遞歸計數、單例緩存、資源連接復用

// 遞歸深度計數
function traverse($node, $depth = 0) {
    static $maxDepth = 0;
    if ($depth > $maxDepth) $maxDepth = $depth;
    // ... 遍歷子節點 ...
    return $maxDepth;
}

// 惰性單例資源（如數據庫連接）
function getDb() {
    static $pdo = null;
    if ($pdo === null) {
        $pdo = new PDO($dsn, $user, $pass);
    }
    return $pdo;
}

全局靜態變量：其實就是全局變量

$globalCounter = 0; // 全局變量本質上就是靜態存儲

function globalCounter() {
    global $globalCounter;
    $globalCounter++;
    echo $globalCounter . "\n";
}

globalCounter(); // 1
globalCounter(); // 2
globalCounter(); // 3
echo $globalCounter; // 3 - 外部可直接訪問修改

對比總結

類靜態成員補充（易混淆點）

class Foo {
    public static $count = 0; // 類屬性，屬於類而非實例
    public function inc() { self::$count++; }
}

$obj1 = new Foo(); $obj1->inc();
$obj2 = new Foo(); $obj2->inc();
echo Foo::$count; // 2 - 所有實例共享

// 晚靜態綁定 (PHP 5.3+)
class Bar extends Foo {
    public static $count = 0;
}
Bar::$count = 5;
echo Foo::$count; // 2 (未改變)
echo Bar::$count; // 5 (獨立)

常見陷阱與最佳實踐

1. 遞歸函數共享同一靜態變量： 多線程/併發環境下會衝突，PHP-FPM 單進程請求隔離下安全，但 Swoole/RoadRunner 協程環境需用 SplThreadLocal 或上下文管理器
2. 靜態變量引用陷阱： static $v = &$external; 會導致不可預期行為，避免引用賦值
3. 測試困難： 靜態狀態難以重置，單元測試時用反射 ReflectionClass::getStaticPropertyValue() 或重構為可注入依賴
4. 優先考慮替代方案：
   • 類靜態屬性（更清晰、支持繼承控制）
   • 單例模式/服務容器（依賴注入友好）
   • 閉包捕獲變量（$fn = function() use (&$v) {}）

理解 static 變量的生命週期邊界，善用其封裝性避免全局污染，是編寫健壯 PHP 代碼的重要內功。