%PDF-1.4
Directory : /var/www/vhosts/lautnusantara.com/httpdocs/mis/system/ThirdParty/Kint/Parser/ |
<?php /* * The MIT License (MIT) * * Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com) * * Permission is hereby granted, free of charge, to any person obtaining a copy of * this software and associated documentation files (the "Software"), to deal in * the Software without restriction, including without limitation the rights to * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of * the Software, and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ namespace Kint\Parser; use DOMNamedNodeMap; use DOMNode; use DOMNodeList; use Kint\Zval\BlobValue; use Kint\Zval\InstanceValue; use Kint\Zval\Representation\Representation; use Kint\Zval\Value; /** * The DOMDocument parser plugin is particularly useful as it is both the only * way to see inside the DOMNode without print_r, and the only way to see mixed * text and node inside XML (SimpleXMLElement will strip out the text). */ class DOMDocumentPlugin extends Plugin { /** * List of properties to skip parsing. * * The properties of a DOMNode can do a *lot* of damage to debuggers. The * DOMNode contains not one, not two, not three, not four, not 5, not 6, * not 7 but 8 different ways to recurse into itself: * * firstChild * * lastChild * * previousSibling * * nextSibling * * ownerDocument * * parentNode * * childNodes * * attributes * * All of this combined: the tiny SVGs used as the caret in Kint are already * enough to make parsing and rendering take over a second, and send memory * usage over 128 megs. So we blacklist every field we don't strictly need * and hope that that's good enough. * * In retrospect - this is probably why print_r does the same * * @var array */ public static $blacklist = [ 'parentNode' => 'DOMNode', 'firstChild' => 'DOMNode', 'lastChild' => 'DOMNode', 'previousSibling' => 'DOMNode', 'nextSibling' => 'DOMNode', 'ownerDocument' => 'DOMDocument', ]; /** * Show all properties and methods. * * @var bool */ public static $verbose = false; public function getTypes() { return ['object']; } public function getTriggers() { return Parser::TRIGGER_SUCCESS; } public function parse(&$var, Value &$o, $trigger) { if (!$o instanceof InstanceValue) { return; } if ($var instanceof DOMNamedNodeMap || $var instanceof DOMNodeList) { return $this->parseList($var, $o, $trigger); } if ($var instanceof DOMNode) { return $this->parseNode($var, $o); } } protected function parseList(&$var, InstanceValue &$o, $trigger) { // Recursion should never happen, should always be stopped at the parent // DOMNode. Depth limit on the other hand we're going to skip since // that would show an empty iterator and rather useless. Let the depth // limit hit the children (DOMNodeList only has DOMNode as children) if ($trigger & Parser::TRIGGER_RECURSION) { return; } $o->size = $var->length; if (0 === $o->size) { $o->replaceRepresentation(new Representation('Iterator')); $o->size = null; return; } // Depth limit // Make empty iterator representation since we need it in DOMNode to point out depth limits if ($this->parser->getDepthLimit() && $o->depth + 1 >= $this->parser->getDepthLimit()) { $b = new Value(); $b->name = $o->classname.' Iterator Contents'; $b->access_path = 'iterator_to_array('.$o->access_path.')'; $b->depth = $o->depth + 1; $b->hints[] = 'depth_limit'; $r = new Representation('Iterator'); $r->contents = [$b]; $o->replaceRepresentation($r, 0); return; } $r = new Representation('Iterator'); $o->replaceRepresentation($r, 0); foreach ($var as $key => $item) { $base_obj = new Value(); $base_obj->depth = $o->depth + 1; $base_obj->name = $item->nodeName; if ($o->access_path) { if ($var instanceof DOMNamedNodeMap) { // We can't use getNamedItem() for attributes without a // namespace because it will pick the first matching // attribute of *any* namespace. // // Contrary to the PHP docs, getNamedItemNS takes null // as a namespace argument for an unnamespaced item. $base_obj->access_path = $o->access_path.'->getNamedItemNS('; $base_obj->access_path .= \var_export($item->namespaceURI, true); $base_obj->access_path .= ', '; $base_obj->access_path .= \var_export($item->name, true); $base_obj->access_path .= ')'; } elseif ($var instanceof DOMNodeList) { $base_obj->access_path = $o->access_path.'->item('.\var_export($key, true).')'; } } $r->contents[] = $this->parser->parse($item, $base_obj); } } protected function parseNode(&$var, InstanceValue &$o) { // Fill the properties // They can't be enumerated through reflection or casting, // so we have to trust the docs and try them one at a time $known_properties = [ 'nodeValue', 'childNodes', 'attributes', ]; if (self::$verbose) { $known_properties = [ 'nodeName', 'nodeValue', 'nodeType', 'parentNode', 'childNodes', 'firstChild', 'lastChild', 'previousSibling', 'nextSibling', 'attributes', 'ownerDocument', 'namespaceURI', 'prefix', 'localName', 'baseURI', 'textContent', ]; } $childNodes = null; $attributes = null; $rep = $o->value; foreach ($known_properties as $prop) { $prop_obj = $this->parseProperty($o, $prop, $var); $rep->contents[] = $prop_obj; if ('childNodes' === $prop) { $childNodes = $prop_obj->getRepresentation('iterator'); } elseif ('attributes' === $prop) { $attributes = $prop_obj->getRepresentation('iterator'); } } if (!self::$verbose) { $o->removeRepresentation('methods'); $o->removeRepresentation('properties'); } // Attributes and comments and text nodes don't // need children or attributes of their own if (\in_array($o->classname, ['DOMAttr', 'DOMText', 'DOMComment'], true)) { $o = self::textualNodeToString($o); return; } // Set the attributes if ($attributes) { $a = new Representation('Attributes'); foreach ($attributes->contents as $attribute) { $a->contents[] = $attribute; } $o->addRepresentation($a, 0); } // Set the children if ($childNodes) { $c = new Representation('Children'); if (1 === \count($childNodes->contents) && ($node = \reset($childNodes->contents)) && \in_array('depth_limit', $node->hints, true)) { $n = new InstanceValue(); $n->transplant($node); $n->name = 'childNodes'; $n->classname = 'DOMNodeList'; $c->contents = [$n]; } else { foreach ($childNodes->contents as $node) { // Remove text nodes if theyre empty if ($node instanceof BlobValue && '#text' === $node->name && (\ctype_space($node->value->contents) || '' === $node->value->contents)) { continue; } $c->contents[] = $node; } } $o->addRepresentation($c, 0); } if ($childNodes) { $o->size = \count($childNodes->contents); } if (!$o->size) { $o->size = null; } } protected function parseProperty(InstanceValue $o, $prop, &$var) { // Duplicating (And slightly optimizing) the Parser::parseObject() code here $base_obj = new Value(); $base_obj->depth = $o->depth + 1; $base_obj->owner_class = $o->classname; $base_obj->name = $prop; $base_obj->operator = Value::OPERATOR_OBJECT; $base_obj->access = Value::ACCESS_PUBLIC; if (null !== $o->access_path) { $base_obj->access_path = $o->access_path; if (\preg_match('/^[A-Za-z0-9_]+$/', $base_obj->name)) { $base_obj->access_path .= '->'.$base_obj->name; } else { $base_obj->access_path .= '->{'.\var_export($base_obj->name, true).'}'; } } if (!isset($var->{$prop})) { $base_obj->type = 'null'; } elseif (isset(self::$blacklist[$prop])) { $b = new InstanceValue(); $b->transplant($base_obj); $base_obj = $b; $base_obj->hints[] = 'blacklist'; $base_obj->classname = self::$blacklist[$prop]; } elseif ('attributes' === $prop) { // Attributes are strings. If we're too deep set the // depth limit to enable parsing them, but no deeper. if ($this->parser->getDepthLimit() && $this->parser->getDepthLimit() - 2 < $base_obj->depth) { $base_obj->depth = $this->parser->getDepthLimit() - 2; } $base_obj = $this->parser->parse($var->{$prop}, $base_obj); } else { $base_obj = $this->parser->parse($var->{$prop}, $base_obj); } return $base_obj; } protected static function textualNodeToString(InstanceValue $o) { if (empty($o->value) || empty($o->value->contents) || empty($o->classname)) { return; } if (!\in_array($o->classname, ['DOMText', 'DOMAttr', 'DOMComment'], true)) { return; } foreach ($o->value->contents as $property) { if ('nodeValue' === $property->name) { $ret = clone $property; $ret->name = $o->name; return $ret; } } } }