bug #1370 Fix issues reported by PHPStan #1334 (kniziol)

This PR was squashed before being merged into the main branch.

Discussion
----------

Fix issues reported by PHPStan #1334

Closes #1334

Commits
-------

773f504 Fix issues reported by PHPStan #1334

Author: javiereguiluz

phpstan-baseline.neon

@@ -1,6 +1,3 @@
-includes:
-    - phpstan-baseline.neon
-
 parameters:
     level: max
     paths:

phpstan.neon.dist

@@ -129,7 +129,9 @@ protected function interact(InputInterface $input, OutputInterface $output): voi
         }
 
         // Ask for the password if it's not defined
+        /** @var string|null $password */
         $password = $input->getArgument('password');
+
         if (null !== $password) {
             $this->io->text(' > <info>Password</info>: '.u('*')->repeat(u($password)->length()));
         } else {
@@ -165,10 +167,18 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $stopwatch = new Stopwatch();
         $stopwatch->start('add-user-command');
 
+        /** @var string $username */
         $username = $input->getArgument('username');
+
+        /** @var string $plainPassword */
         $plainPassword = $input->getArgument('password');
+
+        /** @var string $email */
         $email = $input->getArgument('email');
+
+        /** @var string $fullName */
         $fullName = $input->getArgument('full-name');
+
         $isAdmin = $input->getOption('admin');
 
         // make sure to validate the user data is correct
@@ -198,7 +208,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         return Command::SUCCESS;
     }
 
