Gecko [ www.school.pilasatech.net ]

Name	Size	Permission	Date
Query	[ DIR ]	drwxrwxrwx	2025-03-23 13:35
Serializer	[ DIR ]	drwxrwxrwx	2025-03-23 13:35
AbstractCsv.php	18.2 KB	-rw-rw-rw-	2025-02-27 23:00
Bom.php	3.63 KB	-rw-rw-rw-	2025-02-27 23:00
Buffer.php	14.58 KB	-rw-rw-rw-	2025-02-27 23:00
ByteSequence.php	1.09 KB	-rw-rw-rw-	2025-02-27 23:00
CallbackStreamFilter.php	4.57 KB	-rw-rw-rw-	2025-02-27 23:00
CannotInsertRecord.php	1.44 KB	-rw-rw-rw-	2025-02-27 23:00
CharsetConverter.php	13.16 KB	-rw-rw-rw-	2025-02-27 23:00
ColumnConsistency.php	1.17 KB	-rw-rw-rw-	2025-02-27 23:00
EncloseField.php	4.25 KB	-rw-rw-rw-	2025-02-27 23:00
EscapeFormula.php	4.21 KB	-rw-rw-rw-	2025-02-27 23:00
Exception.php	437 B	-rw-rw-rw-	2025-02-27 23:00
FragmentFinder.php	13.07 KB	-rw-rw-rw-	2025-02-27 23:00
FragmentNotFound.php	407 B	-rw-rw-rw-	2025-02-27 23:00
HTMLConverter.php	7.3 KB	-rw-rw-rw-	2025-02-27 23:00
HttpHeaders.php	1.88 KB	-rw-rw-rw-	2025-02-27 23:00
Info.php	2.38 KB	-rw-rw-rw-	2025-02-27 23:00
InvalidArgument.php	3.96 KB	-rw-rw-rw-	2025-02-27 23:00
JsonConverter.php	18.97 KB	-rw-rw-rw-	2025-02-27 23:00
MapIterator.php	1.75 KB	-rw-rw-rw-	2025-02-27 23:00
RFC4180Field.php	6.8 KB	-rw-rw-rw-	2025-02-27 23:00
RdbmsResult.php	2.28 KB	-rw-rw-rw-	2025-02-27 23:00
Reader.php	17.39 KB	-rw-rw-rw-	2025-02-27 23:00
ResultSet.php	20.3 KB	-rw-rw-rw-	2025-02-27 23:00
Statement.php	16.9 KB	-rw-rw-rw-	2025-02-27 23:00
Stream.php	15.21 KB	-rw-rw-rw-	2025-02-27 23:00
StreamFilter.php	5.59 KB	-rw-rw-rw-	2025-02-27 23:00
SwapDelimiter.php	5.37 KB	-rw-rw-rw-	2025-02-27 23:00
SyntaxError.php	1.64 KB	-rw-rw-rw-	2025-02-27 23:00
TabularData.php	2.24 KB	-rw-rw-rw-	2025-02-27 23:00
TabularDataReader.php	5.13 KB	-rw-rw-rw-	2025-02-27 23:00
TabularDataWriter.php	1.21 KB	-rw-rw-rw-	2025-02-27 23:00
UnableToProcessCsv.php	363 B	-rw-rw-rw-	2025-02-27 23:00
UnavailableFeature.php	1.05 KB	-rw-rw-rw-	2025-02-27 23:00
UnavailableStream.php	787 B	-rw-rw-rw-	2025-02-27 23:00
Writer.php	9.92 KB	-rw-rw-rw-	2025-02-27 23:00
XMLConverter.php	8.89 KB	-rw-rw-rw-	2025-02-27 23:00
functions.php	1.6 KB	-rw-rw-rw-	2025-02-27 23:00
functions_include.php	342 B	-rw-rw-rw-	2025-02-27 23:00

Rename

<?php

