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 Deprecated;
use InvalidArgumentException;
use Stringable;

use function array_fill_keys;
use function array_keys;
use function array_map;
use function is_string;

/**
 * A Formatter to tackle CSV Formula Injection.
 *
 * @see http://georgemauer.net/2017/10/07/csv-injection.html
 */
class EscapeFormula
{
    /** Spreadsheet formula starting character. */
    public const FORMULA_STARTING_CHARS = ['=', '-', '+', '@', "\t", "\r"];

/** Effective Spreadsheet formula starting characters. */
    protected array $special_chars = [];

/**
     * @param string $escape escape character to escape each CSV formula field
     * @param array<string> $special_chars additional spreadsheet formula starting characters
     */
    public function __construct(
        protected string $escape = "'",
        array $special_chars = []
    ) {
        $this->special_chars = array_fill_keys([
            ...self::FORMULA_STARTING_CHARS,
            ...$this->filterSpecialCharacters(...$special_chars),
        ], 1);
    }

/**
     * Filter submitted special characters.
     *
     * @throws InvalidArgumentException if the string is not a single character
     *
     * @return array<string>
     */
    protected function filterSpecialCharacters(string ...$characters): array
    {
        foreach ($characters as $str) {
            1 === strlen($str) || throw new InvalidArgumentException('The submitted string '.$str.' must be a single character');
        }

return $characters;
    }

/**
     * Returns the list of character the instance will escape.
     *
     * @return array<string>
     */
    public function getSpecialCharacters(): array
    {
        return array_keys($this->special_chars);
    }

/**
     * Returns the escape character.
     */
    public function getEscape(): string
    {
        return $this->escape;
    }

/**
     * Escapes a CSV record.
     */
    public function escapeRecord(array $record): array
    {
        return array_map($this->escapeField(...), $record);
    }

public function unescapeRecord(array $record): array
    {
        return array_map($this->unescapeField(...), $record);
    }

/**
     * Escapes a CSV cell if its content is stringable.
     */
    protected function escapeField(mixed $cell): mixed
    {
        $strOrNull = match (true) {
            is_string($cell) => $cell,
            $cell instanceof Stringable => (string) $cell,
            default => null,
        };

return match (true) {
            null == $strOrNull,
            !isset($strOrNull[0], $this->special_chars[$strOrNull[0]]) => $cell,
            default => $this->escape.$strOrNull,
        };
    }

protected function unescapeField(mixed $cell): mixed
    {
        $strOrNull = match (true) {
            is_string($cell) => $cell,
            $cell instanceof Stringable => (string) $cell,
            default => null,
        };

return match (true) {
            null === $strOrNull,
            !isset($strOrNull[0], $strOrNull[1]),
            $strOrNull[0] !== $this->escape,
            !isset($this->special_chars[$strOrNull[1]]) => $cell,
            default => substr($strOrNull, 1),
        };
    }

/**
     * @deprecated since 9.7.2 will be removed in the next major release
     * @codeCoverageIgnore
     *
     * Tells whether the submitted value is stringable.
     *
     * @param mixed $value value to check if it is stringable
     */
    protected function isStringable(mixed $value): bool
    {
        return is_string($value) || $value instanceof Stringable;
    }

/**
     * @deprecated since 9.11.0 will be removed in the next major release
     * @codeCoverageIgnore
     *
     * League CSV formatter hook.
     *
     * @see escapeRecord
     */
    #[Deprecated(message:'use League\Csv\EscapeFormula::escapeRecord() instead', since:'league/csv:9.11.0')]
    public function __invoke(array $record): array
    {
        return $this->escapeRecord($record);
    }
}