PHPStorm: автогенерировать документацию inheritdoc при реализации методов абстрактного родительского класса

Используется PHPStorm и всякий раз, когда я реализую абстрактный метод родительского класса для некоторого подкласса, я запускаю команду Implement Methods, в которой он автоматически генерирует функциональные блоки и блоки своих документов.

Меня раздражает, что мне все еще нужно вручную изменить блоки doc на {@inheritdoc}.

Теперь мой вопрос: есть ли способ настроить PHPStorm для генерации блока {@inheritdoc} doc при реализации методов вместо того, чтобы генерировать исходный блок doc?

Ответы

Ответ 1

  1. В меню выберите " Code > Generate > Implement method (Ctrl + I).
  2. Проверьте "Добавить PHPDoc"
  3. Выберите "С тегом @inheritDoc"

Источник: https://youtrack.jetbrains.com/issue/WI-16547.

Ответ 2

Если вы хотите автоматически сгенерировать @inheritdoc PHPDoc не только при использовании метода реализации, но и во всех случаях, перейдите к

Preferences > Editor > File and Code Templates > PHP Function Doc Comment

и замените существующий шаблон следующим:

/**
#if (${inheritDoc} != "void") 
* {@inheritDoc}
#else
${PARAM_DOC}
@return ${TYPE_HINT}
#end
${THROWS_DOC}
*/