Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:130123
Content-Type: text/plain;
	charset=us-ascii
Content-Transfer-Encoding: quoted-printable
Precedence: list
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3864.400.21\))
Subject: Re: [PHP-DEV] [RFC] DocComments For Function Parameters
Date: Sat, 21 Feb 2026 20:46:17 +0100
References: <24229A82-F5BF-48F2-9E6C-FE45A99FB9E9@cschneid.com>
 <CAJp_myVf0=Sk1eWHxAHbi6jSNiqyrd=ODkauY6++mnPWguHepw@mail.gmail.com>
To: PHP Developers Mailing List <internals@lists.php.net>
In-Reply-To: <CAJp_myVf0=Sk1eWHxAHbi6jSNiqyrd=ODkauY6++mnPWguHepw@mail.gmail.com>
Message-ID: <673FE008-CBE9-43B0-B339-A2184E3195FB@cschneid.com>
From: cschneid@cschneid.com (Christian Schneider)

Am 21.02.2026 um 19:41 schrieb Matthew Weier O'Phinney =
<mweierophinney@gmail.com>:
> - Would it also support the comment appearing before the parameter?
>=20
>     /** This is the description */
>     string $message,

Yes, this works.

> - If so, what would be the behavior of the engine if a docblock was =
present in both positions, like:
>=20
>     /** This is the description */
>     $message
>     /** But what about this? */,

The last DocComment wins, the same as for the current

class A
{
    /** a */ public /** b */ int /** c */ $property /** d */;
}

echo (new ReflectionClass('A'))->getProperties()[0]->getDocComment();

This outputs the last one (/** d */), see https://3v4l.org/PZFHD

Regards,
- Chris