萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 靜態變數完整指南:類靜態屬性、函數靜態變數、延遲靜態綁定

兩類「靜態」概念區分

類型關鍵字作用域生命週期典型用途
類靜態屬性static $prop類層級進程存活期間 (PHP-FPM 常駐)計數器、單例、快取、配置
函數靜態變數static $var函數內部進程存活期間遞迴計數、一次性初始化、閉包狀態

類靜態屬性

定義與存取

<?php
class Counter {
    // 宣告並初始化
    public static $count = 0;
    protected static $instances = [];

    public static function increment(): int {
        return ++self::$count; // 類內部用 self::
    }

    public static function getCount(): int {
        return self::$count;
    }
}

// 類外部存取
Counter::increment();
Counter::increment();
echo Counter::$count;        // 2
echo Counter::getCount();    // 2

// 繼承行為:父子類共享同一靜態屬性 (除非子類重新宣告)
class ChildCounter extends Counter {}
ChildCounter::increment();
echo Counter::$count;        // 3 (共享)
echo ChildCounter::$count;   // 3

延遲靜態綁定 (Late Static Binding, PHP 5.3+)

<?php
abstract class Model {
    protected static $table = 'base';

    public static function getTable(): string {
        // 關鍵:static:: 解析為「實際調用的類」,而非定義處
        return static::$table;
    }

    public static function create(): static {
        return new static(); // 回傳調用類的實例
    }
}

class User extends Model {
    protected static $table = 'users';
}

class Post extends Model {
    protected static $table = 'posts';
}

echo User::getTable();  // 'users'
echo Post::getTable();  // 'posts'

$user = User::create(); // User 實例
$post = Post::create(); // Post 實例

函數靜態變數

基本特性

  • 僅在 首次呼叫 初始化
  • 函數結束後 不銷毀,下次呼叫保留值
  • 作用域僅限該函數內部
<?php
function counter() {
    static $count = 0; // 只執行一次初始化
    $count++;
    echo "Call #$count\n";
}

counter(); // Call #1
counter(); // Call #2
counter(); // Call #3

// 實用範例:一次性初始化昂貴資源
function getDbConnection(): PDO {
    static $pdo = null;
    if ($pdo === null) {
        $pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }
    return $pdo;
}

遞迴應用:斐波那契數列備忘錄

<?php
function fib(int $n): int {
    static $cache = [0 => 0, 1 => 1];

    if (isset($cache[$n])) return $cache[$n];

    return $cache[$n] = fib($n - 1) + fib($n - 2);
}

for ($i = 0; $i < 20; $i++) {
    echo fib($i) . ' '; // 0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597 2584 4181
}

靜態與非靜態對比

<?php
class Demo {
    public $instanceProp = 0;
    public static $staticProp = 0;

    public function incBoth() {
        $this->instanceProp++;
        self::$staticProp++;
    }
}

$obj1 = new Demo();
$obj2 = new Demo();

$obj1->incBoth(); // instance:1, static:1
$obj2->incBoth(); // instance:1, static:2

echo $obj1->instanceProp; // 1 (各自獨立)
echo $obj2->instanceProp; // 1
echo Demo::$staticProp;   // 2 (共享)
echo $obj1::$staticProp;  // 2 (物件也可存取靜態)

常見陷阱與最佳實踐

❌ 陷阱 1:靜態屬性無法使用 $this

class Bad {
    public static $val = 1;
    public function show() {
        echo $this->val; // Error: Access to undeclared property
    }
}

// ✅ 正確
class Good {
    public static $val = 1;
    public function show() {
        echo self::$val; // 或 static::$val
    }
}

❌ 陷阱 2:靜態屬性繼承共享導致非預期行為

class ParentConfig {
    public static $options = ['debug' => false];
}

class ChildA extends ParentConfig {}
class ChildB extends ParentConfig {}

ChildA::$options['debug'] = true;
echo ChildB::$options['debug']; // true (共享同一陣列!)

// ✅ 解決:子類重新宣告或使用靜態方法取得副本
class FixedParent {
    protected static $defaultOptions = ['debug' => false];
    public static function getOptions(): array {
        return static::$defaultOptions; // 各子類可覆寫 $defaultOptions
    }
}

✅ 最佳實踐:單例模式

<?php
class Database {
    private static ?self $instance = null;
    private PDO $pdo;

    private function __construct() {
        $this->pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
    }

    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    // 防止複製/序列化
    private function __clone() {}
    public function __wakeup() { throw new Exception('Cannot unserialize singleton'); }

    public function query(string $sql): array {
        return $this->pdo->query($sql)->fetchAll();
    }
}

// 使用
$rows = Database::getInstance()->query('SELECT * FROM users');

PHP 8.1+ 新特性:readonly 靜態屬性

<?php
class Config {
    public static readonly string $APP_VERSION = '1.0.0';
    // 初始化後不可修改,連繼承類也無法覆寫
}

總結

  • 類靜態屬性:類層級共享狀態,配合 static:: 實現多型
  • 函數靜態變數:函數內部持久狀態,適用單次初始化、遞迴快取
  • 記憶體:進程生命週期內常駐,長跑程式 (Swoole/RoadRunner) 需手動重置
  • 測試:靜態狀態導致測試相互干擾,使用 runInSeparateProcess 或重置方法
copyright © 萬盛學電腦網 all rights reserved