冗余的php docblock标签有什么意义,比如@static？

Question

当在PhpStorm中使用自动php docblock生成时,我最终得到了@static一个静态方法的注释:

/**
 * Reset the singleton instance, for the tests only
 * @static
 */
public static function reset() {
    self::$singletonInstance = null;
}

如果可以从代码中推断出这些标签有什么用处吗？我正在试图决定是否应该离开它或将其删除(并且在任何地方都这样做以使其保持一致).

Answer 1

这些标记是针对遗留PHP 4代码引入的,这些代码不允许在代码中使用此类关键字.使用PHP 5,代码实际上是自我记录的,因此这些标记确实是多余的; 我认为没有任何理由让他们留下来.

实际上,如果您为PHP 5源文件生成文档,phpDocumentor应该仍然能够确定这些是静态方法.这在phpDocumentor文档中提到:

只需在代码中使用static关键字就足以让PHP5上的PhpDocumentor识别静态变量和方法,而PhpDocumentor会将它们标记为静态.