Правила Psalm или PHPStan для принудительного обновления DocBlocks?Php

Кемеровские программисты php общаются здесь
Ответить
Anonymous
 Правила Psalm или PHPStan для принудительного обновления DocBlocks?

Сообщение Anonymous »

Есть ли способ указать Psalm или PHPStan, чтобы они следили за тем, чтобы все обновленные методы также получали обновленные DocBlocks?
Это обычная проблема в командах разработчиков программного обеспечения. DocBlock будет записан во время первоначального создания метода. Затем метод меняется, и DocBlock оказывается устаревшим и неточным.
Если есть простой способ сообщить моему CI-конвейеру (или даже git-хуку), что DocBlock находится в опасность быть неточным, я бы хотел это сделать. Если такого инструмента нет, я хотел бы создать его как небольшой побочный проект.
===
EDIT: Я надеюсь чтобы иметь возможность показать, когда изменился немашиночитаемый комментарий. Для этого можно использовать теги @since и @version, но в идеале мне бы хотелось, чтобы отображалась дата или отдельный коммит, поскольку они были бы более детальными. Таким образом, в идеале мой конвейер мог бы проверять, был ли обновлен удобочитаемый комментарий при обновлении соответствующего метода, и жаловаться, если нет.

Подробнее здесь: https://stackoverflow.com/questions/793 ... -docblocks
Ответить

Быстрый ответ

Изменение регистра текста: 
Смайлики
:) :( :oops: :roll: :wink: :muza: :clever: :sorry: :angel: :read: *x)
Ещё смайлики…
   
К этому ответу прикреплено по крайней мере одно вложение.

Если вы не хотите добавлять вложения, оставьте поля пустыми.

Максимально разрешённый размер вложения: 15 МБ.

Вернуться в «Php»