Add support for asymmetric visibility for properties

[thekid]

Example

Given the following:

use lang\Reflection;

class Person {
  public private(set) string $name= 'Test';
}
 
$property= Reflection::type(Person::class)->property('name');

The modifiers class includes private(set) and protected(set) support:

$property->modifiers(); // lang.reflect.Modifiers<public private(set)>

The isPublic(), isProtected() and isPrivate() methods optionally support "get" or "set":

$property->modifiers()->isPublic('get');  // true
$property->modifiers()->isPrivate('set'); // true

The modifiers() method can be used with "get" or "set" to produce views on the respective visibility:

$property->modifiers('get')->isPublic();  // true
$property->modifiers('set')->isPrivate(); // true

Tests

The following configurations have run all unit tests successfully:

• All of PHP 7.4 - current PHP 8.3 on GitHub
• PHP compiled with PR [RFC] Asymmetric visibility v2 php/php-src#15063 applied (PHP 8.4.0-dev (cli) (built: Aug 25 2024 09:42:45) (NTS))

See also

• https://wiki.php.net/rfc/asymmetric-visibility-v2
• Add emitting support for asymmetric visibility compiler#183 (comment)

[thekid]

Here's the modifiers as returned by ReflectionProperty::getModifiers() in PHP 8.4 compiled from php/php-src#15063:

Declaration	Modifiers	Comment
class T { public int $prop; }	0x0001	1️⃣
class T { public public(set) int $prop; }	0x0001	2️⃣
class T { protected protected(set) int $prop; }	0x0002	2️⃣
class T { private private(set) int $prop; }	0x0004	2️⃣
class T { public protected(set) int $prop; }	0x0801
class T { public private(set) int $prop; }	0x1001
class T { proteced private(set) int $prop; }	0x1002

1️⃣ - For comparison with the next line
2️⃣ - Note that if get and set visibilities are the same, the set bit is emitted

[thekid]

This can be replaced by #[Runtime(version: '>=8.4')] once the PR is merged.

[thekid]

Released in https://github.com/xp-framework/reflection/releases/tag/v3.2.0

[thekid]

Backported to https://github.com/xp-framework/reflection/releases/tag/v2.15.0