Mercurial > hg > isophonics-drupal-site
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 } |