Mercurial > hg > isophonics-drupal-site
diff vendor/psy/psysh/src/Reflection/ReflectionClassConstant.php @ 16:c2387f117808
Routine composer update
author | Chris Cannam |
---|---|
date | Tue, 10 Jul 2018 15:07:59 +0100 |
parents | |
children | 129ea1e6d783 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vendor/psy/psysh/src/Reflection/ReflectionClassConstant.php Tue Jul 10 15:07:59 2018 +0100 @@ -0,0 +1,228 @@ +<?php + +/* + * This file is part of Psy Shell. + * + * (c) 2012-2018 Justin Hileman + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Psy\Reflection; + +/** + * Somehow the standard reflection library didn't include class constants until 7.1. + * + * ReflectionClassConstant corrects that omission. + */ +class ReflectionClassConstant implements \Reflector +{ + public $class; + public $name; + private $value; + + /** + * Construct a ReflectionClassConstant object. + * + * @param string|object $class + * @param string $name + */ + public function __construct($class, $name) + { + if (!$class instanceof \ReflectionClass) { + $class = new \ReflectionClass($class); + } + + $this->class = $class; + $this->name = $name; + + $constants = $class->getConstants(); + if (!array_key_exists($name, $constants)) { + throw new \InvalidArgumentException('Unknown constant: ' . $name); + } + + $this->value = $constants[$name]; + } + + /** + * Exports a reflection. + * + * @param string|object $class + * @param string $name + * @param bool $return pass true to return the export, as opposed to emitting it + * + * @return null|string + */ + public static function export($class, $name, $return = false) + { + $refl = new self($class, $name); + $value = $refl->getValue(); + + $str = sprintf('Constant [ public %s %s ] { %s }', gettype($value), $refl->getName(), $value); + + if ($return) { + return $str; + } + + echo $str . "\n"; + } + + /** + * Gets the declaring class. + * + * @return \ReflectionClass + */ + public function getDeclaringClass() + { + $parent = $this->class; + + // Since we don't have real reflection constants, we can't see where + // it's actually defined. Let's check for a constant that is also + // available on the parent class which has exactly the same value. + // + // While this isn't _technically_ correct, it's prolly close enough. + do { + $class = $parent; + $parent = $class->getParentClass(); + } while ($parent && $parent->hasConstant($this->name) && $parent->getConstant($this->name) === $this->value); + + return $class; + } + + /** + * Get the constant's docblock. + * + * @return false + */ + public function getDocComment() + { + return false; + } + + /** + * Gets the class constant modifiers. + * + * Since this is only used for PHP < 7.1, we can just return "public". All + * the fancier modifiers are only available on PHP versions which have their + * own ReflectionClassConstant class :) + * + * @return int + */ + public function getModifiers() + { + return \ReflectionMethod::IS_PUBLIC; + } + + /** + * Gets the constant name. + * + * @return string + */ + public function getName() + { + return $this->name; + } + + /** + * Gets the value of the constant. + * + * @return mixed + */ + public function getValue() + { + return $this->value; + } + + /** + * Checks if class constant is private. + * + * @return bool false + */ + public function isPrivate() + { + return false; + } + + /** + * Checks if class constant is protected. + * + * @return bool false + */ + public function isProtected() + { + return false; + } + + /** + * Checks if class constant is public. + * + * @return bool true + */ + public function isPublic() + { + return true; + } + + /** + * To string. + * + * @return string + */ + public function __toString() + { + return $this->getName(); + } + + /** + * Gets the constant's file name. + * + * Currently returns null, because if it returns a file name the signature + * formatter will barf. + */ + public function getFileName() + { + return; + // return $this->class->getFileName(); + } + + /** + * Get the code start line. + * + * @throws \RuntimeException + */ + public function getStartLine() + { + throw new \RuntimeException('Not yet implemented because it\'s unclear what I should do here :)'); + } + + /** + * Get the code end line. + * + * @throws \RuntimeException + */ + public function getEndLine() + { + return $this->getStartLine(); + } + + /** + * Get a ReflectionClassConstant instance. + * + * In PHP >= 7.1, this will return a \ReflectionClassConstant from the + * standard reflection library. For older PHP, it will return this polyfill. + * + * @param string|object $class + * @param string $name + * + * @return ReflectionClassConstant|\ReflectionClassConstant + */ + public static function create($class, $name) + { + if (class_exists('\\ReflectionClassConstant')) { + return new \ReflectionClassConstant($class, $name); + } + + return new self($class, $name); + } +}