当前位置：首页 > PHP

php实现spi设计

2026-02-15 22:58:03PHP

SPI设计模式简介

SPI（Service Provider Interface）是一种服务发现机制，通过接口与实现分离的方式实现模块化扩展。PHP中可通过接口定义、实现注册和动态加载来实现SPI模式。

定义服务接口

创建核心模块定义的抽象接口，约定服务提供方必须实现的方法：

interface CacheService {
    public function get(string $key);
    public function set(string $key, $value);
    public function delete(string $key);
}

实现服务提供者

在扩展模块中实现具体服务逻辑，需实现核心接口：

class RedisCache implements CacheService {
    public function get(string $key) {
        // Redis获取逻辑
    }

    public function set(string $key, $value) {
        // Redis存储逻辑
    }

    public function delete(string $key) {
        // Redis删除逻辑
    }
}

注册服务提供者

通过配置文件或自动发现机制注册实现类：

php实现spi设计

// 配置文件方式
return [
    'cache_service' => RedisCache::class
];

// 自动发现方式（需遵循PSR-4）
$implementations = [];
foreach (get_declared_classes() as $class) {
    if (is_subclass_of($class, CacheService::class)) {
        $implementations[] = $class;
    }
}

服务加载器实现

创建工厂类根据配置动态加载服务实例：

class ServiceLoader {
    private static $services = [];

    public static function load(string $serviceName) {
        if (!isset(self::$services[$serviceName])) {
            $className = config($serviceName); // 从配置获取实现类
            self::$services[$serviceName] = new $className();
        }
        return self::$services[$serviceName];
    }
}

// 使用示例
$cache = ServiceLoader::load('cache_service');
$cache->set('user_1', ['name' => 'John']);

自动发现优化

结合Composer实现自动注册：

php实现spi设计

在composer.json中定义extra字段：

{
 "extra": {
     "spi-providers": {
         "CacheService": "Vendor\\Cache\\RedisCache"
     }
 }
}

通过插件或启动脚本自动加载：

$packages = json_decode(file_get_contents('vendor/composer/installed.json'), true);
foreach ($packages['extra']['spi-providers'] ?? [] as $interface => $class) {
 ServiceLoader::register($interface, $class);
}

多实现管理

支持同一接口的多个实现版本：

class MultiServiceLoader {
    private static $providers = [];

    public static function addProvider(string $interface, string $implClass) {
        self::$providers[$interface][] = $implClass;
    }

    public static function getProviders(string $interface): array {
        return array_map(fn($cls) => new $cls(), self::$providers[$interface] ?? []);
    }
}