Add variadic (...) support

- Update the collector to save the variadic information
- Update the html rendering
- Add test case (tests/data/issue344)

Close #344

Author: MacFJA

src/collector/backend/parser/UnitCollectingVisitor.php

@@ -324,6 +324,7 @@ private function processMethodParams(MethodObject $method, array $params): void
             /** @var $param \PhpParser\Node\Param */
             $parameter = $method->addParameter($param->var->name);
             $parameter->setByReference($param->byRef);
+            $parameter->setVariadic($param->variadic);
             $this->setVariableType($parameter, $param->type);
             $this->setVariableDefaultValue($parameter, $param->default);
         }

src/collector/project/AbstractVariableObject.php

@@ -86,6 +86,10 @@ public function getType(): string {
         return $this->ctx->getAttribute('type');
     }
 
+    public function setVariadic($isVariadic): void {
+        $this->ctx->setAttribute('variadic', $isVariadic ? 'true' : 'false');
+    }
+
     public function setNullable($isNullable): void {
         $this->ctx->setAttribute('nullable', $isNullable ? 'true' : 'false');
     }

templates/html/method.xsl

@@ -168,6 +168,7 @@
                     </xsl:when>
                     <xsl:otherwise><xsl:value-of select="@type" /></xsl:otherwise>
                 </xsl:choose>
+                <xsl:if test="$param/@variadic = 'true'">[]</xsl:if>
                 </dt>
                 <dd><xsl:value-of select="$docparam/@description" />
                     <xsl:if test="$docparam/text() != ''">
@@ -218,6 +219,7 @@
             </xsl:otherwise>
         </xsl:choose>
         <xsl:if test="$param/@byreference = 'true'">&amp;</xsl:if>
+        <xsl:if test="$param/@variadic = 'true'">...</xsl:if>
         $<xsl:value-of select="$param/@name" />
         <xsl:if test="$param/@default"> = <xsl:choose>
             <xsl:when test="$param/@default = ''"><xsl:value-of select="$param/@constant" /></xsl:when>

tests/data/issue344/src/test.php

@@ -0,0 +1,9 @@
+<?php
+
+class VariadicClass {
+
+    function f(string ...$segments) {
+        // ...
+    }
+
+}

tests/data/issue344/test.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<phpdox xmlns="http://xml.phpdox.net/config" silent="false">
+
+    <project name="phpDox-issue" source="${basedir}/src" workdir="${basedir}/xml">
+
+        <collector publiconly="false" backend="parser" />
+
+        <generator output="${basedir}/docs">
+            <build engine="html" enabled="true" output="html" />
+            <build engine="xml" enabled="true" output="xml" />
+        </generator>
+
+    </project>
+
+</phpdox>