注释@template在PHP文档块中意味着什么?

Question

我可以在FakerPHP/Faker包中看到这个PHPDoc块，我不知道@template是什么意思?你可以在包的主分支

这一行找到它。

/**
* @template T of ExtensionExtension
*
* @param class-string<T> $id
*
* @throws ContainerExceptionInterface
* @throws ExtensionExtensionNotFound
*
* @return T
*/

Answer 1

@template注释涉及到一个称为泛型的概念，它目前在PHP中不存在，但它是一种动态描述参数或返回类型的内容的方法，这些内容在类实例化或方法调用之前是未知的。

对于PHP，这里有一篇文章描述了文档块本身以及如何使用它们。

对于您引用的代码，模板指定T将是ExtensionExtension的实例。$id参数将是T的类名，@return表示该方法将返回T的一个实例。

使用该方法类似于$faker->ext(MyExtension::class)，它将返回MyExtension的一个实例。

如果你想跟随兔子，这里有更多关于泛型编程。