forked from GNUsocial/gnu-social
		
	
		
			
				
	
	
		
			244 lines
		
	
	
		
			8.1 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			244 lines
		
	
	
		
			8.1 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
| <?php
 | |
| 
 | |
| /*
 | |
|  * This file is part of the Symfony package.
 | |
|  *
 | |
|  * (c) Fabien Potencier <fabien@symfony.com>
 | |
|  *
 | |
|  * For the full copyright and license information, please view the LICENSE
 | |
|  * file that was distributed with this source code.
 | |
|  */
 | |
| 
 | |
| namespace Symfony\Component\Config\Util;
 | |
| 
 | |
| /**
 | |
|  * XMLUtils is a bunch of utility methods to XML operations.
 | |
|  *
 | |
|  * This class contains static methods only and is not meant to be instantiated.
 | |
|  *
 | |
|  * @author Fabien Potencier <fabien@symfony.com>
 | |
|  * @author Martin Hasoň <martin.hason@gmail.com>
 | |
|  */
 | |
| class XmlUtils
 | |
| {
 | |
|     /**
 | |
|      * This class should not be instantiated.
 | |
|      */
 | |
|     private function __construct()
 | |
|     {
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Loads an XML file.
 | |
|      *
 | |
|      * @param string               $file             An XML file path
 | |
|      * @param string|callable|null $schemaOrCallable An XSD schema file path, a callable, or null to disable validation
 | |
|      *
 | |
|      * @return \DOMDocument
 | |
|      *
 | |
|      * @throws \InvalidArgumentException When loading of XML file returns error
 | |
|      * @throws \RuntimeException         When DOM extension is missing
 | |
|      */
 | |
|     public static function loadFile($file, $schemaOrCallable = null)
 | |
|     {
 | |
|         if (!\extension_loaded('dom')) {
 | |
|             throw new \RuntimeException('Extension DOM is required.');
 | |
|         }
 | |
| 
 | |
|         $content = @file_get_contents($file);
 | |
|         if ('' === trim($content)) {
 | |
|             throw new \InvalidArgumentException(sprintf('File %s does not contain valid XML, it is empty.', $file));
 | |
|         }
 | |
| 
 | |
|         $internalErrors = libxml_use_internal_errors(true);
 | |
|         $disableEntities = libxml_disable_entity_loader(true);
 | |
|         libxml_clear_errors();
 | |
| 
 | |
|         $dom = new \DOMDocument();
 | |
|         $dom->validateOnParse = true;
 | |
|         if (!$dom->loadXML($content, LIBXML_NONET | (\defined('LIBXML_COMPACT') ? LIBXML_COMPACT : 0))) {
 | |
|             libxml_disable_entity_loader($disableEntities);
 | |
| 
 | |
|             throw new \InvalidArgumentException(implode("\n", static::getXmlErrors($internalErrors)));
 | |
|         }
 | |
| 
 | |
|         $dom->normalizeDocument();
 | |
| 
 | |
|         libxml_use_internal_errors($internalErrors);
 | |
|         libxml_disable_entity_loader($disableEntities);
 | |
| 
 | |
|         foreach ($dom->childNodes as $child) {
 | |
|             if (XML_DOCUMENT_TYPE_NODE === $child->nodeType) {
 | |
|                 throw new \InvalidArgumentException('Document types are not allowed.');
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         if (null !== $schemaOrCallable) {
 | |
|             $internalErrors = libxml_use_internal_errors(true);
 | |
|             libxml_clear_errors();
 | |
| 
 | |
|             $e = null;
 | |
|             if (\is_callable($schemaOrCallable)) {
 | |
|                 try {
 | |
|                     $valid = \call_user_func($schemaOrCallable, $dom, $internalErrors);
 | |
|                 } catch (\Exception $e) {
 | |
|                     $valid = false;
 | |
|                 }
 | |
|             } elseif (!\is_array($schemaOrCallable) && is_file((string) $schemaOrCallable)) {
 | |
|                 $schemaSource = file_get_contents((string) $schemaOrCallable);
 | |
|                 $valid = @$dom->schemaValidateSource($schemaSource);
 | |
|             } else {
 | |
|                 libxml_use_internal_errors($internalErrors);
 | |
| 
 | |
|                 throw new \InvalidArgumentException('The schemaOrCallable argument has to be a valid path to XSD file or callable.');
 | |
|             }
 | |
| 
 | |
|             if (!$valid) {
 | |
|                 $messages = static::getXmlErrors($internalErrors);
 | |
|                 if (empty($messages)) {
 | |
|                     $messages = array(sprintf('The XML file "%s" is not valid.', $file));
 | |
|                 }
 | |
|                 throw new \InvalidArgumentException(implode("\n", $messages), 0, $e);
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         libxml_clear_errors();
 | |
|         libxml_use_internal_errors($internalErrors);
 | |
| 
 | |
|         return $dom;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Converts a \DOMElement object to a PHP array.
 | |
|      *
 | |
|      * The following rules applies during the conversion:
 | |
|      *
 | |
|      *  * Each tag is converted to a key value or an array
 | |
|      *    if there is more than one "value"
 | |
|      *
 | |
|      *  * The content of a tag is set under a "value" key (<foo>bar</foo>)
 | |
|      *    if the tag also has some nested tags
 | |
|      *
 | |
|      *  * The attributes are converted to keys (<foo foo="bar"/>)
 | |
|      *
 | |
|      *  * The nested-tags are converted to keys (<foo><foo>bar</foo></foo>)
 | |
|      *
 | |
|      * @param \DOMElement $element     A \DOMElement instance
 | |
|      * @param bool        $checkPrefix Check prefix in an element or an attribute name
 | |
|      *
 | |
|      * @return array A PHP array
 | |
|      */
 | |
|     public static function convertDomElementToArray(\DOMElement $element, $checkPrefix = true)
 | |
|     {
 | |
|         $prefix = (string) $element->prefix;
 | |
|         $empty = true;
 | |
|         $config = array();
 | |
|         foreach ($element->attributes as $name => $node) {
 | |
|             if ($checkPrefix && !\in_array((string) $node->prefix, array('', $prefix), true)) {
 | |
|                 continue;
 | |
|             }
 | |
|             $config[$name] = static::phpize($node->value);
 | |
|             $empty = false;
 | |
|         }
 | |
| 
 | |
|         $nodeValue = false;
 | |
|         foreach ($element->childNodes as $node) {
 | |
|             if ($node instanceof \DOMText) {
 | |
|                 if ('' !== trim($node->nodeValue)) {
 | |
|                     $nodeValue = trim($node->nodeValue);
 | |
|                     $empty = false;
 | |
|                 }
 | |
|             } elseif ($checkPrefix && $prefix != (string) $node->prefix) {
 | |
|                 continue;
 | |
|             } elseif (!$node instanceof \DOMComment) {
 | |
|                 $value = static::convertDomElementToArray($node, $checkPrefix);
 | |
| 
 | |
|                 $key = $node->localName;
 | |
|                 if (isset($config[$key])) {
 | |
|                     if (!\is_array($config[$key]) || !\is_int(key($config[$key]))) {
 | |
|                         $config[$key] = array($config[$key]);
 | |
|                     }
 | |
|                     $config[$key][] = $value;
 | |
|                 } else {
 | |
|                     $config[$key] = $value;
 | |
|                 }
 | |
| 
 | |
|                 $empty = false;
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         if (false !== $nodeValue) {
 | |
|             $value = static::phpize($nodeValue);
 | |
|             if (\count($config)) {
 | |
|                 $config['value'] = $value;
 | |
|             } else {
 | |
|                 $config = $value;
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         return !$empty ? $config : null;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Converts an xml value to a PHP type.
 | |
|      *
 | |
|      * @param mixed $value
 | |
|      *
 | |
|      * @return mixed
 | |
|      */
 | |
|     public static function phpize($value)
 | |
|     {
 | |
|         $value = (string) $value;
 | |
|         $lowercaseValue = strtolower($value);
 | |
| 
 | |
|         switch (true) {
 | |
|             case 'null' === $lowercaseValue:
 | |
|                 return;
 | |
|             case ctype_digit($value):
 | |
|                 $raw = $value;
 | |
|                 $cast = (int) $value;
 | |
| 
 | |
|                 return '0' == $value[0] ? octdec($value) : (((string) $raw === (string) $cast) ? $cast : $raw);
 | |
|             case isset($value[1]) && '-' === $value[0] && ctype_digit(substr($value, 1)):
 | |
|                 $raw = $value;
 | |
|                 $cast = (int) $value;
 | |
| 
 | |
|                 return '0' == $value[1] ? octdec($value) : (((string) $raw === (string) $cast) ? $cast : $raw);
 | |
|             case 'true' === $lowercaseValue:
 | |
|                 return true;
 | |
|             case 'false' === $lowercaseValue:
 | |
|                 return false;
 | |
|             case isset($value[1]) && '0b' == $value[0].$value[1]:
 | |
|                 return bindec($value);
 | |
|             case is_numeric($value):
 | |
|                 return '0x' === $value[0].$value[1] ? hexdec($value) : (float) $value;
 | |
|             case preg_match('/^0x[0-9a-f]++$/i', $value):
 | |
|                 return hexdec($value);
 | |
|             case preg_match('/^(-|\+)?[0-9]+(\.[0-9]+)?$/', $value):
 | |
|                 return (float) $value;
 | |
|             default:
 | |
|                 return $value;
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     protected static function getXmlErrors($internalErrors)
 | |
|     {
 | |
|         $errors = array();
 | |
|         foreach (libxml_get_errors() as $error) {
 | |
|             $errors[] = sprintf('[%s %s] %s (in %s - line %d, column %d)',
 | |
|                 LIBXML_ERR_WARNING == $error->level ? 'WARNING' : 'ERROR',
 | |
|                 $error->code,
 | |
|                 trim($error->message),
 | |
|                 $error->file ?: 'n/a',
 | |
|                 $error->line,
 | |
|                 $error->column
 | |
|             );
 | |
|         }
 | |
| 
 | |
|         libxml_clear_errors();
 | |
|         libxml_use_internal_errors($internalErrors);
 | |
| 
 | |
|         return $errors;
 | |
|     }
 | |
| }
 |