萬盛學電腦網

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

PHP 設計模式:註冊表模式——全局對象管理的優雅解決方案

模式動機

應用中常需全局訪問某些共享對象:資料庫連接、配置對象、日誌器、緩存客戶端、服務容器。直接使用全局變量 $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]);
        // ...
    }
}

現代框架中的註冊表

避坑指南:註冊表 ≠ 上帝類

框架對應組件特點
LaravelApplication 容器 (IoC Container)綁定、解析、自動注入、標籤、上下文綁定
SymfonyService Container編譯期優化、參數包、環境變量、自動配置
ThinkPHPContainer / Facade靜態代理、依賴注入、服務提供者
SlimContainer (PSR-11)輕量、委托給 PHP-DI/Pimple
反模式後果修正
所有對象塞進註冊表變成「上帝類」,耦合度極高,不可測試僅存放真正的共享服務(DB、Config、Cache、Logger)
業務邏輯直接靜態調用 App::registry()->get()隱式依賴,單元測試困難構造函數注入依賴,或使用框架自動注入
存儲狀態數據(如當前用戶、請求輸入)請求間數據洩漏、並發 Bug請求數據用 Request 對象、Session、上下文對象
不清理資源長運行進程(Swoole/Workerman)內存洩漏請求結束調用 clear(),或使用弱引用

PSR-11 容器接口標準

現代 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)均實現此接口

總結

註冊表模式以 「中心化存儲 + 鍵值訪問 + 延遲實例化」 解決全局對象管理問題。關鍵原則:

  1. 只存共享服務,不存請求級數據。
  2. 優先依賴注入,註冊表作為「最後手段」或框架基礎設施。
  3. 面向接口編程,存儲/獲取均使用接口類型。
  4. 生命週期可控,支援單例、工廠、原型等多種策略。

在現代 PHP 開發中,請直接使用框架提供的 PSR-11 兼容容器**,而非手寫 Registry 類。

copyright © 萬盛學電腦網 all rights reserved