PHP动态返回类型问题：如何让PhpStorm识别泛型类型提示

核心问题 #

你的代码存在两个关键问题导致PhpStorm无法正确推断返回类型：

• 子类未明确指定泛型参数：FooRepository继承AbstractRepository时，未告知PhpStorm泛型T对应的具体类是MyModel
• 文档注释格式错误：findById方法的注释使用了/*而非/**，IDE无法识别为有效的类型注解

修正后的代码 #

/**
 * @template T
 */
abstract class AbstractRepository
{
    /**
     * @psalm-var class-string<T>
     */
    protected $className;

    public function __construct(string $className)
    {
        $this->className = $className;
    }

    /**
     * @psalm-return ?T
     */
    public function findById(string $id)
    {
        // 执行相关调用并基于类名返回实际模型
    }
}

/**
 * @extends AbstractRepository<MyModel>
 */
class FooRepository extends AbstractRepository
{
    public function __construct()
    {
        parent::__construct(MyModel::class);
    }
}

// 现在PhpStorm会提示返回类型为?MyModel
(new FooRepository())->findById('bar');

额外优化（可选） #

如果希望更严格约束构造函数参数类型，可以给抽象类构造函数补充类型注解：

public function __construct(/** @psalm-param class-string<T> $className */ string $className)
{
    $this->className = $className;
}

这样PhpStorm在子类调用父类构造函数时，会对传入的类名做类型校验，避免传入错误类。

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