初始化仓库
This commit is contained in:
wangxiaowei
68
vendor/thenorthmemory/xml/src/LabeledArrayIterator.php
vendored
Normal file
68
vendor/thenorthmemory/xml/src/LabeledArrayIterator.php
vendored
Normal file
@ -0,0 +1,68 @@
|
||||
<?php declare(strict_types=1);
|
||||
|
||||
namespace TheNorthMemory\Xml;
|
||||
|
||||
use ArrayIterator;
|
||||
|
||||
/**
|
||||
* Labeled ArrayIterator with special wrapped flag
|
||||
*
|
||||
* @template TKey of array-key
|
||||
* @template TValue
|
||||
*
|
||||
* @extends ArrayIterator<TKey,TValue>
|
||||
*/
|
||||
class LabeledArrayIterator extends ArrayIterator
|
||||
{
|
||||
/**
|
||||
* @var string - The label, default is `item`
|
||||
*/
|
||||
private $label = 'item';
|
||||
|
||||
/**
|
||||
* @var boolean - The wrapped flag, default is `false`
|
||||
*/
|
||||
private $wrapped = false;
|
||||
|
||||
/**
|
||||
* `Label` setter
|
||||
*
|
||||
* @param string $value - the label value
|
||||
* @return self<TKey,TValue>
|
||||
*/
|
||||
public function withLabel(string $value): self
|
||||
{
|
||||
$this->label = $value;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* `Label` getter
|
||||
*/
|
||||
public function getLabel(): string
|
||||
{
|
||||
return $this->label;
|
||||
}
|
||||
|
||||
/**
|
||||
* `wrapped` flag setter
|
||||
*
|
||||
* @param bool $value - the flag value, default is `true`
|
||||
* @return self<TKey,TValue>
|
||||
*/
|
||||
public function wrapped(bool $value = true): self
|
||||
{
|
||||
$this->wrapped = $value;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* `wrapped` flag checker
|
||||
*/
|
||||
public function isWrapped(): bool
|
||||
{
|
||||
return $this->wrapped === true;
|
||||
}
|
||||
}
|
||||
229
vendor/thenorthmemory/xml/src/Transformer.php
vendored
Normal file
229
vendor/thenorthmemory/xml/src/Transformer.php
vendored
Normal file
@ -0,0 +1,229 @@
|
||||
<?php declare(strict_types=1);
|
||||
|
||||
namespace TheNorthMemory\Xml;
|
||||
|
||||
use const LIBXML_VERSION;
|
||||
use const LIBXML_NONET;
|
||||
use const LIBXML_COMPACT;
|
||||
use const LIBXML_NOCDATA;
|
||||
use const LIBXML_NOBLANKS;
|
||||
|
||||
use function array_walk;
|
||||
use function is_array;
|
||||
use function is_object;
|
||||
use function is_string;
|
||||
use function preg_replace;
|
||||
use function strpos;
|
||||
use function preg_match;
|
||||
use function sprintf;
|
||||
use function trigger_error;
|
||||
use function libxml_clear_errors;
|
||||
use function libxml_disable_entity_loader;
|
||||
use function libxml_get_last_error;
|
||||
use function libxml_use_internal_errors;
|
||||
use function simplexml_load_string;
|
||||
|
||||
use SimpleXMLElement;
|
||||
use Traversable;
|
||||
use XMLWriter;
|
||||
|
||||
/**
|
||||
* Transform the `XML` to `Array` or `Array` to `XML`.
|
||||
*
|
||||
* @template TKey of array-key
|
||||
* @template TValue of \Stringable
|
||||
*/
|
||||
class Transformer
|
||||
{
|
||||
/**
|
||||
* Convert the $xml string to array.
|
||||
*
|
||||
* Always issue the `additional Libxml parameters` asof `LIBXML_NONET`
|
||||
* | `LIBXML_COMPACT`
|
||||
* | `LIBXML_NOCDATA`
|
||||
* | `LIBXML_NOBLANKS`
|
||||
*
|
||||
* @param string $xml - The xml string, default is `<xml/>` string
|
||||
*
|
||||
* @return array<TKey,TValue>
|
||||
*/
|
||||
public static function toArray(string $xml = '<xml/>'): array
|
||||
{
|
||||
LIBXML_VERSION < 20900 && $previous = libxml_disable_entity_loader(true);
|
||||
|
||||
libxml_use_internal_errors(true);
|
||||
$el = simplexml_load_string(static::sanitize($xml), SimpleXMLElement::class, LIBXML_NONET | LIBXML_COMPACT | LIBXML_NOCDATA | LIBXML_NOBLANKS);
|
||||
|
||||
LIBXML_VERSION < 20900 && isset($previous) && libxml_disable_entity_loader($previous);
|
||||
|
||||
if (false === $el) {
|
||||
// while parsing failed, let's clean the internal buffer and
|
||||
// only leave the last error message which still can be fetched by the `error_get_last()` function.
|
||||
if (false !== ($err = libxml_get_last_error())) {
|
||||
libxml_clear_errors();
|
||||
@trigger_error(sprintf(
|
||||
'Parsing the $xml failed with the last error(level=%d,code=%d,message=%s).',
|
||||
$err->level, $err->code, $err->message
|
||||
));
|
||||
}
|
||||
|
||||
return [];
|
||||
}
|
||||
|
||||
return static::cast($el);
|
||||
}
|
||||
|
||||
/**
|
||||
* Recursive cast the $thing as array data structure.
|
||||
*
|
||||
* @param array<TKey,SimpleXMLElement|TValue>|SimpleXMLElement $thing - The thing
|
||||
*
|
||||
* @return array<TKey,TValue>
|
||||
*/
|
||||
protected static function cast($thing): array
|
||||
{
|
||||
$data = (array) $thing;
|
||||
array_walk($data, static function(&$value) { static::value($value); });
|
||||
|
||||
return $data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Cast the value $thing, specially doing the `array`, `SimpleXMLElement` to `array`
|
||||
*
|
||||
* @param array<TKey,TValue>|SimpleXMLElement $thing - The value thing reference
|
||||
*/
|
||||
protected static function value(&$thing): void
|
||||
{
|
||||
is_array($thing) && $thing = static::cast($thing);
|
||||
if (is_object($thing) && $thing instanceof SimpleXMLElement) {
|
||||
$thing = $thing->count() ? static::cast($thing) : (string) $thing;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Trim invalid characters from the $xml string
|
||||
*
|
||||
* @see https://github.com/w7corp/easywechat/pull/1419
|
||||
* @license https://github.com/w7corp/easywechat/blob/4.x/LICENSE
|
||||
*
|
||||
* @param string $xml - The xml string
|
||||
*/
|
||||
public static function sanitize(string $xml): string
|
||||
{
|
||||
return preg_replace('#[^\x{9}\x{A}\x{D}\x{20}-\x{D7FF}\x{E000}-\x{FFFD}\x{10000}-\x{10FFFF}]+#u', '', $xml) ?? '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Transform the given $data array as of an XML string.
|
||||
*
|
||||
* @param array<TKey,TValue|LabeledArrayIterator<TKey,TValue>> $data - The data array
|
||||
* @param boolean $headless - The headless flag, default `true` means without the `<?xml version="1.0" encoding="UTF-8" ?>` doctype
|
||||
* @param boolean $indent - Toggle indentation on/off, default is `false` off
|
||||
* @param string $root - The root node label, default is `xml` string
|
||||
* @param string $item - The nest array identify text, default is `item` string
|
||||
*
|
||||
* @return string - The xml string
|
||||
*/
|
||||
public static function toXml(array $data, bool $headless = true, bool $indent = false, string $root = 'xml', string $item = 'item'): string
|
||||
{
|
||||
$writer = new XMLWriter();
|
||||
$writer->openMemory();
|
||||
$writer->setIndent($indent);
|
||||
$headless || $writer->startDocument('1.0', 'utf-8');
|
||||
$writer->startElement($root);
|
||||
static::walk($writer, $data, $item);
|
||||
$writer->endElement();
|
||||
$headless || $writer->endDocument();
|
||||
$xml = $writer->outputMemory();
|
||||
$writer = null;
|
||||
|
||||
return $xml;
|
||||
}
|
||||
|
||||
/**
|
||||
* Wrap the native `Array` data with spicial `label` and mark it whether or nor is wrapped by this `label`.
|
||||
*
|
||||
* @param array<TKey,TValue> $data - The data
|
||||
* @param boolean $wrapped - the wrapping flag, default is `false`
|
||||
* @param string $label - The label, default is `item`
|
||||
*
|
||||
* @return LabeledArrayIterator<TKey,TValue>
|
||||
*/
|
||||
public static function wrap(array $data, bool $wrapped = false, string $label = 'item'): LabeledArrayIterator
|
||||
{
|
||||
return (new LabeledArrayIterator($data))->wrapped($wrapped)->withLabel($label);
|
||||
}
|
||||
|
||||
/**
|
||||
* Walk the given data array by the `XMLWriter` instance.
|
||||
*
|
||||
* @param \XMLWriter $writer - The `XMLWriter` instance reference
|
||||
* @param array<TKey,TValue|array<TKey,TValue>|LabeledArrayIterator<TKey,TValue>> $data - The data array
|
||||
* @param string $item - The nest array identify tag text
|
||||
*/
|
||||
protected static function walk(XMLWriter &$writer, array $data, string $item): void
|
||||
{
|
||||
foreach ($data as $key => $value) {
|
||||
$tag = is_string($key) && static::isElementNameValid($key) ? $key : $item;
|
||||
$withoutParentElement = false;
|
||||
if ($value instanceof LabeledArrayIterator && ($withoutParentElement = $value->isWrapped())) {
|
||||
$tag = $value->getLabel();
|
||||
}
|
||||
$withoutParentElement || $writer->startElement($tag);
|
||||
if (is_array($value) || (is_object($value) && $value instanceof Traversable)) {
|
||||
static::walk($writer, (array) $value, $withoutParentElement ? $tag : $item);
|
||||
} else {
|
||||
static::content($writer, (string) $value);
|
||||
}
|
||||
$withoutParentElement || $writer->endElement();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Write content text.
|
||||
*
|
||||
* The content text includes the characters `<`, `>`, `&` and `"` are written as CDATA references.
|
||||
* All others including `'` are written literally.
|
||||
*
|
||||
* @param \XMLWriter $writer - The `XMLWriter` instance reference
|
||||
* @param string $thing - The content text
|
||||
*/
|
||||
protected static function content(XMLWriter &$writer, string $thing = ''): void
|
||||
{
|
||||
static::needsCdataWrapping($thing) && $writer->writeCdata($thing) || $writer->text($thing);
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks the name is a valid xml element name.
|
||||
*
|
||||
* @see \Symfony\Component\Serializer\Encoder\XmlEncoder::isElementNameValid
|
||||
* @license https://github.com/symfony/serializer/blob/5.3/LICENSE
|
||||
*
|
||||
* @param string $name - The name
|
||||
*
|
||||
* @return boolean - True means valid
|
||||
*/
|
||||
protected static function isElementNameValid(string $name = ''): bool
|
||||
{
|
||||
return $name && false === strpos($name, ' ') && preg_match('#^[\pL_][\pL0-9._:-]*$#ui', $name);
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if a value contains any characters which would require CDATA wrapping.
|
||||
*
|
||||
* Notes here: the `XMLWriter` shall been wrapped the `"` string as `"` symbol string,
|
||||
* it's strictly following the `XMLWriter` specification here.
|
||||
*
|
||||
* @see \Symfony\Component\Serializer\Encoder\XmlEncoder::needsCdataWrapping
|
||||
* @license https://github.com/symfony/serializer/blob/5.3/LICENSE
|
||||
*
|
||||
* @param string $value - The value
|
||||
*
|
||||
* @return boolean - True means need
|
||||
*/
|
||||
protected static function needsCdataWrapping(string $value = ''): bool
|
||||
{
|
||||
return $value && 0 < preg_match('#[>&"<]#', $value);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user