Subversion-Projekte lars-tiefland.laravel_shop

<?php

/*

 * This file is part of Psy Shell.

 *

 * (c) 2012-2023 Justin Hileman

 *

 * For the full copyright and license information, please view the LICENSE

 * file that was distributed with this source code.

 */

namespace Psy;

/**

 * Helpers for bypassing visibility restrictions, mostly used in code generated

 * by the `sudo` command.

 */

class Sudo

{

    /**

     * Fetch a property of an object, bypassing visibility restrictions.

     *

     * @param object $object

     * @param string $property property name

     *

     * @return mixed Value of $object->property

     */

    public static function fetchProperty($object, string $property)

    {

        $prop = self::getProperty(new \ReflectionObject($object), $property);

        return $prop->getValue($object);

    }

    /**

     * Assign the value of a property of an object, bypassing visibility restrictions.

     *

     * @param object $object

     * @param string $property property name

     * @param mixed  $value

     *

     * @return mixed Value of $object->property

     */

    public static function assignProperty($object, string $property, $value)

    {

        $prop = self::getProperty(new \ReflectionObject($object), $property);

        $prop->setValue($object, $value);

        return $value;

    }

    /**

     * Call a method on an object, bypassing visibility restrictions.

     *

     * @param object $object

     * @param string $method  method name

     * @param mixed  $args...

     *

     * @return mixed

     */

    public static function callMethod($object, string $method, ...$args)

    {

        $refl = new \ReflectionObject($object);

        $reflMethod = $refl->getMethod($method);

        $reflMethod->setAccessible(true);

        return $reflMethod->invokeArgs($object, $args);

    }

    /**

     * Fetch a property of a class, bypassing visibility restrictions.

     *

     * @param string|object $class    class name or instance

     * @param string        $property property name

     *

     * @return mixed Value of $class::$property

     */

    public static function fetchStaticProperty($class, string $property)

    {

        $prop = self::getProperty(new \ReflectionClass($class), $property);

        $prop->setAccessible(true);

        return $prop->getValue();

    }

    /**

     * Assign the value of a static property of a class, bypassing visibility restrictions.

     *

     * @param string|object $class    class name or instance

     * @param string        $property property name

     * @param mixed         $value

     *

     * @return mixed Value of $class::$property

     */

    public static function assignStaticProperty($class, string $property, $value)

    {

        $prop = self::getProperty(new \ReflectionClass($class), $property);

        $prop->setValue($value);

        return $value;

    }

    /**

     * Call a static method on a class, bypassing visibility restrictions.

     *

     * @param string|object $class   class name or instance

     * @param string        $method  method name

     * @param mixed         $args...

     *

     * @return mixed

     */

    public static function callStatic($class, string $method, ...$args)

    {

        $refl = new \ReflectionClass($class);

        $reflMethod = $refl->getMethod($method);

        $reflMethod->setAccessible(true);

        return $reflMethod->invokeArgs(null, $args);

    }

    /**

     * Fetch a class constant, bypassing visibility restrictions.

     *

     * @param string|object $class class name or instance

     * @param string        $const constant name

     *

     * @return mixed

     */

    public static function fetchClassConst($class, string $const)

    {

        $refl = new \ReflectionClass($class);

        do {

            if ($refl->hasConstant($const)) {

                return $refl->getConstant($const);

            }

            $refl = $refl->getParentClass();

        } while ($refl !== false);

        return false;

    }

    /**

     * Construct an instance of a class, bypassing private constructors.

     *

     * @param string $class   class name

     * @param mixed  $args...

     */

    public static function newInstance(string $class, ...$args)

    {

        $refl = new \ReflectionClass($class);

        $instance = $refl->newInstanceWithoutConstructor();

        $constructor = $refl->getConstructor();

        $constructor->setAccessible(true);

        $constructor->invokeArgs($instance, $args);

        return $instance;

    }

    /**

     * Get a ReflectionProperty from an object (or its parent classes).

     *

     * @throws \ReflectionException if neither the object nor any of its parents has this property

     *

     * @param \ReflectionClass $refl

     * @param string           $property property name

     *

     * @return \ReflectionProperty

     */

    private static function getProperty(\ReflectionClass $refl, string $property): \ReflectionProperty

    {

        $firstException = null;

        do {

            try {

                $prop = $refl->getProperty($property);

                $prop->setAccessible(true);

                return $prop;

            } catch (\ReflectionException $e) {

                if ($firstException === null) {

                    $firstException = $e;

                }

                $refl = $refl->getParentClass();

            }

        } while ($refl !== false);

        throw $firstException;

    }

}