兩類「靜態」概念區分
| 類型 | 關鍵字 | 作用域 | 生命週期 | 典型用途 |
| 類靜態屬性 | 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 或重置方法