Allow omitting useless @param and @return docblocks

If PHP type declarations can be used to describe the type of a parameter or return value, we shouldn't have to duplicate this in a docblock annotation.

Author: nicwortel

src/LEVIY/ruleset.xml

@@ -162,6 +162,7 @@
     </rule>
     <rule ref="Symfony.Commenting.FunctionComment">
         <exclude name="Symfony.Commenting.FunctionComment.MissingParamComment"/>
+        <exclude name="Symfony.Commenting.FunctionComment.ParamNameNoMatch"/>
         <exclude name="Symfony.Commenting.FunctionComment.SpacingAfterParamName"/>
     </rule>
     <rule ref="Symfony.Formatting.BlankLineBeforeReturn"/>

tests/correct/annotations.php

@@ -7,3 +7,17 @@
 function allUsefulAnnotationsAreAllowed(): void
 {
 }
+
+/**
+ * @param int[] $numbers
+ */
+function omittingUselessReturnAnnotationsIsAllowed(array $numbers): void
+{
+}
+
+/**
+ * @param int[] $numbers
+ */
+function omittingUselessParamAnnotationsIsAllowed(string $string, int $int, array $numbers, bool $bool): void
+{
+}