feature #4583 Phpdoc to param type fixer rebase (jg-development)

This PR was merged into the 2.16-dev branch.

Discussion
----------

Phpdoc to param type fixer rebase

Commits
-------

2f959ab PhpdocToParamTypeFixer - introduction

README.rst

@@ -1622,6 +1622,18 @@ Choose from the list of available rules:
 
   Docblocks should only be used on structural elements.
 
+* **phpdoc_to_param_type**
+
+  EXPERIMENTAL: Takes ``@param`` annotations of non-mixed types and adjusts
+  accordingly the function signature. Requires PHP >= 7.0.
+
+  *Risky rule: [1] This rule is EXPERIMENTAL and is not covered with backward compatibility promise. [2] ``@param`` annotation is mandatory for the fixer to make changes, signatures of methods without it (no docblock, inheritdocs) will not be fixed. [3] Manual actions are required if inherited signatures are not properly documented.*
+
+  Configuration options:
+
+  - ``scalar_types`` (``bool``): fix also scalar types; may have unexpected
+    behaviour due to PHP bad type coercion system; defaults to ``true``
+
 * **phpdoc_to_return_type**
 
   EXPERIMENTAL: Takes ``@return`` annotation of non-mixed types and adjusts

src/DocBlock/Annotation.php

@@ -36,7 +36,7 @@ class Annotation
     (?<types>
         (?<type>
             (?<array>
-                (?&simple)\[\]
+                (?&simple)(\[\])*
             )
             |
             (?<simple>