/**
 * League.Csv (https://csv.thephpleague.com)
 *
 * (c) Ignace Nyamagana Butera <nyamsprod@gmail.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace League\Csv;

use Closure;
use Deprecated;
use Dom\Element;
use Dom\XMLDocument;
use DOMDocument;
use DOMElement;
use DOMException;
use Exception;
use RuntimeException;
use Throwable;
use ValueError;

use function class_exists;
use function extension_loaded;
use function in_array;
use function is_bool;
use function strtolower;
use function strtoupper;

/**
 * Converts tabular data into a DOMDocument object.
 */
class XMLConverter
{
    /** XML Root name. */
    protected string $root_name = 'csv';
    /** XML Node name. */
    protected string $record_name = 'row';
    /** XML Item name. */
    protected ?string $field_name = 'cell';
    /** XML column attribute name. */
    protected string $column_attr = '';
    /** XML offset attribute name. */
    protected string $offset_attr = '';
    /** @var ?Closure(array, array-key): array */
    protected ?Closure $formatter = null;

/**
     *
     * @throws RuntimeException If the extension is not present
     * @throws ValueError If the XML class used is invalid
     */
    private static function newXmlDocument(string $xml_class): DOMDocument|XMLDocument
    {
        return match (true) {
            !extension_loaded('dom') => throw new RuntimeException('The DOM extension is not loaded.'),
            !in_array($xml_class, [XMLDocument::class , DOMDocument::class], true) => throw new ValueError('The xml class is invalid.'),
            XMLDocument::class === $xml_class && class_exists(XMLDocument::class) => XMLDocument::createEmpty(),
            default => new DOMDocument(encoding: 'UTF-8'),
        };
    }

public static function supportsHeader(array $header): bool
    {
        $document = self::newXmlDocument(XMLDocument::class);
        foreach ($header as $header_value) {
            try {
                $document->createElement($header_value);
            } catch (Throwable) {
                return false;
            }
        }

return [] !== $header;
    }

public function __construct()
    {
    }

/**
     * XML root element setter.
     *
     * @throws DOMException
     */
    public function rootElement(string $node_name): self
    {
        $clone = clone $this;
        $clone->root_name = (string) $this->filterElementName($node_name);

return $clone;
    }

/**
     * XML Record element setter.
     *
     * @throws DOMException
     */
    public function recordElement(string $node_name, string $record_offset_attribute_name = ''): self
    {
        $clone = clone $this;
        $clone->record_name = (string) $this->filterElementName($node_name);
        $clone->offset_attr = $this->filterAttributeName($record_offset_attribute_name);

return $clone;
    }

/**
     * XML Field element setter.
     *
     * @throws DOMException
     */
    public function fieldElement(?string $node_name, string $fieldname_attribute_name = ''): self
    {
        $clone = clone $this;
        $clone->field_name = $this->filterElementName($node_name);
        $clone->column_attr = $this->filterAttributeName($fieldname_attribute_name);

return $clone;
    }

/**
     * Set a callback to format each item before json encode.
     *
     * @param ?callable(array, array-key): array $formatter
     */
    public function formatter(?callable $formatter): self
    {
        $clone = clone $this;
        $clone->formatter = ($formatter instanceof Closure || null === $formatter) ? $formatter : $formatter(...);

return $clone;
    }

/**
     * Sends and makes the XML structure downloadable via HTTP.
     *.
     * Returns the number of characters read from the handle and passed through to the output.
     *
     * @throws Exception
     */
    public function download(iterable $records, ?string $filename = null, string $encoding = 'utf-8', bool $formatOutput = false): int|false
    {
        /** @var XMLDocument|DOMDocument $document */
        $document = self::newXmlDocument(XMLDocument::class);
        $document->appendChild($this->import($records, $document));
        if (null !== $filename) {
            HttpHeaders::forFileDownload($filename, 'application/xml; charset='.strtolower($encoding));
        }

$document->formatOutput = $formatOutput;
        if ($document instanceof DOMDocument) {
            $document->encoding = strtoupper($encoding);

return $document->save('php://output');
        }

return $document->saveXmlFile('php://output');
    }

/**
     * Creates a new DOMElement related to the given DOMDocument.
     *
     * **DOES NOT** attach to the DOMDocument
     */
    public function import(iterable $records, DOMDocument|XMLDocument $doc): DOMElement|Element
    {
        if (null !== $this->formatter) {
            $records = MapIterator::fromIterable($records, $this->formatter);
        }

$root = $doc->createElement($this->root_name);
        foreach ($records as $offset => $record) {
            $root->appendChild($this->recordToElement($doc, $record, $offset));
        }

return $root;
    }

/**
     * Converts a CSV record into a DOMElement and
     * adds its offset as DOMElement attribute.
     */
    protected function recordToElement(DOMDocument|XMLDocument $document, array $record, int $offset): DOMElement|Element
    {
        $node = $document->createElement($this->record_name);
        foreach ($record as $node_name => $value) {
            $node->appendChild($this->fieldToElement($document, (string) $value, $node_name));
        }

if ('' !== $this->offset_attr) {
            $node->setAttribute($this->offset_attr, (string) $offset);
        }

return $node;
    }

/**
     * Converts Cell to Item.
     *
     * Converts the CSV item into a DOMElement and adds the item offset
     * as attribute to the returned DOMElement
     */
    protected function fieldToElement(DOMDocument|XMLDocument $document, string $value, int|string $node_name): DOMElement|Element
    {
        $node_name = (string) $node_name;
        $item = $document->createElement($this->field_name ?? $node_name);
        $item->appendChild($document->createTextNode($value));

if ('' !== $this->column_attr) {
            $item->setAttribute($this->column_attr, $node_name);
        }

return $item;
    }

/**
     * Apply the callback if the given "condition" is (or resolves to) true.
     *
     * @param (callable($this): bool)|bool $condition
     * @param callable($this): (self|null) $onSuccess
     * @param ?callable($this): (self|null) $onFail
     */
    public function when(callable|bool $condition, callable $onSuccess, ?callable $onFail = null): self
    {
        if (!is_bool($condition)) {
            $condition = $condition($this);
        }

return match (true) {
            $condition => $onSuccess($this),
            null !== $onFail => $onFail($this),
            default => $this,
        } ?? $this;
    }

/**
     * Filters XML element name.
     *
     * @throws DOMException If the Element name is invalid
     */
    protected function filterElementName(?string $value): ?string
    {
        if (null === $value) {
            return null;
        }

return self::newXmlDocument(XMLDocument::class)->createElement($value)->tagName;
    }

/**
     * Filters XML attribute name.
     *
     * @param string $value Element name
     *
     * @throws DOMException If the Element attribute name is invalid
     */
    protected function filterAttributeName(string $value): string
    {
        if ('' === $value) {
            return $value;
        }

$element = self::newXmlDocument(XMLDocument::class)->createElement('foo');
        $element->setAttribute($value, 'foo');

return $value;
    }

/**
     * DEPRECATION WARNING! This method will be removed in the next major point release.
     *
     * @see XMLConverter::import()
     * @deprecated Since version 9.22.0
     * @codeCoverageIgnore
     *
     * Converts a Record collection into a DOMDocument.
     */
    #[Deprecated(message:'use League\Csv\XMLConverter::impoprt()', since:'league/csv:9.22.0')]
    public function convert(iterable $records): DOMDocument
    {
        $document = new DOMDocument(encoding: 'UTF-8');
        $document->appendChild($this->import($records, $document));

return $document;
    }

/**
     * DEPRECATION WARNING! This method will be removed in the next major point release.
     *
     * @see XMLConverter::__construct()
     * @deprecated Since version 9.22.0
     * @codeCoverageIgnore
     *
     * Returns an new instance.
     */
    #[Deprecated(message:'use League\Csv\XMLConverter::__construct()', since:'league/csv:9.22.0')]
    public static function create(): self
    {
        return new self();
    }
}