File::getMethodParameters(): add test documenting behaviour for comments

This test demonstrates and documents the existing behaviour of the method when comments are encountered within a parameter declaration.

Author: jrfnl

tests/Core/File/GetMethodParametersTest.inc

@@ -120,3 +120,9 @@ abstract class ConstructorPropertyPromotionAbstractMethod {
     // 3. The callable type is not supported for properties, but that's not the concern of this method.
     abstract public function __construct(public callable $y, private ...$x);
 }
+
+/* testCommentsInParameter */
+function commentsInParams(
+    // Leading comment.
+    ?MyClass /*-*/ & /*-*/.../*-*/ $param /*-*/ = /*-*/ 'default value' . /*-*/ 'second part' // Trailing comment.
+) {}

tests/Core/File/GetMethodParametersTest.php

@@ -818,6 +818,29 @@ public function testPHP8ConstructorPropertyPromotionAbstractMethod()
     }//end testPHP8ConstructorPropertyPromotionAbstractMethod()
 
 
+    /**
+     * Verify and document behaviour when there are comments within a parameter declaration.
+     *
+     * @return void
+     */
+    public function testCommentsInParameter()
+    {
+        $expected    = [];
+        $expected[0] = [
+            'name'              => '$param',
+            'content'           => '// Leading comment.
+    ?MyClass /*-*/ & /*-*/.../*-*/ $param /*-*/ = /*-*/ \'default value\' . /*-*/ \'second part\' // Trailing comment.',
+            'pass_by_reference' => true,
+            'variable_length'   => true,
+            'type_hint'         => '?MyClass',
+            'nullable_type'     => true,
+        ];
+
+        $this->getMethodParametersTestHelper('/* '.__FUNCTION__.' */', $expected);
+
+    }//end testCommentsInParameter()
+
+
     /**
      * Test helper.
      *