php - 像@static这样的冗余php docblock标签有什么意义？

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 会将它们标记为静态。