AbstractEnum

38abstract class AbstractEnum implements JsonSerializable39{40    /**41     * @var string The value of the enum instance.42     */43    private string $value;44    /**45     * @var string The name of the enum constant.46     */47    private string $name;48    /**49     * @var array<string, array<string, string>> Cache for reflection data.50     */51    private static array $cache = [];52    /**53     * @var array<string, array<string, self>> Cache for enum instances.54     */55    private static array $instances = [];56    /**57     * Constructor is private to ensure instances are created through static methods.58     *59     * @since 0.1.060     *61     * @param string $value The enum value.62     * @param string $name The constant name.63     */64    final private function __construct(string $value, string $name)65    {66        $this->value = $value;67        $this->name = $name;68    }69    /**70     * Provides read-only access to properties.71     *72     * @since 0.1.073     *74     * @param string $property The property name.75     * @return mixed The property value.76     * @throws BadMethodCallException If property doesn't exist.77     */78    final public function __get(string $property)79    {80        if ($property === 'value' || $property === 'name') {81            return $this->{$property};82        }83        throw new BadMethodCallException(sprintf('Property %s::%s does not exist', static::class, $property));84    }85    /**86     * Prevents property modification.87     *88     * @since 0.1.089     *90     * @param string $property The property name.91     * @param mixed $value The value to set.92     * @throws BadMethodCallException Always, as enum properties are read-only.93     */94    final public function __set(string $property, $value): void95    {96        throw new BadMethodCallException(sprintf('Cannot modify property %s::%s - enum properties are read-only', static::class, $property));97    }98    /**99     * Creates an enum instance from a value, throws exception if invalid.100     *101     * @since 0.1.0102     *103     * @param string $value The enum value.104     * @return static The enum instance.105     * @throws InvalidArgumentException If the value is not valid.106     */107    final public static function from(string $value): self108    {109        $instance = self::tryFrom($value);110        if ($instance === null) {111            throw new InvalidArgumentException(sprintf('%s is not a valid backing value for enum %s', $value, static::class));112        }113        return $instance;114    }115    /**116     * Tries to create an enum instance from a value, returns null if invalid.117     *