Как использовать PHPDo c? - PullRequest
       76

Как использовать PHPDo c?

1 голос
/ 28 апреля 2020

Мой идеал всегда просит, чтобы я прописал все @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

Как вы думаете, мы должны написать все эти параметры и броски в документации метода?

...