What are comments before class functions in php used for?

Question

Documentation

For example:
/**
* __invoke
*
* access public
* @param \ZfcUser\Entity\UserInterface $user
* @throws \ZfcUser\Exception\DomainException
* return String
*/
How is it used and where?

Answer 1

Well, firstly, the comments are useful for other developers to understand what is happening there.
But these specific comments are used to automatically generate documentation for your application. There are special scripts that can do this. For example the oldest and most famous phpDocumentor