-    private function validateUserData($username, $plainPassword, $email, $fullName): void
+    private function validateUserData(string $username, string $plainPassword, string $email, string $fullName): void
     {
         // first check if a user with the same username already exists.
         $existingUser = $this->users->findOneBy(['username' => $username]);

src/Command/AddUserCommand.php

@@ -107,7 +107,9 @@ protected function interact(InputInterface $input, OutputInterface $output): voi
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
-        $username = $this->validator->validateUsername($input->getArgument('username'));
+        /** @var string|null $username */
+        $username = $input->getArgument('username');
+        $username = $this->validator->validateUsername($username);
 
         /** @var User|null $user */
         $user = $this->users->findOneByUsername($username);

src/Command/DeleteUserCommand.php

@@ -88,20 +88,25 @@ protected function configure(): void
      */
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
+        /** @var int|null $maxResults */
         $maxResults = $input->getOption('max-results');
+
         // Use ->findBy() instead of ->findAll() to allow result sorting and limiting
         $allUsers = $this->users->findBy([], ['id' => 'DESC'], $maxResults);
 
-        // Doctrine query returns an array of objects and we need an array of plain arrays
-        $usersAsPlainArrays = array_map(static function (User $user) {
+        $createUserArray = static function (User $user) {
             return [
                 $user->getId(),
                 $user->getFullName(),
                 $user->getUsername(),
                 $user->getEmail(),
                 implode(', ', $user->getRoles()),
             ];
-        }, $allUsers);
+        };
+
+        // Doctrine query returns an array of objects, and we need an array of plain arrays
+        /** @var callable $createUserArray */
+        $usersAsPlainArrays = array_map($createUserArray, $allUsers);
 
         // In your console commands you should always use the regular output type,
         // which outputs contents directly in the console window. However, this
@@ -119,7 +124,10 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $usersAsATable = $bufferedOutput->fetch();
         $output->write($usersAsATable);
 
-        if (null !== $email = $input->getOption('send-to')) {
+        /** @var string $email */
+        $email = $input->getOption('send-to');
+
+        if (null !== $email) {
             $this->sendReport($usersAsATable, $email);
         }
 

src/Command/ListUsersCommand.php

@@ -19,6 +19,7 @@
 use Doctrine\ORM\EntityManagerInterface;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 use Symfony\Component\Form\Extension\Core\Type\SubmitType;
+use Symfony\Component\Form\SubmitButton;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Annotation\Route;
@@ -80,7 +81,8 @@ public function new(
 
         // See https://symfony.com/doc/current/form/multiple_buttons.html
         $form = $this->createForm(PostType::class, $post)
-            ->add('saveAndCreateNew', SubmitType::class);
+            ->add('saveAndCreateNew', SubmitType::class)
+        ;
 
         $form->handleRequest($request);
 
@@ -98,7 +100,10 @@ public function new(
             // See https://symfony.com/doc/current/controller.html#flash-messages
             $this->addFlash('success', 'post.created_successfully');
 
-            if ($form->get('saveAndCreateNew')->isClicked()) {
+            /** @var SubmitButton $submit */
+            $submit = $form->get('saveAndCreateNew');
+
+            if ($submit->isClicked()) {
                 return $this->redirectToRoute('admin_post_new');
             }
 
@@ -156,7 +161,10 @@ public function edit(Request $request, Post $post, EntityManagerInterface $entit
     #[IsGranted('delete', subject: 'post')]
     public function delete(Request $request, Post $post, EntityManagerInterface $entityManager): Response
     {
-        if (!$this->isCsrfTokenValid('delete', $request->request->get('token'))) {
+        /** @var string|null $token */
+        $token = $request->request->get('token');
+
+        if (!$this->isCsrfTokenValid('delete', $token)) {
             return $this->redirectToRoute('admin_post_index');
         }
 

src/Controller/Admin/BlogController.php

@@ -13,6 +13,7 @@
 
 use App\Entity\Comment;
 use App\Entity\Post;
+use App\Entity\Tag;
 use App\Entity\User;
 use App\Event\CommentCreatedEvent;
 use App\Form\CommentType;
@@ -52,6 +53,7 @@ public function index(Request $request, int $page, string $_format, PostReposito
     {
         $tag = null;
         if ($request->query->has('tag')) {
+            /** @var Tag $tag */
             $tag = $tags->findOneBy(['name' => $request->query->get('tag')]);
         }
         $latestPosts = $posts->findLatest($page, $tag);
@@ -155,8 +157,8 @@ public function commentForm(Post $post): Response
     #[Route('/search', methods: ['GET'], name: 'blog_search')]
     public function search(Request $request, PostRepository $posts): Response
     {
-        $query = $request->query->get('q', '');
-        $limit = $request->query->get('l', 10);
+        $query = (string) $request->query->get('q', '');
+        $limit = (int) $request->query->get('l', 10);
 
         if (!$request->isXmlHttpRequest()) {
             return $this->render('blog/search.html.twig', ['query' => $query]);
@@ -166,11 +168,20 @@ public function search(Request $request, PostRepository $posts): Response
 
         $results = [];
         foreach ($foundPosts as $post) {
+            /** @var string $author */
+            $author = $post->getAuthor() ? $post->getAuthor()->getFullName() : '';
+
+            /** @var string $title */
+            $title = $post->getTitle();
+
+            /** @var string $summary */
+            $summary = $post->getSummary();
+
             $results[] = [
-                'title' => htmlspecialchars($post->getTitle(), \ENT_COMPAT | \ENT_HTML5),
+                'title' => htmlspecialchars($title, \ENT_COMPAT | \ENT_HTML5),
                 'date' => $post->getPublishedAt()->format('M d, Y'),
-                'author' => htmlspecialchars($post->getAuthor()->getFullName(), \ENT_COMPAT | \ENT_HTML5),
-                'summary' => htmlspecialchars($post->getSummary(), \ENT_COMPAT | \ENT_HTML5),
+                'author' => htmlspecialchars($author, \ENT_COMPAT | \ENT_HTML5),
+                'summary' => htmlspecialchars($summary, \ENT_COMPAT | \ENT_HTML5),
                 'url' => $this->generateUrl('blog_post', ['slug' => $post->getSlug()]),
             ];
         }

src/Controller/BlogController.php

@@ -68,7 +68,10 @@ public function changePassword(
         $form->handleRequest($request);
 
         if ($form->isSubmitted() && $form->isValid()) {
-            $user->setPassword($passwordHasher->hashPassword($user, $form->get('newPassword')->getData()));
+            /** @var string $plainPassword */
+            $plainPassword = $form->get('newPassword')->getData();
+
+            $user->setPassword($passwordHasher->hashPassword($user, $plainPassword));
             $entityManager->flush();
 
             return $this->redirectToRoute('security_logout');

src/Controller/UserController.php

@@ -18,6 +18,7 @@
 use Doctrine\Bundle\FixturesBundle\Fixture;
 use Doctrine\Persistence\ObjectManager;
 use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
+use Symfony\Component\String\AbstractUnicodeString;
 use Symfony\Component\String\Slugger\SluggerInterface;
 use function Symfony\Component\String\u;
 
@@ -67,6 +68,8 @@ private function loadTags(ObjectManager $manager): void
 
     private function loadPosts(ObjectManager $manager): void
     {
+        /** @var User $author */
+        /** @var array<Tag> $tags */
         foreach ($this->getPostData() as [$title, $slug, $summary, $content, $publishedAt, $author, $tags]) {
             $post = new Post();
             $post->setTitle($title);
@@ -78,8 +81,11 @@ private function loadPosts(ObjectManager $manager): void
             $post->addTag(...$tags);
 
             foreach (range(1, 5) as $i) {
+                /** @var User $commentAuthor */
+                $commentAuthor = $this->getReference('john_user');
+
                 $comment = new Comment();
-                $comment->setAuthor($this->getReference('john_user'));
+                $comment->setAuthor($commentAuthor);
                 $comment->setContent($this->getRandomText(random_int(255, 512)));
                 $comment->setPublishedAt(new \DateTime('now + '.$i.'seconds'));
 
@@ -92,6 +98,9 @@ private function loadPosts(ObjectManager $manager): void
         $manager->flush();
     }
 
+    /**
+     * @return array<array{string, string, string, string, array<string>}>
+     */
     private function getUserData(): array
     {
         return [
@@ -102,6 +111,9 @@ private function getUserData(): array
         ];
     }
 
+    /**
+     * @return string[]
+     */
     private function getTagData(): array
     {
         return [
@@ -117,6 +129,11 @@ private function getTagData(): array
         ];
     }
 
+    /**
+     * @throws \Exception
+     *
+     * @return array<int, array{0: string, 1: AbstractUnicodeString, 2: string, 3: string, 4: \DateTime, 5: object, 6: array<object>}>
+     */
     private function getPostData(): array
     {
         $posts = [];
@@ -137,6 +154,9 @@ private function getPostData(): array
         return $posts;
     }
 
+    /**
+     * @return string[]
+     */
     private function getPhrases(): array
     {
         return [
@@ -226,6 +246,11 @@ private function getPostContent(): string
             MARKDOWN;
     }
 
+    /**
+     * @throws \Exception
+     *
+     * @return array<object>
+     */
     private function getRandomTags(): array
     {
         $tagNames = $this->getTagData();

src/DataFixtures/AppFixtures.php

@@ -66,14 +66,14 @@ class Post
     private ?User $author = null;
 
     /**
-     * @var Comment[]|Collection
+     * @var Collection<int, Comment>
      */
     #[ORM\OneToMany(targetEntity: Comment::class, mappedBy: 'post', orphanRemoval: true, cascade: ['persist'])]
     #[ORM\OrderBy(['publishedAt' => 'DESC'])]
     private Collection $comments;
 
     /**
-     * @var Tag[]|Collection
+     * @var Collection<int, Tag>
      */
     #[ORM\ManyToMany(targetEntity: Tag::class, cascade: ['persist'])]
     #[ORM\JoinTable(name: 'symfony_demo_post_tag')]
@@ -143,6 +143,9 @@ public function setAuthor(User $author): void
         $this->author = $author;
     }
 
+    /**
+     * @return Collection<int, Comment>
+     */
     public function getComments(): Collection
     {
         return $this->comments;
@@ -185,6 +188,9 @@ public function removeTag(Tag $tag): void
         $this->tags->removeElement($tag);
     }
 
+    /**
+     * @return Collection<int, Tag>
+     */
     public function getTags(): Collection
     {
         return $this->tags;