www.aleph1.co.uk Git - yaffs-website/blob - vendor/symfony/var-dumper/Cloner/AbstractCloner.php

   1 <?php
   2
   3 /*
   4  * This file is part of the Symfony package.
   5  *
   6  * (c) Fabien Potencier <fabien@symfony.com>
   7  *
   8  * For the full copyright and license information, please view the LICENSE
   9  * file that was distributed with this source code.
  10  */
  11
  12 namespace Symfony\Component\VarDumper\Cloner;
  13
  14 use Symfony\Component\VarDumper\Caster\Caster;
  15 use Symfony\Component\VarDumper\Exception\ThrowingCasterException;
  16
  17 /**
  18  * AbstractCloner implements a generic caster mechanism for objects and resources.
  19  *
  20  * @author Nicolas Grekas <p@tchwork.com>
  21  */
  22 abstract class AbstractCloner implements ClonerInterface
  23 {
  24     public static $defaultCasters = array(
  25         '__PHP_Incomplete_Class' => array('Symfony\Component\VarDumper\Caster\Caster', 'castPhpIncompleteClass'),
  26
  27         'Symfony\Component\VarDumper\Caster\CutStub' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'castStub'),
  28         'Symfony\Component\VarDumper\Caster\CutArrayStub' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'castCutArray'),
  29         'Symfony\Component\VarDumper\Caster\ConstStub' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'castStub'),
  30         'Symfony\Component\VarDumper\Caster\EnumStub' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'castEnum'),
  31
  32         'Closure' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castClosure'),
  33         'Generator' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castGenerator'),
  34         'ReflectionType' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castType'),
  35         'ReflectionGenerator' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castReflectionGenerator'),
  36         'ReflectionClass' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castClass'),
  37         'ReflectionFunctionAbstract' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castFunctionAbstract'),
  38         'ReflectionMethod' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castMethod'),
  39         'ReflectionParameter' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castParameter'),
  40         'ReflectionProperty' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castProperty'),
  41         'ReflectionExtension' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castExtension'),
  42         'ReflectionZendExtension' => array('Symfony\Component\VarDumper\Caster\ReflectionCaster', 'castZendExtension'),
  43
  44         'Doctrine\Common\Persistence\ObjectManager' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'),
  45         'Doctrine\Common\Proxy\Proxy' => array('Symfony\Component\VarDumper\Caster\DoctrineCaster', 'castCommonProxy'),
  46         'Doctrine\ORM\Proxy\Proxy' => array('Symfony\Component\VarDumper\Caster\DoctrineCaster', 'castOrmProxy'),
  47         'Doctrine\ORM\PersistentCollection' => array('Symfony\Component\VarDumper\Caster\DoctrineCaster', 'castPersistentCollection'),
  48
  49         'DOMException' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castException'),
  50         'DOMStringList' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'),
  51         'DOMNameList' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'),
  52         'DOMImplementation' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castImplementation'),
  53         'DOMImplementationList' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'),
  54         'DOMNode' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castNode'),
  55         'DOMNameSpaceNode' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castNameSpaceNode'),
  56         'DOMDocument' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castDocument'),
  57         'DOMNodeList' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'),
  58         'DOMNamedNodeMap' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castLength'),
  59         'DOMCharacterData' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castCharacterData'),
  60         'DOMAttr' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castAttr'),
  61         'DOMElement' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castElement'),
  62         'DOMText' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castText'),
  63         'DOMTypeinfo' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castTypeinfo'),
  64         'DOMDomError' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castDomError'),
  65         'DOMLocator' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castLocator'),
  66         'DOMDocumentType' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castDocumentType'),
  67         'DOMNotation' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castNotation'),
  68         'DOMEntity' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castEntity'),
  69         'DOMProcessingInstruction' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castProcessingInstruction'),
  70         'DOMXPath' => array('Symfony\Component\VarDumper\Caster\DOMCaster', 'castXPath'),
  71
  72         'XmlReader' => array('Symfony\Component\VarDumper\Caster\XmlReaderCaster', 'castXmlReader'),
  73
  74         'ErrorException' => array('Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castErrorException'),
  75         'Exception' => array('Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castException'),
  76         'Error' => array('Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castError'),
  77         'Symfony\Component\DependencyInjection\ContainerInterface' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'),
  78         'Symfony\Component\HttpFoundation\Request' => array('Symfony\Component\VarDumper\Caster\SymfonyCaster', 'castRequest'),
  79         'Symfony\Component\VarDumper\Exception\ThrowingCasterException' => array('Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castThrowingCasterException'),
  80         'Symfony\Component\VarDumper\Caster\TraceStub' => array('Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castTraceStub'),
  81         'Symfony\Component\VarDumper\Caster\FrameStub' => array('Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castFrameStub'),
  82         'Symfony\Component\Debug\Exception\SilencedErrorContext' => array('Symfony\Component\VarDumper\Caster\ExceptionCaster', 'castSilencedErrorContext'),
  83
  84         'PHPUnit_Framework_MockObject_MockObject' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'),
  85         'Prophecy\Prophecy\ProphecySubjectInterface' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'),
  86         'Mockery\MockInterface' => array('Symfony\Component\VarDumper\Caster\StubCaster', 'cutInternals'),
  87
  88         'PDO' => array('Symfony\Component\VarDumper\Caster\PdoCaster', 'castPdo'),
  89         'PDOStatement' => array('Symfony\Component\VarDumper\Caster\PdoCaster', 'castPdoStatement'),
  90
  91         'AMQPConnection' => array('Symfony\Component\VarDumper\Caster\AmqpCaster', 'castConnection'),
  92         'AMQPChannel' => array('Symfony\Component\VarDumper\Caster\AmqpCaster', 'castChannel'),
  93         'AMQPQueue' => array('Symfony\Component\VarDumper\Caster\AmqpCaster', 'castQueue'),
  94         'AMQPExchange' => array('Symfony\Component\VarDumper\Caster\AmqpCaster', 'castExchange'),
  95         'AMQPEnvelope' => array('Symfony\Component\VarDumper\Caster\AmqpCaster', 'castEnvelope'),
  96
  97         'ArrayObject' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castArrayObject'),
  98         'ArrayIterator' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castArrayIterator'),
  99         'SplDoublyLinkedList' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castDoublyLinkedList'),
 100         'SplFileInfo' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castFileInfo'),
 101         'SplFileObject' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castFileObject'),
 102         'SplFixedArray' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castFixedArray'),
 103         'SplHeap' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castHeap'),
 104         'SplObjectStorage' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castObjectStorage'),
 105         'SplPriorityQueue' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castHeap'),
 106         'OuterIterator' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castOuterIterator'),
 107
 108         'MongoCursorInterface' => array('Symfony\Component\VarDumper\Caster\MongoCaster', 'castCursor'),
 109
 110         'Redis' => array('Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedis'),
 111         'RedisArray' => array('Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedisArray'),
 112
 113         'DateTimeInterface' => array('Symfony\Component\VarDumper\Caster\DateCaster', 'castDateTime'),
 114         'DateInterval' => array('Symfony\Component\VarDumper\Caster\DateCaster', 'castInterval'),
 115         'DateTimeZone' => array('Symfony\Component\VarDumper\Caster\DateCaster', 'castTimeZone'),
 116         'DatePeriod' => array('Symfony\Component\VarDumper\Caster\DateCaster', 'castPeriod'),
 117
 118         ':curl' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castCurl'),
 119         ':dba' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castDba'),
 120         ':dba persistent' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castDba'),
 121         ':gd' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castGd'),
 122         ':mysql link' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castMysqlLink'),
 123         ':pgsql large object' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLargeObject'),
 124         ':pgsql link' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLink'),
 125         ':pgsql link persistent' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLink'),
 126         ':pgsql result' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castResult'),
 127         ':process' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castProcess'),
 128         ':stream' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStream'),
 129         ':persistent stream' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStream'),
 130         ':stream-context' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStreamContext'),
 131         ':xml' => array('Symfony\Component\VarDumper\Caster\XmlResourceCaster', 'castXml'),
 132     );
 133
 134     protected $maxItems = 2500;
 135     protected $maxString = -1;
 136     protected $minDepth = 1;
 137     protected $useExt;
 138
 139     private $casters = array();
 140     private $prevErrorHandler;
 141     private $classInfo = array();
 142     private $filter = 0;
 143
 144     /**
 145      * @param callable[]|null $casters A map of casters
 146      *
 147      * @see addCasters
 148      */
 149     public function __construct(array $casters = null)
 150     {
 151         if (null === $casters) {
 152             $casters = static::$defaultCasters;
 153         }
 154         $this->addCasters($casters);
 155         $this->useExt = \extension_loaded('symfony_debug');
 156     }
 157
 158     /**
 159      * Adds casters for resources and objects.
 160      *
 161      * Maps resources or objects types to a callback.
 162      * Types are in the key, with a callable caster for value.
 163      * Resource types are to be prefixed with a `:`,
 164      * see e.g. static::$defaultCasters.
 165      *
 166      * @param callable[] $casters A map of casters
 167      */
 168     public function addCasters(array $casters)
 169     {
 170         foreach ($casters as $type => $callback) {
 171             $this->casters[strtolower($type)][] = \is_string($callback) && false !== strpos($callback, '::') ? explode('::', $callback, 2) : $callback;
 172         }
 173     }
 174
 175     /**
 176      * Sets the maximum number of items to clone past the minimum depth in nested structures.
 177      *
 178      * @param int $maxItems
 179      */
 180     public function setMaxItems($maxItems)
 181     {
 182         $this->maxItems = (int) $maxItems;
 183     }
 184
 185     /**
 186      * Sets the maximum cloned length for strings.
 187      *
 188      * @param int $maxString
 189      */
 190     public function setMaxString($maxString)
 191     {
 192         $this->maxString = (int) $maxString;
 193     }
 194
 195     /**
 196      * Sets the minimum tree depth where we are guaranteed to clone all the items.  After this
 197      * depth is reached, only setMaxItems items will be cloned.
 198      *
 199      * @param int $minDepth
 200      */
 201     public function setMinDepth($minDepth)
 202     {
 203         $this->minDepth = (int) $minDepth;
 204     }
 205
 206     /**
 207      * Clones a PHP variable.
 208      *
 209      * @param mixed $var    Any PHP variable
 210      * @param int   $filter A bit field of Caster::EXCLUDE_* constants
 211      *
 212      * @return Data The cloned variable represented by a Data object
 213      */
 214     public function cloneVar($var, $filter = 0)
 215     {
 216         $this->prevErrorHandler = set_error_handler(function ($type, $msg, $file, $line, $context = array()) {
 217             if (E_RECOVERABLE_ERROR === $type || E_USER_ERROR === $type) {
 218                 // Cloner never dies
 219                 throw new \ErrorException($msg, 0, $type, $file, $line);
 220             }
 221
 222             if ($this->prevErrorHandler) {
 223                 return \call_user_func($this->prevErrorHandler, $type, $msg, $file, $line, $context);
 224             }
 225
 226             return false;
 227         });
 228         $this->filter = $filter;
 229
 230         if ($gc = gc_enabled()) {
 231             gc_disable();
 232         }
 233         try {
 234             return new Data($this->doClone($var));
 235         } finally {
 236             if ($gc) {
 237                 gc_enable();
 238             }
 239             restore_error_handler();
 240             $this->prevErrorHandler = null;
 241         }
 242     }
 243
 244     /**
 245      * Effectively clones the PHP variable.
 246      *
 247      * @param mixed $var Any PHP variable
 248      *
 249      * @return array The cloned variable represented in an array
 250      */
 251     abstract protected function doClone($var);
 252
 253     /**
 254      * Casts an object to an array representation.
 255      *
 256      * @param Stub $stub     The Stub for the casted object
 257      * @param bool $isNested True if the object is nested in the dumped structure
 258      *
 259      * @return array The object casted as array
 260      */
 261     protected function castObject(Stub $stub, $isNested)
 262     {
 263         $obj = $stub->value;
 264         $class = $stub->class;
 265
 266         if (isset($class[15]) && "\0" === $class[15] && 0 === strpos($class, "class@anonymous\x00")) {
 267             $stub->class = get_parent_class($class).'@anonymous';
 268         }
 269         if (isset($this->classInfo[$class])) {
 270             list($i, $parents, $hasDebugInfo) = $this->classInfo[$class];
 271         } else {
 272             $i = 2;
 273             $parents = array(strtolower($class));
 274             $hasDebugInfo = method_exists($class, '__debugInfo');
 275
 276             foreach (class_parents($class) as $p) {
 277                 $parents[] = strtolower($p);
 278                 ++$i;
 279             }
 280             foreach (class_implements($class) as $p) {
 281                 $parents[] = strtolower($p);
 282                 ++$i;
 283             }
 284             $parents[] = '*';
 285
 286             $this->classInfo[$class] = array($i, $parents, $hasDebugInfo);
 287         }
 288
 289         $a = Caster::castObject($obj, $class, $hasDebugInfo);
 290
 291         try {
 292             while ($i--) {
 293                 if (!empty($this->casters[$p = $parents[$i]])) {
 294                     foreach ($this->casters[$p] as $callback) {
 295                         $a = $callback($obj, $a, $stub, $isNested, $this->filter);
 296                     }
 297                 }
 298             }
 299         } catch (\Exception $e) {
 300             $a = array((Stub::TYPE_OBJECT === $stub->type ? Caster::PREFIX_VIRTUAL : '').'⚠' => new ThrowingCasterException($e)) + $a;
 301         }
 302
 303         return $a;
 304     }
 305
 306     /**
 307      * Casts a resource to an array representation.
 308      *
 309      * @param Stub $stub     The Stub for the casted resource
 310      * @param bool $isNested True if the object is nested in the dumped structure
 311      *
 312      * @return array The resource casted as array
 313      */
 314     protected function castResource(Stub $stub, $isNested)
 315     {
 316         $a = array();
 317         $res = $stub->value;
 318         $type = $stub->class;
 319
 320         try {
 321             if (!empty($this->casters[':'.$type])) {
 322                 foreach ($this->casters[':'.$type] as $callback) {
 323                     $a = $callback($res, $a, $stub, $isNested, $this->filter);
 324                 }
 325             }
 326         } catch (\Exception $e) {
 327             $a = array((Stub::TYPE_OBJECT === $stub->type ? Caster::PREFIX_VIRTUAL : '').'⚠' => new ThrowingCasterException($e)) + $a;
 328         }
 329
 330         return $a;
 331     }
 332 }