PhpStorm中动态类声明的代码提示问题求助

我正在使用PhpStorm，编写了如下类：

class MasterClass {
    public function getClass($className)
    {
        require_once("/php/class/$className.php");
        $newClass = new $className();
        return $newClass;
    }
}

在PHP文件中按如下方式调用该方法：

$MasterClass = new MasterClass();
$roles = $MasterClass->getClass('Roles');
$roles->

此时IDE无法显示代码提示/方法使用建议。我尝试使用@link Roles和@see Roles等PHPDoc标签均无效，仅找到@see classname::method()的解决方案，但需逐个配置调用的方法。请问是否可通过PHPDoc实现代码提示？

可以通过PHPDoc实现代码提示，推荐两种高效方案：

方案1：给getClass方法添加泛型PHPDoc标注 #

修改MasterClass的方法注释，利用泛型让IDE自动推断返回类型：

/**
 * @template T of object
 * @param class-string<T> $className 要实例化的类名
 * @return T 返回实例化后的对象
 */
public function getClass($className)
{
    require_once("/php/class/$className.php");
    $newClass = new $className();
    return $newClass;
}

添加后，当你传入'Roles'作为参数时，PhpStorm会自动识别$roles的类型为Roles，直接给出对应的方法和属性提示。

方案2：调用处手动标注变量类型 #

如果不想修改原类的代码，可在调用位置通过@var标签指定变量类型：

$MasterClass = new MasterClass();
/** @var Roles $roles */
$roles = $MasterClass->getClass('Roles');
$roles->

这种方式无需改动原类，适合局部场景的类型提示需求。

注意事项 #

• class-string<T>是PHP 8.0及以上版本支持的类型声明语法，若使用更低版本PHP，可将@param改为@param string $className，保留@template和@return T的标注，PhpStorm依然能正常识别。

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