Chris@13: <?php
Chris@13: 
Chris@13: /*
Chris@13:  * This file is part of Psy Shell.
Chris@13:  *
Chris@13:  * (c) 2012-2018 Justin Hileman
Chris@13:  *
Chris@13:  * For the full copyright and license information, please view the LICENSE
Chris@13:  * file that was distributed with this source code.
Chris@13:  */
Chris@13: 
Chris@13: namespace Psy;
Chris@13: 
Chris@13: /**
Chris@13:  * Helpers for bypassing visibility restrictions, mostly used in code generated
Chris@13:  * by the `sudo` command.
Chris@13:  */
Chris@13: class Sudo
Chris@13: {
Chris@13:     /**
Chris@13:      * Fetch a property of an object, bypassing visibility restrictions.
Chris@13:      *
Chris@13:      * @param object $object
Chris@13:      * @param string $property property name
Chris@13:      *
Chris@13:      * @return mixed Value of $object->property
Chris@13:      */
Chris@13:     public static function fetchProperty($object, $property)
Chris@13:     {
Chris@13:         $refl = new \ReflectionObject($object);
Chris@13:         $prop = $refl->getProperty($property);
Chris@13:         $prop->setAccessible(true);
Chris@13: 
Chris@13:         return $prop->getValue($object);
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Assign the value of a property of an object, bypassing visibility restrictions.
Chris@13:      *
Chris@13:      * @param object $object
Chris@13:      * @param string $property property name
Chris@13:      * @param mixed  $value
Chris@13:      *
Chris@13:      * @return mixed Value of $object->property
Chris@13:      */
Chris@13:     public static function assignProperty($object, $property, $value)
Chris@13:     {
Chris@13:         $refl = new \ReflectionObject($object);
Chris@13:         $prop = $refl->getProperty($property);
Chris@13:         $prop->setAccessible(true);
Chris@13:         $prop->setValue($object, $value);
Chris@13: 
Chris@13:         return $value;
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Call a method on an object, bypassing visibility restrictions.
Chris@13:      *
Chris@13:      * @param object $object
Chris@13:      * @param string $method  method name
Chris@13:      * @param mixed  $args...
Chris@13:      *
Chris@13:      * @return mixed
Chris@13:      */
Chris@13:     public static function callMethod($object, $method, $args = null)
Chris@13:     {
Chris@17:         $args   = \func_get_args();
Chris@17:         $object = \array_shift($args);
Chris@17:         $method = \array_shift($args);
Chris@13: 
Chris@13:         $refl = new \ReflectionObject($object);
Chris@13:         $reflMethod = $refl->getMethod($method);
Chris@13:         $reflMethod->setAccessible(true);
Chris@13: 
Chris@13:         return $reflMethod->invokeArgs($object, $args);
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Fetch a property of a class, bypassing visibility restrictions.
Chris@13:      *
Chris@13:      * @param string|object $class    class name or instance
Chris@13:      * @param string        $property property name
Chris@13:      *
Chris@13:      * @return mixed Value of $class::$property
Chris@13:      */
Chris@13:     public static function fetchStaticProperty($class, $property)
Chris@13:     {
Chris@13:         $refl = new \ReflectionClass($class);
Chris@13:         $prop = $refl->getProperty($property);
Chris@13:         $prop->setAccessible(true);
Chris@13: 
Chris@13:         return $prop->getValue();
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Assign the value of a static property of a class, bypassing visibility restrictions.
Chris@13:      *
Chris@13:      * @param string|object $class    class name or instance
Chris@13:      * @param string        $property property name
Chris@13:      * @param mixed         $value
Chris@13:      *
Chris@13:      * @return mixed Value of $class::$property
Chris@13:      */
Chris@13:     public static function assignStaticProperty($class, $property, $value)
Chris@13:     {
Chris@13:         $refl = new \ReflectionClass($class);
Chris@13:         $prop = $refl->getProperty($property);
Chris@13:         $prop->setAccessible(true);
Chris@13:         $prop->setValue($value);
Chris@13: 
Chris@13:         return $value;
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Call a static method on a class, bypassing visibility restrictions.
Chris@13:      *
Chris@13:      * @param string|object $class   class name or instance
Chris@13:      * @param string        $method  method name
Chris@13:      * @param mixed         $args...
Chris@13:      *
Chris@13:      * @return mixed
Chris@13:      */
Chris@13:     public static function callStatic($class, $method, $args = null)
Chris@13:     {
Chris@17:         $args   = \func_get_args();
Chris@17:         $class  = \array_shift($args);
Chris@17:         $method = \array_shift($args);
Chris@13: 
Chris@13:         $refl = new \ReflectionClass($class);
Chris@13:         $reflMethod = $refl->getMethod($method);
Chris@13:         $reflMethod->setAccessible(true);
Chris@13: 
Chris@13:         return $reflMethod->invokeArgs(null, $args);
Chris@13:     }
Chris@13: 
Chris@13:     /**
Chris@13:      * Fetch a class constant, bypassing visibility restrictions.
Chris@13:      *
Chris@13:      * @param string|object $class class name or instance
Chris@13:      * @param string        $const constant name
Chris@13:      *
Chris@13:      * @return mixed
Chris@13:      */
Chris@13:     public static function fetchClassConst($class, $const)
Chris@13:     {
Chris@13:         $refl = new \ReflectionClass($class);
Chris@13: 
Chris@13:         return $refl->getConstant($const);
Chris@13:     }
Chris@13: }