應用中常需全局訪問某些共享對象:資料庫連接、配置對象、日誌器、緩存客戶端、服務容器。直接使用全局變量 $GLOBALS 或單例會導致:
註冊表模式** 提供一個 中心化存儲,通過 鍵值對 管理對象實例,支援 set/get/has/remove 操作,實現「受控的全局訪問」。
<?php
interface RegistryInterface {
public function set(string $key, object $object): void;
public function get(string $key): ?object;
public function has(string $key): bool;
public function remove(string $key): void;
public function clear(): void;
}
class Registry implements RegistryInterface {
private array $objects = [];
public function set(string $key, object $object): void {
$this->objects[$key] = $object;
}
public function get(string $key): ?object {
return $this->objects[$key] ?? null;
}
public function has(string $key): bool {
return isset($this->objects[$key]);
}
public function remove(string $key): void {
unset($this->objects[$key]);
}
public function clear(): void {
$this->objects = [];
}
}
// 全局單例訪問點(或注入到需要的地方)
class App {
private static RegistryInterface $registry;
public static function setRegistry(RegistryInterface $registry): void {
self::$registry = $registry;
}
public static function registry(): RegistryInterface {
return self::$registry;
}
}
// 初始化
App::setRegistry(new Registry());
註冊「工廠回調」而非實例,首次獲取時才創建:
class LazyRegistry implements RegistryInterface {
private array $factories = [];
private array $instances = [];
public function setFactory(string $key, callable $factory): void {
$this->factories[$key] = $factory;
}
public function set(string $key, object $object): void {
$this->instances[$key] = $object;
unset($this->factories[$key]);
}
public function get(string $key): ?object {
if (isset($this->instances[$key])) return $this->instances[$key];
if (isset($this->factories[$key])) {
$instance = ($this->factories[$key])();
$this->instances[$key] = $instance;
unset($this->factories[$key]);
return $instance;
}
return null;
}
// has/remove/clear 類似...
}
// 使用
$registry = new LazyRegistry();
$registry->setFactory('db', fn() => Database::getInstance(...));
$registry->setFactory('logger', fn() => new Logger('app'));
// 首次使用時才真正創建
$db = App::registry()->get('db');
註冊表是 服務定位器** 的核心實現:
class ServiceLocator {
private RegistryInterface $registry;
public function __construct(RegistryInterface $registry) {
$this->registry = $registry;
}
public function get(string $id): mixed {
$service = $this->registry->get($id);
if (!$service) throw new Exception("Service {$id} not found");
return $service;
}
public function set(string $id, mixed $service): void {
$this->registry->set($id, $service);
}
}
// 控制器中使用
class UserController {
public function __construct(private ServiceLocator $locator) {}
public function show(int $id): void {
$db = $this->locator->get('db');
$user = $db->query("SELECT * FROM users WHERE id = ?", [$id]);
// ...
}
}
| 框架 | 對應組件 | 特點 |
|---|---|---|
| Laravel | Application 容器 (IoC Container) | 綁定、解析、自動注入、標籤、上下文綁定 |
| Symfony | Service Container | 編譯期優化、參數包、環境變量、自動配置 |
| ThinkPHP | Container / Facade | 靜態代理、依賴注入、服務提供者 |
| Slim | Container (PSR-11) | 輕量、委托給 PHP-DI/Pimple |
| 反模式 | 後果 | 修正 |
|---|---|---|
| 所有對象塞進註冊表 | 變成「上帝類」,耦合度極高,不可測試 | 僅存放真正的共享服務(DB、Config、Cache、Logger) |
業務邏輯直接靜態調用 App::registry()->get() | 隱式依賴,單元測試困難 | 構造函數注入依賴,或使用框架自動注入 |
| 存儲狀態數據(如當前用戶、請求輸入) | 請求間數據洩漏、並發 Bug | 請求數據用 Request 對象、Session、上下文對象 |
| 不清理資源 | 長運行進程(Swoole/Workerman)內存洩漏 | 請求結束調用 clear(),或使用弱引用 |
現代 PHP 採用 PSR-11 ContainerInterface 統一容器契約:
interface ContainerInterface {
public function get(string $id): mixed;
public function has(string $id): bool;
}
// 所有主流容器(PHP-DI, Symfony, Laravel, Pimple, League\Container)均實現此接口
註冊表模式以 「中心化存儲 + 鍵值訪問 + 延遲實例化」 解決全局對象管理問題。關鍵原則:
在現代 PHP 開發中,請直接使用框架提供的 PSR-11 兼容容器**,而非手寫 Registry 類。