Пока вы вызываете одну функцию и решаете, что делать с ее ответом, вы не поймете исключений.
Вот когда вам надо будет вызвать функцию, которая вызывает методы класса, которые вызывают методы других классов - вы либо изрисуете себе все стены теми вариантами ошибок, которые каждый из этих методов может вернуть, либо поймете, как это прекрасно - просто поймать исключение, если что-то пошло не так, и не париться с тем, что и где именно.
Всё зависит от того, каким редактором или IDE пользовался автор кода - обычно там свои встроенные генераторы для комментариев. Например, PhpStorm использует https://www.phpdoc.org/ - этот стандарт.
@inheritdoc - согласно стандарту, отсылка к документации родительского класса.
ставить так - перед функцией или переменной нажимаете три клавиши: /** , затем ENTER
Ответ написан
Комментировать
Комментировать
Оценили как «Нравится»
Войдите на сайт
Чтобы задать вопрос и получить на него квалифицированный ответ.