Add compatibility with named parameters and constructor property promotion

[beberlei]

With PHP 8 the combination of named parameters and constructor property
promotion will be very cool for the new Attributes feature, but also for
Doctrine's Annotation feature. Especially if classes are to be used
for both Attributes and Annotations, then the DocParser needs
a compatible support for named parameters in annotation class constructors.

For backwards compatibility this is done with a marker interface that
uses a different instantiation logic than the current one. Currently
all annotations properties are passed as a single array argument
$values.

This patch uses reflection to match annotation values to class
constructor parameters. For PHP 8 the integration of named arguments
with spread operator is used.

A PHP 8 class that could be read using Doctrine Annotations would
become:

/** @Annotation */
class Table implements NamedArgumentConstructorAnnotation
{
    public function __construct(
        public string $name,
        public array $indexes = []
    ) {}
}
/** @Table(name="users") */
/** @Table(name="users", indexes={"foo"}) */

[greg0ire]

I think this should target master, since it's not a bugfix.
Also, should docs be added regarding the new feature and how to migrate to it?

Didn't mean to approve, sorry.

[greg0ire]

I think this should target master, since it's not a bugfix.
Also, should docs be added regarding the new feature and how to migrate to it?

[greg0ire]

Should constructor property promotion really be mentioned here? You did not write a test for it, so I believe this means it does not really come into play here: it will work the same regardless of whether you use that feature or not.

[beberlei]

@greg0ire right, rebased on master. I will document this as soon as we decide that this makes sense.