gen_stub.php: ignore variadic parameter in `@param` doc comment annotation

[mitelg]

Description

The following class stub code:

<?php

class Foo
{
    /**
     * @param string ...$args This does not work
     */
    public function bar(string ...$args): void;
}

Executed with sudo php /usr/lib/php/20250925/build/gen_stub.php foo.stub.php
Resulted in this output:

In foo.stub.php:
Foo::bar(): @param doesn't contain a variable name or has an invalid format "string ...$args This does not work"

But I expected this output instead:
normal gen_stub.php output

Imo, the variadic syntax should be supported, as this is the way how also PHPStorm is writing it in the PHPDoc

PHP Version

PHP 8.5.0RC1 (cli) (built: Oct  1 2025 20:34:09) (NTS)
Copyright (c) The PHP Group
Built by Debian
Zend Engine v4.5.0RC1, Copyright (c) Zend Technologies
    with Zend OPcache v8.5.0RC1, Copyright (c), by Zend Technologies

But all older versions also do not accept variadic parameters

[iluuu1994]

/cc @kocsismate @DanielEScherzer

[TimWolla]

I don't see an issue here. The PHPDoc comment can just be removed, since it is redundant with the actual type signature. Generally speaking the stub generator only supports the syntax it can make use of itself.

[mitelg]

Sure, no issue if the PHPDoc just duplicates the type, but if you want to explain your arguments with further text, it is an issue 🙂

[iluuu1994]

@mitelg Do you necessarily need to document with docblocks in this file? gen_stub.php is used as an internal tool to simplify core and extension development, but it's not intended to be fully syntax-compatible with PHP code.

Patches are welcome, as long as they are reasonably straight-forward.

[mitelg]

@iluuu1994 I recently made an improvement to the redis extension stubs phpredis/phpredis#2737

most of the method parameters have additional explanation in the PHPDoc and so the variadic parameters. Omitting them would be a not so good idea as information would be lost.

We decided to just omit the ... for now. But it would be nice, if someone would tackle this 🙂

I understand that this has no high prio and that is totally fine for me. I just wanted to bring this to the table. I really would like to try a patch, but I have barely C knowledge and would not even know where to start here 🙈

[Girgias]

@iluuu1994 I recently made an improvement to the redis extension stubs phpredis/phpredis#2737

most of the method parameters have additional explanation in the PHPDoc and so the variadic parameters. Omitting them would be a not so good idea as information would be lost.

We decided to just omit the ... for now. But it would be nice, if someone would tackle this 🙂

I understand that this has no high prio and that is totally fine for me. I just wanted to bring this to the table. I really would like to try a patch, but I have barely C knowledge and would not even know where to start here 🙈

gen_stub.php is a PHP file and a PHP script that generates C headers. If you just want for something to be ignored by the parser, I don't see why you would need any C knowledge?