vendor/symfony/var-dumper/Cloner/AbstractCloner.php line 237

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