PrivatesAccessor.php

<?php

declare(strict_types=1);

namespace Rector\Util\Reflection;

use Rector\Exception\Reflection\MissingPrivatePropertyException;
use ReflectionClass;
use ReflectionMethod;
use ReflectionProperty;

/**
 * @see \Rector\Tests\Util\Reflection\PrivatesAccessorTest
 */
final class PrivatesAccessor
{
    /**
     * @param callable(mixed $value): mixed $closure
     */
    public function propertyClosure(object $object, string $propertyName, callable $closure): void
    {
        $property = $this->getPrivateProperty($object, $propertyName);

        // modify value
        $property = $closure($property);

        $this->setPrivateProperty($object, $propertyName, $property);
    }

    /**
     * @param object|class-string $object
     * @param mixed[] $arguments
     * @api
     */
    public function callPrivateMethod(object|string $object, string $methodName, array $arguments): mixed
    {
        if (is_string($object)) {
            $reflectionClass = new ReflectionClass($object);
            $object = $reflectionClass->newInstanceWithoutConstructor();
        }

        $reflectionMethod = $this->createAccessibleMethodReflection($object, $methodName);

        return $reflectionMethod->invokeArgs($object, $arguments);
    }

    public function getPrivateProperty(object $object, string $propertyName): mixed
    {
        $reflectionProperty = $this->resolvePropertyReflection($object, $propertyName);

        return $reflectionProperty->getValue($object);
    }

    public function setPrivateProperty(object $object, string $propertyName, mixed $value): void
    {
        $reflectionProperty = $this->resolvePropertyReflection($object, $propertyName);

        $reflectionProperty->setValue($object, $value);
    }

    private function createAccessibleMethodReflection(object $object, string $methodName): ReflectionMethod
    {
        return new ReflectionMethod($object, $methodName);
    }

    private function resolvePropertyReflection(object $object, string $propertyName): ReflectionProperty
    {
        if (property_exists($object, $propertyName)) {
            return new ReflectionProperty($object, $propertyName);
        }

        $parentClass = get_parent_class($object);
        if ($parentClass !== false) {
            return new ReflectionProperty($parentClass, $propertyName);
        }

        $errorMessage = sprintf('Property "$%s" was not found in "%s" class', $propertyName, $object::class);
        throw new MissingPrivatePropertyException($errorMessage);
    }
}