hgraca / explicit-architecture-php

src/Core/Component/Blog/Application/Query/DQL/FindLatestPostsQuery.php

Doc Comments +1 added lines, -1 removed lines

@@ -54,7 +54,7 @@
      * to code readability.
      * However, by using `__invoke()` we lose code completion, so in the end I prefer to use this `execute()` method.
      *
-     * @return LatestPostWithAuthorAndTagsDto[]
+     * @return ResultCollectionInterface
      */
     public function execute(int $limit = self::NUM_ITEMS): ResultCollectionInterface
     {

src/Core/Component/Blog/Application/Query/DQL/FindPostsBySearchRequestQuery.php

Doc Comments +1 added lines, -1 removed lines

@@ -46,7 +46,7 @@
     /**
      * @throws \Exception
      *
-     * @return PostsBySearchRequestDto[]
+     * @return ResultCollectionInterface
      */
     public function execute(string $queryString, int $limit = self::NUM_ITEMS): ResultCollectionInterface
     {

src/Core/Component/User/Application/Repository/DQL/UserRepository.php

Doc Comments +1 added lines, -1 removed lines

@@ -71,7 +71,7 @@
     }
 
     /**
-     * @return User[]
+     * @return ResultCollectionInterface
      */
     public function findAll(array $orderByList = ['id' => 'DESC'], int $maxResults = null): ResultCollectionInterface
     {

src/Core/Port/Persistence/DQL/DqlQueryBuilderInterface.php

Doc Comments +3 added lines, -5 removed lines

@@ -55,7 +55,7 @@ 
      *         ->leftJoin('u.Phonenumbers', 'p');
      * </code>
      *
-     * @param string $select the selection expressions
+     * @param string[] $select the selection expressions
      */
     public function select(string ...$select): self;
 
@@ -84,7 +84,7 @@ 
      *         ->leftJoin('u.Phonenumbers', 'p');
      * </code>
      *
-     * @param string $select the selection expression
+     * @param string[] $select the selection expression
      */
     public function addSelect(string ...$select): self;
 
@@ -251,7 +251,7 @@ 
      *         ->where('u.id = ?');
      * </code>
      *
-     * @param mixed $predicates the restriction predicates
+     * @param string $predicates the restriction predicates
      */
     public function where(string $predicates): self;
 
@@ -267,7 +267,6 @@ 
      *         ->andWhere('u.is_active = 1');
      * </code>
      *
-     * @param mixed $where The query restrictions.*
      *
      * @see where()
      */
@@ -285,7 +284,6 @@ 
      *         ->orWhere('u.id = 2');
      * </code>
      *
-     * @param mixed $where The WHERE statement.*
      *
      * @see where()
      */

src/Infrastructure/TemplateEngine/Twig/Extension/SourceCode/SourceCodeExtension.php

Doc Comments +3 added lines

@@ -37,6 +37,9 @@
      */
     private $controller;
 
+    /**
+     * @param callable $controller
+     */
     public function setController(?callable $controller): void
     {
         $this->controller = $controller;

src/Core/Component/Blog/Application/Repository/DQL/CommentRepository.php

Doc Comments +1 added lines, -1 removed lines

@@ -42,7 +42,7 @@
     }
 
     /**
-     * @return Comment[]
+     * @return ResultCollectionInterface
      */
     public function findAllByPostId(
         PostId $postId,

src/Core/Component/Blog/Application/Repository/DQL/PostRepository.php

Doc Comments +2 added lines, -2 removed lines

@@ -62,7 +62,7 @@ 
     }
 
     /**
-     * @return Post[]
+     * @return ResultCollectionInterface
      */
     public function findAll(array $orderByList = ['id' => 'DESC'], int $maxResults = null): ResultCollectionInterface
     {
@@ -80,7 +80,7 @@ 
     }
 
     /**
-     * @return Post[]
+     * @return ResultCollectionInterface
      */
     public function findAllByUserId(
         UserId $userId,

src/Core/Component/Blog/Application/Repository/DQL/TagRepository.php

Doc Comments +1 added lines, -1 removed lines

@@ -45,7 +45,7 @@
     }
 
     /**
-     * @return Tag[]
+     * @return ResultCollectionInterface
      */
     public function findAllByPostId(
         PostId $postId,

src/Core/Component/Blog/Domain/Post/Post.php

Doc Comments +4 added lines

@@ -272,6 +272,9 @@ 
             : $this->tags->clear();
     }
 
+    /**
+     * @param Comment[] $list
+     */
     private function contains($item, $list): bool
     {
         // we need to cast the list to array because it might just actually be a doctrine collection
@@ -279,6 +282,7 @@ 
     }
 
     /**
+     * @param Comment[] $list
      * @return false|int|string
      */
     private function getKey($item, $list)