如何告诉phpDoc字符串是类名？

Question

我经常给对象提供静态方法和属性，这些方法和属性不需要初始化对象。例如：

class SomeObject {
    public function __construct($object_id) {
        $this->loadProperties($object_id);
    }

    public static function getSomeStaticString() {
        return "some static string";
    }
}

现在，我们对这些对象进行了子类化，并具有某种控制器，该控制器在某些尚不应该初始化对象的情况下返回对象类字符串。例如：

class SomeObjectController {
    public function getSomeObjectWithTheseProperties(array $properties) {
        if($properties[0] === "somevalue") {
            if($properties[1] === "someothervalue") {
                return SomeSubclassObject::class;
            }

            return SomeObject::class;
        }

        return NULL;
    }
}

有时我可能想在SomeObject::getSomeStaticString()不实际初始化对象的情况下调用静态函数（因为这将涉及不需要的数据库提取）。例如：

$controller = new SomeObjectController;
$properties = array("somevalue", "someothervalue");
$object_class = $controller->getSomeObjectWithTheseProperties($properties);

echo $object_class::getSomeStaticString();

问题：我可以以某种方式最好通过phpDoc告诉PhpStorm，它$object_class是的子类的类字符串SomeObject吗？

如果我告诉我的IDE它是一个字符串，它将通知我这getSomeStaticString()是一个无效方法。另一方面，如果我告诉我的IDE是SomeObject的实例，它认为我可以访问常规的非静态方法和属性，而我不能。

Answer 1

class-stringPHPStan为此使用PHPDoc 类型。PHPStorm 自2020.3起就开始支持它，但从2021.2开始，它似乎可以正常工作（所有自动完成功能都可用），当时他们添加了对泛型的支持。

在您的情况下，返回类型注释将是@return class-string<SomeObject>.