Мой идеал всегда просит, чтобы я прописал все @param и @thorws, но иногда таких параметров много, получается что-то вроде (иногда больше)
* @param Request $request
* @param Conference $conference
* @param CommentRepository $commentRepository
* @param string $photoDir
* @param Environment $twig
* @param EntityManagerInterface $entityManager
* @param MessageBusInterface $bus
* @param Comment $comment
* @param Registry $registry
* @return Response
* @throws LoaderError
* @throws RuntimeError
* @throws SyntaxError
*/
Их много и я думаю, что они загрязняют код, потому что типы, которые я указываю в параметрах функции.
public function show(Request $request,
Conference $conference,
CommentRepository $commentRepository,
string $photoDir, Environment $twig,
EntityManagerInterface $entityManager,
MessageBusInterface $bus, Comment $comment,
Registry $registry)
Иногда эта документация становится намного больше, чем функция.
Я также посмотрел на демо symfony и не нашел там перечисления параметров. https://github.com/symfony/demo/blob/master/src/Controller/BlogController.php
Как вы думаете, мы должны написать все эти параметры и броски в документации метода?