Для чего используются комментарии перед функциями классов в php?
Например, так:
/**
* __invoke
*
* access public
* @param \ZfcUser\Entity\UserInterface $user
* @throws \ZfcUser\Exception\DomainException
* return String
*/
Как это используется и где?
Ну во первых коментарии ползны для дургих девелоперов что бы понять что там происходит.
Но эти конкретно комментарии используются для автоматической генерации документации для вашего приложения. Есть специальные скрипты которые это могут делать. Например самый старый и известный phpDocumentor
Простой
