如何让PHPStan识别$entry的动态实体类型（基于变量实体名）

对于你这种中央CRUD控制器动态实例化50+实体的场景，以下几个简洁方案可让PHPStan正确识别类型，无需修改实体代码或枚举所有类型：

1. 泛型模板标注（最简单的即时方案） #

直接在控制器代码中通过泛型关联$entity和$entry的类型：

// 约束$entity为合法的类字符串，关联泛型T
/** @var class-string<T> $entity */
$entity = $this->extractEntityFromUrl(); // 从URL获取类名的逻辑

// 实例化时标注$entry为泛型T对应的类型
/** @var T $entry */
$entry = new $entity($id);

如果所有实体都继承自同一父类（比如BaseEntity），可以把约束写得更明确：

/** @var class-string<BaseEntity> $entity */
$entity = ...;
/** @var BaseEntity $entry */
$entry = new $entity($id);

这样PHPStan就能自动识别$entry的类型及getId()方法。

2. 结构类型标注（无共同父类时可用） #

如果实体没有统一父类，但都实现了getId()方法，直接用结构类型描述：

/** @var object{getId(): int|string} $entry */
$entry = new $entity($id);

这种方式不依赖继承关系，直接通过方法签名约束，PHPStan会认可$entry->getId()的调用。

3. 自定义PHPStan扩展（长期维护最优解） #

若项目长期迭代，写一个简单的PHPStan扩展可自动处理动态实例化的类型推断：

1. 创建扩展类实现DynamicReturnTypeExtension接口，识别new $entity()表达式并返回对应类类型
2. 在phpstan.neon中注册该扩展

示例扩展代码：

<?php

namespace YourProject\PHPStan;

use PHPStan\Type\DynamicReturnTypeExtension;
use PHPStan\Type\ObjectType;
use PHPStan\Type\Type;
use PHPStan\Type\TypeUtils;
use PhpParser\Node\Expr\New_;
use PHPStan\Analyser\Scope;

class DynamicEntityInstantiationExtension implements DynamicReturnTypeExtension
{
    public function getClass(): string
    {
        return \stdClass::class;
    }

    public function isMethodSupported(\PHPStan\Reflection\MethodReflection $methodReflection): bool
    {
        return false;
    }

    public function getTypeFromNewExpression(New_ $newNode, Scope $scope): ?Type
    {
        $classExpr = $newNode->class;
        if (!$classExpr instanceof \PhpParser\Node\Expr\Variable) {
            return null;
        }

        $varType = $scope->getVariableType($classExpr->name);
        $classStrings = TypeUtils::getClassStrings($varType);

        return count($classStrings) === 1 ? new ObjectType($classStrings[0]) : null;
    }
}

注册扩展（phpstan.neon）：

services:
    -
        class: YourProject\PHPStan\DynamicEntityInstantiationExtension
        tags:
            - phpstan.dynamicReturnTypeExtension

之后PHPStan会自动识别动态实例化的实体类型，无需手动标注。

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