[PropertyAccess] Allow usage of wildcard [*]

[Brajk19]

Q	A
Branch?	7.1
Bug fix?	no
New feature?	yes
Deprecations?	yes
Issues
License	MIT

This feature allows usage of wildcards to read values from multiple arrays/objects.

Examples:

$persons = [
    [
        'first_name' => 'Wouter',
    ],
    [
        'first_name' => 'Ryan',
    ],
];

var_dump($propertyAccessor->getValue($persons, '[*][first_name]')); // ['Wouter', 'Ryan']

$persons = [
    [
        'first_name' => 'Wouter',
        'pets' => ['Tom', 'Jerry']
    ],
    [
        'first_name' => 'Ryan',
        'pets' => ['Garfield']
    ],
];

var_dump($propertyAccessor->getValue($persons, '[*][pets]')); // ['Tom', 'Jerry', 'Garfield']

$persons = [
    [
        'first_name' => 'Wouter',
        'pets' => [
            'cats' => ['Tom', 'Garfield'],
            'mouses' => ['Jerry']
        ]
    ],
    [
        'first_name' => 'Ryan',
        'pets' => [
            'cats' => ['Sylvester', 'Felix'],
            'mouses' => ['Speedy Gonzales']
        ]
    ],
];

var_dump($propertyAccessor->getValue($persons, '[*][pets][mouses]')); // ['Jerry', 'Speedy Gonzales']

$persons = [
    [
        'first_name' => 'Wouter',
        'pets' => [
            [
                'name' => 'Tom',
                'type' => 'cat',
            ],
            [
                'name' => 'Garfield',
                'type' => 'cat',
            ],
            [
                'name' => 'Jerry',
                'type' => 'mouse',
            ]
        ]
    ],
    [
        'first_name' => 'Ryan',
        'pets' => [
            [
                'name' => 'Sylvester',
                'type' => 'cat',
            ],
            [
                'name' => 'Felix',
                'type' => 'cat',
            ],
            [
                'name' => 'Speedy Gonzales',
                'type' => 'mouse',
            ]
        ]
    ],
];
var_dump($propertyAccessor->getValue($persons, '[*][pets][*][name]')); // ['Tom', 'Garfield', 'Jerry', 'Sylvester', 'Felix', 'Speedy Gonzales']
var_dump($propertyAccessor->getValue($persons, '[*][pets][*][type]')); // ['cat', 'cat', 'mouse', 'cat', 'cat', 'mouse']
var_dump($propertyAccessor->getValue($persons, '[0][pets][*][*]')); // ['Tom', 'cat', 'Garfield', 'cat', 'Jerry', 'mouse']

More examples in PropertyAccessorWildcardTest.

If there is * key in array it should be accesed with [\*]

How does it work?
Whenever [*] is detected, it is replaced with all possible values:

• 1st example: [*][first_name] becomes [0][first_name] and [1][first_name]
• readPropertiesUntil is then recursively called for each of them whenever wildcard is detected
• returned paths from each of them are merged together

Notes:

• public function isWildcard(int $index): bool should be added to PropertyPathInterface in next major version
• currently deprecation is triggered when method does not exists in class implementing that interface