Как исправить ошибку о PHPDoc на интерфейсе класса

Question

Я работаю над библиотекой PHP и у меня есть два класса.

Первый такой:

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

Второй такой:

class B implements A {...}

getInstance не определено в A, за исключением PHPDoc над классом. Теперь, моя IDE (PHPStorm) предлагает ошибку, говоря, что я должен реализовать getInstance в B.

Мои вопросы:

1. Почему они помещают этот метод в PHPDoc, даже если он не объявлен в интерфейсе? Я сомневаюсь, что это ошибка, так как они использовали один и тот же комментарий во многих других классах.

2. Что вы рекомендуете? я должен реализовать в B или я должен удалить комментарий PHPDoc из A?

Answer 1

Я думаю, что это ошибка, потому что ни один из классов, которые реализуют интерфейс OW_Storage, не реализует метод getInstance(). Вы можете убедиться в этом с помощью search . Это означает, что эта функция не используется.

Вы можете удалить блок doc из интерфейса, но правильный способ - сделать pull-запрос в репозитории origin.