如何修复接口 class 上有关 PHPDoc 的错误

Question

我正在开发一个 PHP 库，我有两个 classes。

第一个是这样的：

/**
 * @method static A getInstance()
 */
interface A {...}

第二个是这样的：

class B implements A {...}

getInstance 未在 A 中定义，class 上方的 PHPDoc 除外。现在，我的 IDE (PHPStorm) 提示错误，说我应该在 B.

中实现 getInstance

我的问题是：

1. 为什么他们把这个方法放在 PHPDoc 中，即使它没有在接口中声明？我怀疑这是一个错误，因为他们在许多其他 classes.

中使用了相同的评论

2. 你推荐什么？我应该在 B 中实施还是应该从 A 中删除 PHPDoc 注释？

Answer 1

我认为这是错误的，因为任何实现 OW_Storage 接口的 类 都没有实现 getInstance() 方法。您可以通过帮助 search 来确定它。表示没有使用这个功能

您可以从界面中删除文档块，但正确的方法是在原始存储库中执行拉取请求。