comparison vendor/symfony/var-dumper/Cloner/AbstractCloner.php @ 0:4c8ae668cc8c

Initial import (non-working)
author Chris Cannam
date Wed, 29 Nov 2017 16:09:58 +0000
parents
children 7a779792577d
comparison
equal deleted inserted replaced
-1:000000000000 0:4c8ae668cc8c
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 'SplDoublyLinkedList' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castDoublyLinkedList'),
99 'SplFileInfo' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castFileInfo'),
100 'SplFileObject' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castFileObject'),
101 'SplFixedArray' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castFixedArray'),
102 'SplHeap' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castHeap'),
103 'SplObjectStorage' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castObjectStorage'),
104 'SplPriorityQueue' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castHeap'),
105 'OuterIterator' => array('Symfony\Component\VarDumper\Caster\SplCaster', 'castOuterIterator'),
106
107 'MongoCursorInterface' => array('Symfony\Component\VarDumper\Caster\MongoCaster', 'castCursor'),
108
109 'Redis' => array('Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedis'),
110 'RedisArray' => array('Symfony\Component\VarDumper\Caster\RedisCaster', 'castRedisArray'),
111
112 ':curl' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castCurl'),
113 ':dba' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castDba'),
114 ':dba persistent' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castDba'),
115 ':gd' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castGd'),
116 ':mysql link' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castMysqlLink'),
117 ':pgsql large object' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLargeObject'),
118 ':pgsql link' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLink'),
119 ':pgsql link persistent' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castLink'),
120 ':pgsql result' => array('Symfony\Component\VarDumper\Caster\PgSqlCaster', 'castResult'),
121 ':process' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castProcess'),
122 ':stream' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStream'),
123 ':persistent stream' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStream'),
124 ':stream-context' => array('Symfony\Component\VarDumper\Caster\ResourceCaster', 'castStreamContext'),
125 ':xml' => array('Symfony\Component\VarDumper\Caster\XmlResourceCaster', 'castXml'),
126 );
127
128 protected $maxItems = 2500;
129 protected $maxString = -1;
130 protected $useExt;
131
132 private $casters = array();
133 private $prevErrorHandler;
134 private $classInfo = array();
135 private $filter = 0;
136
137 /**
138 * @param callable[]|null $casters A map of casters
139 *
140 * @see addCasters
141 */
142 public function __construct(array $casters = null)
143 {
144 if (null === $casters) {
145 $casters = static::$defaultCasters;
146 }
147 $this->addCasters($casters);
148 $this->useExt = extension_loaded('symfony_debug');
149 }
150
151 /**
152 * Adds casters for resources and objects.
153 *
154 * Maps resources or objects types to a callback.
155 * Types are in the key, with a callable caster for value.
156 * Resource types are to be prefixed with a `:`,
157 * see e.g. static::$defaultCasters.
158 *
159 * @param callable[] $casters A map of casters
160 */
161 public function addCasters(array $casters)
162 {
163 foreach ($casters as $type => $callback) {
164 $this->casters[strtolower($type)][] = is_string($callback) && false !== strpos($callback, '::') ? explode('::', $callback, 2) : $callback;
165 }
166 }
167
168 /**
169 * Sets the maximum number of items to clone past the first level in nested structures.
170 *
171 * @param int $maxItems
172 */
173 public function setMaxItems($maxItems)
174 {
175 $this->maxItems = (int) $maxItems;
176 }
177
178 /**
179 * Sets the maximum cloned length for strings.
180 *
181 * @param int $maxString
182 */
183 public function setMaxString($maxString)
184 {
185 $this->maxString = (int) $maxString;
186 }
187
188 /**
189 * Clones a PHP variable.
190 *
191 * @param mixed $var Any PHP variable
192 * @param int $filter A bit field of Caster::EXCLUDE_* constants
193 *
194 * @return Data The cloned variable represented by a Data object
195 */
196 public function cloneVar($var, $filter = 0)
197 {
198 $this->prevErrorHandler = set_error_handler(function ($type, $msg, $file, $line, $context) {
199 if (E_RECOVERABLE_ERROR === $type || E_USER_ERROR === $type) {
200 // Cloner never dies
201 throw new \ErrorException($msg, 0, $type, $file, $line);
202 }
203
204 if ($this->prevErrorHandler) {
205 return call_user_func($this->prevErrorHandler, $type, $msg, $file, $line, $context);
206 }
207
208 return false;
209 });
210 $this->filter = $filter;
211
212 if ($gc = gc_enabled()) {
213 gc_disable();
214 }
215 try {
216 return new Data($this->doClone($var));
217 } finally {
218 if ($gc) {
219 gc_enable();
220 }
221 restore_error_handler();
222 $this->prevErrorHandler = null;
223 }
224 }
225
226 /**
227 * Effectively clones the PHP variable.
228 *
229 * @param mixed $var Any PHP variable
230 *
231 * @return array The cloned variable represented in an array
232 */
233 abstract protected function doClone($var);
234
235 /**
236 * Casts an object to an array representation.
237 *
238 * @param Stub $stub The Stub for the casted object
239 * @param bool $isNested True if the object is nested in the dumped structure
240 *
241 * @return array The object casted as array
242 */
243 protected function castObject(Stub $stub, $isNested)
244 {
245 $obj = $stub->value;
246 $class = $stub->class;
247
248 if (isset($class[15]) && "\0" === $class[15] && 0 === strpos($class, "class@anonymous\x00")) {
249 $stub->class = get_parent_class($class).'@anonymous';
250 }
251 if (isset($this->classInfo[$class])) {
252 list($i, $parents, $hasDebugInfo) = $this->classInfo[$class];
253 } else {
254 $i = 2;
255 $parents = array(strtolower($class));
256 $hasDebugInfo = method_exists($class, '__debugInfo');
257
258 foreach (class_parents($class) as $p) {
259 $parents[] = strtolower($p);
260 ++$i;
261 }
262 foreach (class_implements($class) as $p) {
263 $parents[] = strtolower($p);
264 ++$i;
265 }
266 $parents[] = '*';
267
268 $this->classInfo[$class] = array($i, $parents, $hasDebugInfo);
269 }
270
271 $a = Caster::castObject($obj, $class, $hasDebugInfo);
272
273 try {
274 while ($i--) {
275 if (!empty($this->casters[$p = $parents[$i]])) {
276 foreach ($this->casters[$p] as $callback) {
277 $a = $callback($obj, $a, $stub, $isNested, $this->filter);
278 }
279 }
280 }
281 } catch (\Exception $e) {
282 $a = array((Stub::TYPE_OBJECT === $stub->type ? Caster::PREFIX_VIRTUAL : '').'⚠' => new ThrowingCasterException($e)) + $a;
283 }
284
285 return $a;
286 }
287
288 /**
289 * Casts a resource to an array representation.
290 *
291 * @param Stub $stub The Stub for the casted resource
292 * @param bool $isNested True if the object is nested in the dumped structure
293 *
294 * @return array The resource casted as array
295 */
296 protected function castResource(Stub $stub, $isNested)
297 {
298 $a = array();
299 $res = $stub->value;
300 $type = $stub->class;
301
302 try {
303 if (!empty($this->casters[':'.$type])) {
304 foreach ($this->casters[':'.$type] as $callback) {
305 $a = $callback($res, $a, $stub, $isNested, $this->filter);
306 }
307 }
308 } catch (\Exception $e) {
309 $a = array((Stub::TYPE_OBJECT === $stub->type ? Caster::PREFIX_VIRTUAL : '').'⚠' => new ThrowingCasterException($e)) + $a;
310 }
311
312 return $a;
313 }
314 }