PHP如何限制函数参数为CommonRepository子类的类类型？

我接手了如下代码：

public static function instanciateRepository( $repositoryClass, ... ) {
    // ...
    new $repositoryClass( ... );
}

其中$repositoryClass是需要实例化的类类型。我希望为该函数添加语法检查，限制$repositoryClass必须是CommonRepository的子类，请问PHP中是否有对应的语法构造可以实现，例如写法：instanciateRepository( CommonRepository::class $repositoryClass, .. )？

首先明确：你提到的CommonRepository::class $repositoryClass这种写法在PHP里是无效的，没法直接用类常量作为参数类型提示。不过有两种可行方案来实现你的需求：

1. 运行时类型检查（兼容所有PHP版本） #

先用string限定参数类型，再在函数内部验证类的继承关系：

public static function instanciateRepository(string $repositoryClass, ...$args): CommonRepository {
    // 先检查类是否存在，再验证是否是CommonRepository的子类
    if (!class_exists($repositoryClass) || !is_subclass_of($repositoryClass, CommonRepository::class)) {
        throw new InvalidArgumentException(sprintf(
            '%s 必须是 CommonRepository 的子类',
            $repositoryClass
        ));
    }
    return new $repositoryClass(...$args);
}

这种方式能在运行时强制约束，不符合条件就抛出异常，确保传入的类符合要求。

2. 静态分析层面的类型约束（PHP 8.0+） #

如果你的项目用的是PHP 8.0及以上版本，可以借助class-string泛型来做静态类型提示：

public static function instanciateRepository(class-string<CommonRepository> $repositoryClass, ...$args): CommonRepository {
    // 建议保留运行时检查，因为PHP本身不会强制验证泛型约束
    if (!class_exists($repositoryClass) || !is_subclass_of($repositoryClass, CommonRepository::class)) {
        throw new InvalidArgumentException(sprintf(
            '%s 必须是 CommonRepository 的子类',
            $repositoryClass
        ));
    }
    return new $repositoryClass(...$args);
}

这种写法能让PHPStan、Psalm这类静态分析工具在开发阶段就检测出不符合的类传入，提前发现问题，但PHP运行时不会自动验证这个泛型约束，所以还是建议搭配运行时检查一起用。

内容的提问来源于stack exchange，提问作者Anton Duzenko