gravityview / GravityView

vendor/symfony/string/Slugger/AsciiSlugger.php

Indentation +157 added lines, -157 removed lines

@@ -16,7 +16,7 @@ 
 use Symfony\Contracts\Translation\LocaleAwareInterface;
 
 if (!interface_exists(LocaleAwareInterface::class)) {
-    throw new \LogicException('You cannot use the "Symfony\Component\String\Slugger\AsciiSlugger" as the "symfony/translation-contracts" package is not installed. Try running "composer require symfony/translation-contracts".');
+	throw new \LogicException('You cannot use the "Symfony\Component\String\Slugger\AsciiSlugger" as the "symfony/translation-contracts" package is not installed. Try running "composer require symfony/translation-contracts".');
 }
 
 /**
@@ -24,160 +24,160 @@ 
  */
 class AsciiSlugger implements SluggerInterface, LocaleAwareInterface
 {
-    private const LOCALE_TO_TRANSLITERATOR_ID = [
-        'am' => 'Amharic-Latin',
-        'ar' => 'Arabic-Latin',
-        'az' => 'Azerbaijani-Latin',
-        'be' => 'Belarusian-Latin',
-        'bg' => 'Bulgarian-Latin',
-        'bn' => 'Bengali-Latin',
-        'de' => 'de-ASCII',
-        'el' => 'Greek-Latin',
-        'fa' => 'Persian-Latin',
-        'he' => 'Hebrew-Latin',
-        'hy' => 'Armenian-Latin',
-        'ka' => 'Georgian-Latin',
-        'kk' => 'Kazakh-Latin',
-        'ky' => 'Kirghiz-Latin',
-        'ko' => 'Korean-Latin',
-        'mk' => 'Macedonian-Latin',
-        'mn' => 'Mongolian-Latin',
-        'or' => 'Oriya-Latin',
-        'ps' => 'Pashto-Latin',
-        'ru' => 'Russian-Latin',
-        'sr' => 'Serbian-Latin',
-        'sr_Cyrl' => 'Serbian-Latin',
-        'th' => 'Thai-Latin',
-        'tk' => 'Turkmen-Latin',
-        'uk' => 'Ukrainian-Latin',
-        'uz' => 'Uzbek-Latin',
-        'zh' => 'Han-Latin',
-    ];
-
-    private $defaultLocale;
-    private $symbolsMap = [
-        'en' => ['@' => 'at', '&' => 'and'],
-    ];
-
-    /**
-     * Cache of transliterators per locale.
-     *
-     * @var \Transliterator[]
-     */
-    private $transliterators = [];
-
-    /**
-     * @param array|\Closure|null $symbolsMap
-     */
-    public function __construct(string $defaultLocale = null, $symbolsMap = null)
-    {
-        if (null !== $symbolsMap && !\is_array($symbolsMap) && !$symbolsMap instanceof \Closure) {
-            throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be array, Closure or null, "%s" given.', __METHOD__, \gettype($symbolsMap)));
-        }
-
-        $this->defaultLocale = $defaultLocale;
-        $this->symbolsMap = $symbolsMap ?? $this->symbolsMap;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function setLocale($locale)
-    {
-        $this->defaultLocale = $locale;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getLocale()
-    {
-        return $this->defaultLocale;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function slug(string $string, string $separator = '-', string $locale = null): AbstractUnicodeString
-    {
-        $locale = $locale ?? $this->defaultLocale;
-
-        $transliterator = [];
-        if ($locale && ('de' === $locale || 0 === strpos($locale, 'de_'))) {
-            // Use the shortcut for German in UnicodeString::ascii() if possible (faster and no requirement on intl)
-            $transliterator = ['de-ASCII'];
-        } elseif (\function_exists('transliterator_transliterate') && $locale) {
-            $transliterator = (array) $this->createTransliterator($locale);
-        }
-
-        if ($this->symbolsMap instanceof \Closure) {
-            // If the symbols map is passed as a closure, there is no need to fallback to the parent locale
-            // as the closure can just provide substitutions for all locales of interest.
-            $symbolsMap = $this->symbolsMap;
-            array_unshift($transliterator, static function ($s) use ($symbolsMap, $locale) {
-                return $symbolsMap($s, $locale);
-            });
-        }
-
-        $unicodeString = (new UnicodeString($string))->ascii($transliterator);
-
-        if (\is_array($this->symbolsMap)) {
-            $map = null;
-            if (isset($this->symbolsMap[$locale])) {
-                $map = $this->symbolsMap[$locale];
-            } else {
-                $parent = self::getParentLocale($locale);
-                if ($parent && isset($this->symbolsMap[$parent])) {
-                    $map = $this->symbolsMap[$parent];
-                }
-            }
-            if ($map) {
-                foreach ($map as $char => $replace) {
-                    $unicodeString = $unicodeString->replace($char, ' '.$replace.' ');
-                }
-            }
-        }
-
-        return $unicodeString
-            ->replaceMatches('/[^A-Za-z0-9]++/', $separator)
-            ->trim($separator)
-        ;
-    }
-
-    private function createTransliterator(string $locale): ?\Transliterator
-    {
-        if (\array_key_exists($locale, $this->transliterators)) {
-            return $this->transliterators[$locale];
-        }
-
-        // Exact locale supported, cache and return
-        if ($id = self::LOCALE_TO_TRANSLITERATOR_ID[$locale] ?? null) {
-            return $this->transliterators[$locale] = \Transliterator::create($id.'/BGN') ?? \Transliterator::create($id);
-        }
-
-        // Locale not supported and no parent, fallback to any-latin
-        if (!$parent = self::getParentLocale($locale)) {
-            return $this->transliterators[$locale] = null;
-        }
-
-        // Try to use the parent locale (ie. try "de" for "de_AT") and cache both locales
-        if ($id = self::LOCALE_TO_TRANSLITERATOR_ID[$parent] ?? null) {
-            $transliterator = \Transliterator::create($id.'/BGN') ?? \Transliterator::create($id);
-        }
-
-        return $this->transliterators[$locale] = $this->transliterators[$parent] = $transliterator ?? null;
-    }
-
-    private static function getParentLocale(?string $locale): ?string
-    {
-        if (!$locale) {
-            return null;
-        }
-        if (false === $str = strrchr($locale, '_')) {
-            // no parent locale
-            return null;
-        }
-
-        return substr($locale, 0, -\strlen($str));
-    }
+	private const LOCALE_TO_TRANSLITERATOR_ID = [
+		'am' => 'Amharic-Latin',
+		'ar' => 'Arabic-Latin',
+		'az' => 'Azerbaijani-Latin',
+		'be' => 'Belarusian-Latin',
+		'bg' => 'Bulgarian-Latin',
+		'bn' => 'Bengali-Latin',
+		'de' => 'de-ASCII',
+		'el' => 'Greek-Latin',
+		'fa' => 'Persian-Latin',
+		'he' => 'Hebrew-Latin',
+		'hy' => 'Armenian-Latin',
+		'ka' => 'Georgian-Latin',
+		'kk' => 'Kazakh-Latin',
+		'ky' => 'Kirghiz-Latin',
+		'ko' => 'Korean-Latin',
+		'mk' => 'Macedonian-Latin',
+		'mn' => 'Mongolian-Latin',
+		'or' => 'Oriya-Latin',
+		'ps' => 'Pashto-Latin',
+		'ru' => 'Russian-Latin',
+		'sr' => 'Serbian-Latin',
+		'sr_Cyrl' => 'Serbian-Latin',
+		'th' => 'Thai-Latin',
+		'tk' => 'Turkmen-Latin',
+		'uk' => 'Ukrainian-Latin',
+		'uz' => 'Uzbek-Latin',
+		'zh' => 'Han-Latin',
+	];
+
+	private $defaultLocale;
+	private $symbolsMap = [
+		'en' => ['@' => 'at', '&' => 'and'],
+	];
+
+	/**
+	 * Cache of transliterators per locale.
+	 *
+	 * @var \Transliterator[]
+	 */
+	private $transliterators = [];
+
+	/**
+	 * @param array|\Closure|null $symbolsMap
+	 */
+	public function __construct(string $defaultLocale = null, $symbolsMap = null)
+	{
+		if (null !== $symbolsMap && !\is_array($symbolsMap) && !$symbolsMap instanceof \Closure) {
+			throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be array, Closure or null, "%s" given.', __METHOD__, \gettype($symbolsMap)));
+		}
+
+		$this->defaultLocale = $defaultLocale;
+		$this->symbolsMap = $symbolsMap ?? $this->symbolsMap;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function setLocale($locale)
+	{
+		$this->defaultLocale = $locale;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getLocale()
+	{
+		return $this->defaultLocale;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function slug(string $string, string $separator = '-', string $locale = null): AbstractUnicodeString
+	{
+		$locale = $locale ?? $this->defaultLocale;
+
+		$transliterator = [];
+		if ($locale && ('de' === $locale || 0 === strpos($locale, 'de_'))) {
+			// Use the shortcut for German in UnicodeString::ascii() if possible (faster and no requirement on intl)
+			$transliterator = ['de-ASCII'];
+		} elseif (\function_exists('transliterator_transliterate') && $locale) {
+			$transliterator = (array) $this->createTransliterator($locale);
+		}
+
+		if ($this->symbolsMap instanceof \Closure) {
+			// If the symbols map is passed as a closure, there is no need to fallback to the parent locale
+			// as the closure can just provide substitutions for all locales of interest.
+			$symbolsMap = $this->symbolsMap;
+			array_unshift($transliterator, static function ($s) use ($symbolsMap, $locale) {
+				return $symbolsMap($s, $locale);
+			});
+		}
+
+		$unicodeString = (new UnicodeString($string))->ascii($transliterator);
+
+		if (\is_array($this->symbolsMap)) {
+			$map = null;
+			if (isset($this->symbolsMap[$locale])) {
+				$map = $this->symbolsMap[$locale];
+			} else {
+				$parent = self::getParentLocale($locale);
+				if ($parent && isset($this->symbolsMap[$parent])) {
+					$map = $this->symbolsMap[$parent];
+				}
+			}
+			if ($map) {
+				foreach ($map as $char => $replace) {
+					$unicodeString = $unicodeString->replace($char, ' '.$replace.' ');
+				}
+			}
+		}
+
+		return $unicodeString
+			->replaceMatches('/[^A-Za-z0-9]++/', $separator)
+			->trim($separator)
+		;
+	}
+
+	private function createTransliterator(string $locale): ?\Transliterator
+	{
+		if (\array_key_exists($locale, $this->transliterators)) {
+			return $this->transliterators[$locale];
+		}
+
+		// Exact locale supported, cache and return
+		if ($id = self::LOCALE_TO_TRANSLITERATOR_ID[$locale] ?? null) {
+			return $this->transliterators[$locale] = \Transliterator::create($id.'/BGN') ?? \Transliterator::create($id);
+		}
+
+		// Locale not supported and no parent, fallback to any-latin
+		if (!$parent = self::getParentLocale($locale)) {
+			return $this->transliterators[$locale] = null;
+		}
+
+		// Try to use the parent locale (ie. try "de" for "de_AT") and cache both locales
+		if ($id = self::LOCALE_TO_TRANSLITERATOR_ID[$parent] ?? null) {
+			$transliterator = \Transliterator::create($id.'/BGN') ?? \Transliterator::create($id);
+		}
+
+		return $this->transliterators[$locale] = $this->transliterators[$parent] = $transliterator ?? null;
+	}
+
+	private static function getParentLocale(?string $locale): ?string
+	{
+		if (!$locale) {
+			return null;
+		}
+		if (false === $str = strrchr($locale, '_')) {
+			// no parent locale
+			return null;
+		}
+
+		return substr($locale, 0, -\strlen($str));
+	}
 }

vendor/symfony/string/ByteString.php

Indentation +457 added lines, -457 removed lines

@@ -25,14 +25,14 @@ 
  */
 class ByteString extends AbstractString
 {
-    private const ALPHABET_ALPHANUMERIC = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+	private const ALPHABET_ALPHANUMERIC = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
 
-    public function __construct(string $string = '')
-    {
-        $this->string = $string;
-    }
+	public function __construct(string $string = '')
+	{
+		$this->string = $string;
+	}
 
-    /*
+	/*
      * The following method was derived from code of the Hack Standard Library (v4.40 - 2020-05-03)
      *
      * https://github.com/hhvm/hsl/blob/80a42c02f036f72a42f0415e80d6b847f4bf62d5/src/random/private.php#L16
@@ -42,465 +42,465 @@ 
      * Copyright (c) 2004-2020, Facebook, Inc. (https://www.facebook.com/)
      */
 
-    public static function fromRandom(int $length = 16, string $alphabet = null): self
-    {
-        if ($length <= 0) {
-            throw new InvalidArgumentException(sprintf('A strictly positive length is expected, "%d" given.', $length));
-        }
-
-        $alphabet = $alphabet ?? self::ALPHABET_ALPHANUMERIC;
-        $alphabetSize = \strlen($alphabet);
-        $bits = (int) ceil(log($alphabetSize, 2.0));
-        if ($bits <= 0 || $bits > 56) {
-            throw new InvalidArgumentException('The length of the alphabet must in the [2^1, 2^56] range.');
-        }
-
-        $ret = '';
-        while ($length > 0) {
-            $urandomLength = (int) ceil(2 * $length * $bits / 8.0);
-            $data = random_bytes($urandomLength);
-            $unpackedData = 0;
-            $unpackedBits = 0;
-            for ($i = 0; $i < $urandomLength && $length > 0; ++$i) {
-                // Unpack 8 bits
-                $unpackedData = ($unpackedData << 8) | \ord($data[$i]);
-                $unpackedBits += 8;
-
-                // While we have enough bits to select a character from the alphabet, keep
-                // consuming the random data
-                for (; $unpackedBits >= $bits && $length > 0; $unpackedBits -= $bits) {
-                    $index = ($unpackedData & ((1 << $bits) - 1));
-                    $unpackedData >>= $bits;
-                    // Unfortunately, the alphabet size is not necessarily a power of two.
-                    // Worst case, it is 2^k + 1, which means we need (k+1) bits and we
-                    // have around a 50% chance of missing as k gets larger
-                    if ($index < $alphabetSize) {
-                        $ret .= $alphabet[$index];
-                        --$length;
-                    }
-                }
-            }
-        }
-
-        return new static($ret);
-    }
-
-    public function bytesAt(int $offset): array
-    {
-        $str = $this->string[$offset] ?? '';
-
-        return '' === $str ? [] : [\ord($str)];
-    }
-
-    public function append(string ...$suffix): parent
-    {
-        $str = clone $this;
-        $str->string .= 1 >= \count($suffix) ? ($suffix[0] ?? '') : implode('', $suffix);
-
-        return $str;
-    }
-
-    public function camel(): parent
-    {
-        $str = clone $this;
-        $str->string = lcfirst(str_replace(' ', '', ucwords(preg_replace('/[^a-zA-Z0-9\x7f-\xff]++/', ' ', $this->string))));
-
-        return $str;
-    }
-
-    public function chunk(int $length = 1): array
-    {
-        if (1 > $length) {
-            throw new InvalidArgumentException('The chunk length must be greater than zero.');
-        }
-
-        if ('' === $this->string) {
-            return [];
-        }
-
-        $str = clone $this;
-        $chunks = [];
-
-        foreach (str_split($this->string, $length) as $chunk) {
-            $str->string = $chunk;
-            $chunks[] = clone $str;
-        }
-
-        return $chunks;
-    }
-
-    public function endsWith($suffix): bool
-    {
-        if ($suffix instanceof parent) {
-            $suffix = $suffix->string;
-        } elseif (\is_array($suffix) || $suffix instanceof \Traversable) {
-            return parent::endsWith($suffix);
-        } else {
-            $suffix = (string) $suffix;
-        }
-
-        return '' !== $suffix && \strlen($this->string) >= \strlen($suffix) && 0 === substr_compare($this->string, $suffix, -\strlen($suffix), null, $this->ignoreCase);
-    }
-
-    public function equalsTo($string): bool
-    {
-        if ($string instanceof parent) {
-            $string = $string->string;
-        } elseif (\is_array($string) || $string instanceof \Traversable) {
-            return parent::equalsTo($string);
-        } else {
-            $string = (string) $string;
-        }
-
-        if ('' !== $string && $this->ignoreCase) {
-            return 0 === strcasecmp($string, $this->string);
-        }
-
-        return $string === $this->string;
-    }
-
-    public function folded(): parent
-    {
-        $str = clone $this;
-        $str->string = strtolower($str->string);
-
-        return $str;
-    }
-
-    public function indexOf($needle, int $offset = 0): ?int
-    {
-        if ($needle instanceof parent) {
-            $needle = $needle->string;
-        } elseif (\is_array($needle) || $needle instanceof \Traversable) {
-            return parent::indexOf($needle, $offset);
-        } else {
-            $needle = (string) $needle;
-        }
-
-        if ('' === $needle) {
-            return null;
-        }
-
-        $i = $this->ignoreCase ? stripos($this->string, $needle, $offset) : strpos($this->string, $needle, $offset);
-
-        return false === $i ? null : $i;
-    }
-
-    public function indexOfLast($needle, int $offset = 0): ?int
-    {
-        if ($needle instanceof parent) {
-            $needle = $needle->string;
-        } elseif (\is_array($needle) || $needle instanceof \Traversable) {
-            return parent::indexOfLast($needle, $offset);
-        } else {
-            $needle = (string) $needle;
-        }
-
-        if ('' === $needle) {
-            return null;
-        }
-
-        $i = $this->ignoreCase ? strripos($this->string, $needle, $offset) : strrpos($this->string, $needle, $offset);
-
-        return false === $i ? null : $i;
-    }
-
-    public function isUtf8(): bool
-    {
-        return '' === $this->string || preg_match('//u', $this->string);
-    }
-
-    public function join(array $strings, string $lastGlue = null): parent
-    {
-        $str = clone $this;
-
-        $tail = null !== $lastGlue && 1 < \count($strings) ? $lastGlue.array_pop($strings) : '';
-        $str->string = implode($this->string, $strings).$tail;
-
-        return $str;
-    }
-
-    public function length(): int
-    {
-        return \strlen($this->string);
-    }
-
-    public function lower(): parent
-    {
-        $str = clone $this;
-        $str->string = strtolower($str->string);
-
-        return $str;
-    }
-
-    public function match(string $regexp, int $flags = 0, int $offset = 0): array
-    {
-        $match = ((\PREG_PATTERN_ORDER | \PREG_SET_ORDER) & $flags) ? 'preg_match_all' : 'preg_match';
-
-        if ($this->ignoreCase) {
-            $regexp .= 'i';
-        }
-
-        set_error_handler(static function ($t, $m) { throw new InvalidArgumentException($m); });
-
-        try {
-            if (false === $match($regexp, $this->string, $matches, $flags | \PREG_UNMATCHED_AS_NULL, $offset)) {
-                $lastError = preg_last_error();
-
-                foreach (get_defined_constants(true)['pcre'] as $k => $v) {
-                    if ($lastError === $v && '_ERROR' === substr($k, -6)) {
-                        throw new RuntimeException('Matching failed with '.$k.'.');
-                    }
-                }
-
-                throw new RuntimeException('Matching failed with unknown error code.');
-            }
-        } finally {
-            restore_error_handler();
-        }
-
-        return $matches;
-    }
-
-    public function padBoth(int $length, string $padStr = ' '): parent
-    {
-        $str = clone $this;
-        $str->string = str_pad($this->string, $length, $padStr, \STR_PAD_BOTH);
-
-        return $str;
-    }
-
-    public function padEnd(int $length, string $padStr = ' '): parent
-    {
-        $str = clone $this;
-        $str->string = str_pad($this->string, $length, $padStr, \STR_PAD_RIGHT);
-
-        return $str;
-    }
-
-    public function padStart(int $length, string $padStr = ' '): parent
-    {
-        $str = clone $this;
-        $str->string = str_pad($this->string, $length, $padStr, \STR_PAD_LEFT);
-
-        return $str;
-    }
-
-    public function prepend(string ...$prefix): parent
-    {
-        $str = clone $this;
-        $str->string = (1 >= \count($prefix) ? ($prefix[0] ?? '') : implode('', $prefix)).$str->string;
-
-        return $str;
-    }
-
-    public function replace(string $from, string $to): parent
-    {
-        $str = clone $this;
-
-        if ('' !== $from) {
-            $str->string = $this->ignoreCase ? str_ireplace($from, $to, $this->string) : str_replace($from, $to, $this->string);
-        }
-
-        return $str;
-    }
-
-    public function replaceMatches(string $fromRegexp, $to): parent
-    {
-        if ($this->ignoreCase) {
-            $fromRegexp .= 'i';
-        }
-
-        if (\is_array($to)) {
-            if (!\is_callable($to)) {
-                throw new \TypeError(sprintf('Argument 2 passed to "%s::replaceMatches()" must be callable, array given.', static::class));
-            }
-
-            $replace = 'preg_replace_callback';
-        } else {
-            $replace = $to instanceof \Closure ? 'preg_replace_callback' : 'preg_replace';
-        }
-
-        set_error_handler(static function ($t, $m) { throw new InvalidArgumentException($m); });
-
-        try {
-            if (null === $string = $replace($fromRegexp, $to, $this->string)) {
-                $lastError = preg_last_error();
-
-                foreach (get_defined_constants(true)['pcre'] as $k => $v) {
-                    if ($lastError === $v && '_ERROR' === substr($k, -6)) {
-                        throw new RuntimeException('Matching failed with '.$k.'.');
-                    }
-                }
-
-                throw new RuntimeException('Matching failed with unknown error code.');
-            }
-        } finally {
-            restore_error_handler();
-        }
-
-        $str = clone $this;
-        $str->string = $string;
-
-        return $str;
-    }
-
-    public function reverse(): parent
-    {
-        $str = clone $this;
-        $str->string = strrev($str->string);
-
-        return $str;
-    }
-
-    public function slice(int $start = 0, int $length = null): parent
-    {
-        $str = clone $this;
-        $str->string = (string) substr($this->string, $start, $length ?? \PHP_INT_MAX);
-
-        return $str;
-    }
-
-    public function snake(): parent
-    {
-        $str = $this->camel()->title();
-        $str->string = strtolower(preg_replace(['/([A-Z]+)([A-Z][a-z])/', '/([a-z\d])([A-Z])/'], '\1_\2', $str->string));
-
-        return $str;
-    }
-
-    public function splice(string $replacement, int $start = 0, int $length = null): parent
-    {
-        $str = clone $this;
-        $str->string = substr_replace($this->string, $replacement, $start, $length ?? \PHP_INT_MAX);
-
-        return $str;
-    }
-
-    public function split(string $delimiter, int $limit = null, int $flags = null): array
-    {
-        if (1 > $limit = $limit ?? \PHP_INT_MAX) {
-            throw new InvalidArgumentException('Split limit must be a positive integer.');
-        }
-
-        if ('' === $delimiter) {
-            throw new InvalidArgumentException('Split delimiter is empty.');
-        }
-
-        if (null !== $flags) {
-            return parent::split($delimiter, $limit, $flags);
-        }
-
-        $str = clone $this;
-        $chunks = $this->ignoreCase
-            ? preg_split('{'.preg_quote($delimiter).'}iD', $this->string, $limit)
-            : explode($delimiter, $this->string, $limit);
-
-        foreach ($chunks as &$chunk) {
-            $str->string = $chunk;
-            $chunk = clone $str;
-        }
-
-        return $chunks;
-    }
-
-    public function startsWith($prefix): bool
-    {
-        if ($prefix instanceof parent) {
-            $prefix = $prefix->string;
-        } elseif (!\is_string($prefix)) {
-            return parent::startsWith($prefix);
-        }
-
-        return '' !== $prefix && 0 === ($this->ignoreCase ? strncasecmp($this->string, $prefix, \strlen($prefix)) : strncmp($this->string, $prefix, \strlen($prefix)));
-    }
-
-    public function title(bool $allWords = false): parent
-    {
-        $str = clone $this;
-        $str->string = $allWords ? ucwords($str->string) : ucfirst($str->string);
-
-        return $str;
-    }
-
-    public function toUnicodeString(string $fromEncoding = null): UnicodeString
-    {
-        return new UnicodeString($this->toCodePointString($fromEncoding)->string);
-    }
-
-    public function toCodePointString(string $fromEncoding = null): CodePointString
-    {
-        $u = new CodePointString();
-
-        if (\in_array($fromEncoding, [null, 'utf8', 'utf-8', 'UTF8', 'UTF-8'], true) && preg_match('//u', $this->string)) {
-            $u->string = $this->string;
-
-            return $u;
-        }
+	public static function fromRandom(int $length = 16, string $alphabet = null): self
+	{
+		if ($length <= 0) {
+			throw new InvalidArgumentException(sprintf('A strictly positive length is expected, "%d" given.', $length));
+		}
+
+		$alphabet = $alphabet ?? self::ALPHABET_ALPHANUMERIC;
+		$alphabetSize = \strlen($alphabet);
+		$bits = (int) ceil(log($alphabetSize, 2.0));
+		if ($bits <= 0 || $bits > 56) {
+			throw new InvalidArgumentException('The length of the alphabet must in the [2^1, 2^56] range.');
+		}
+
+		$ret = '';
+		while ($length > 0) {
+			$urandomLength = (int) ceil(2 * $length * $bits / 8.0);
+			$data = random_bytes($urandomLength);
+			$unpackedData = 0;
+			$unpackedBits = 0;
+			for ($i = 0; $i < $urandomLength && $length > 0; ++$i) {
+				// Unpack 8 bits
+				$unpackedData = ($unpackedData << 8) | \ord($data[$i]);
+				$unpackedBits += 8;
+
+				// While we have enough bits to select a character from the alphabet, keep
+				// consuming the random data
+				for (; $unpackedBits >= $bits && $length > 0; $unpackedBits -= $bits) {
+					$index = ($unpackedData & ((1 << $bits) - 1));
+					$unpackedData >>= $bits;
+					// Unfortunately, the alphabet size is not necessarily a power of two.
+					// Worst case, it is 2^k + 1, which means we need (k+1) bits and we
+					// have around a 50% chance of missing as k gets larger
+					if ($index < $alphabetSize) {
+						$ret .= $alphabet[$index];
+						--$length;
+					}
+				}
+			}
+		}
+
+		return new static($ret);
+	}
+
+	public function bytesAt(int $offset): array
+	{
+		$str = $this->string[$offset] ?? '';
+
+		return '' === $str ? [] : [\ord($str)];
+	}
+
+	public function append(string ...$suffix): parent
+	{
+		$str = clone $this;
+		$str->string .= 1 >= \count($suffix) ? ($suffix[0] ?? '') : implode('', $suffix);
+
+		return $str;
+	}
+
+	public function camel(): parent
+	{
+		$str = clone $this;
+		$str->string = lcfirst(str_replace(' ', '', ucwords(preg_replace('/[^a-zA-Z0-9\x7f-\xff]++/', ' ', $this->string))));
+
+		return $str;
+	}
+
+	public function chunk(int $length = 1): array
+	{
+		if (1 > $length) {
+			throw new InvalidArgumentException('The chunk length must be greater than zero.');
+		}
+
+		if ('' === $this->string) {
+			return [];
+		}
+
+		$str = clone $this;
+		$chunks = [];
+
+		foreach (str_split($this->string, $length) as $chunk) {
+			$str->string = $chunk;
+			$chunks[] = clone $str;
+		}
+
+		return $chunks;
+	}
+
+	public function endsWith($suffix): bool
+	{
+		if ($suffix instanceof parent) {
+			$suffix = $suffix->string;
+		} elseif (\is_array($suffix) || $suffix instanceof \Traversable) {
+			return parent::endsWith($suffix);
+		} else {
+			$suffix = (string) $suffix;
+		}
+
+		return '' !== $suffix && \strlen($this->string) >= \strlen($suffix) && 0 === substr_compare($this->string, $suffix, -\strlen($suffix), null, $this->ignoreCase);
+	}
+
+	public function equalsTo($string): bool
+	{
+		if ($string instanceof parent) {
+			$string = $string->string;
+		} elseif (\is_array($string) || $string instanceof \Traversable) {
+			return parent::equalsTo($string);
+		} else {
+			$string = (string) $string;
+		}
+
+		if ('' !== $string && $this->ignoreCase) {
+			return 0 === strcasecmp($string, $this->string);
+		}
+
+		return $string === $this->string;
+	}
+
+	public function folded(): parent
+	{
+		$str = clone $this;
+		$str->string = strtolower($str->string);
+
+		return $str;
+	}
+
+	public function indexOf($needle, int $offset = 0): ?int
+	{
+		if ($needle instanceof parent) {
+			$needle = $needle->string;
+		} elseif (\is_array($needle) || $needle instanceof \Traversable) {
+			return parent::indexOf($needle, $offset);
+		} else {
+			$needle = (string) $needle;
+		}
+
+		if ('' === $needle) {
+			return null;
+		}
+
+		$i = $this->ignoreCase ? stripos($this->string, $needle, $offset) : strpos($this->string, $needle, $offset);
+
+		return false === $i ? null : $i;
+	}
+
+	public function indexOfLast($needle, int $offset = 0): ?int
+	{
+		if ($needle instanceof parent) {
+			$needle = $needle->string;
+		} elseif (\is_array($needle) || $needle instanceof \Traversable) {
+			return parent::indexOfLast($needle, $offset);
+		} else {
+			$needle = (string) $needle;
+		}
+
+		if ('' === $needle) {
+			return null;
+		}
+
+		$i = $this->ignoreCase ? strripos($this->string, $needle, $offset) : strrpos($this->string, $needle, $offset);
+
+		return false === $i ? null : $i;
+	}
+
+	public function isUtf8(): bool
+	{
+		return '' === $this->string || preg_match('//u', $this->string);
+	}
+
+	public function join(array $strings, string $lastGlue = null): parent
+	{
+		$str = clone $this;
+
+		$tail = null !== $lastGlue && 1 < \count($strings) ? $lastGlue.array_pop($strings) : '';
+		$str->string = implode($this->string, $strings).$tail;
+
+		return $str;
+	}
+
+	public function length(): int
+	{
+		return \strlen($this->string);
+	}
+
+	public function lower(): parent
+	{
+		$str = clone $this;
+		$str->string = strtolower($str->string);
+
+		return $str;
+	}
+
+	public function match(string $regexp, int $flags = 0, int $offset = 0): array
+	{
+		$match = ((\PREG_PATTERN_ORDER | \PREG_SET_ORDER) & $flags) ? 'preg_match_all' : 'preg_match';
+
+		if ($this->ignoreCase) {
+			$regexp .= 'i';
+		}
+
+		set_error_handler(static function ($t, $m) { throw new InvalidArgumentException($m); });
+
+		try {
+			if (false === $match($regexp, $this->string, $matches, $flags | \PREG_UNMATCHED_AS_NULL, $offset)) {
+				$lastError = preg_last_error();
+
+				foreach (get_defined_constants(true)['pcre'] as $k => $v) {
+					if ($lastError === $v && '_ERROR' === substr($k, -6)) {
+						throw new RuntimeException('Matching failed with '.$k.'.');
+					}
+				}
+
+				throw new RuntimeException('Matching failed with unknown error code.');
+			}
+		} finally {
+			restore_error_handler();
+		}
+
+		return $matches;
+	}
+
+	public function padBoth(int $length, string $padStr = ' '): parent
+	{
+		$str = clone $this;
+		$str->string = str_pad($this->string, $length, $padStr, \STR_PAD_BOTH);
+
+		return $str;
+	}
+
+	public function padEnd(int $length, string $padStr = ' '): parent
+	{
+		$str = clone $this;
+		$str->string = str_pad($this->string, $length, $padStr, \STR_PAD_RIGHT);
+
+		return $str;
+	}
+
+	public function padStart(int $length, string $padStr = ' '): parent
+	{
+		$str = clone $this;
+		$str->string = str_pad($this->string, $length, $padStr, \STR_PAD_LEFT);
+
+		return $str;
+	}
+
+	public function prepend(string ...$prefix): parent
+	{
+		$str = clone $this;
+		$str->string = (1 >= \count($prefix) ? ($prefix[0] ?? '') : implode('', $prefix)).$str->string;
+
+		return $str;
+	}
+
+	public function replace(string $from, string $to): parent
+	{
+		$str = clone $this;
+
+		if ('' !== $from) {
+			$str->string = $this->ignoreCase ? str_ireplace($from, $to, $this->string) : str_replace($from, $to, $this->string);
+		}
+
+		return $str;
+	}
+
+	public function replaceMatches(string $fromRegexp, $to): parent
+	{
+		if ($this->ignoreCase) {
+			$fromRegexp .= 'i';
+		}
+
+		if (\is_array($to)) {
+			if (!\is_callable($to)) {
+				throw new \TypeError(sprintf('Argument 2 passed to "%s::replaceMatches()" must be callable, array given.', static::class));
+			}
+
+			$replace = 'preg_replace_callback';
+		} else {
+			$replace = $to instanceof \Closure ? 'preg_replace_callback' : 'preg_replace';
+		}
+
+		set_error_handler(static function ($t, $m) { throw new InvalidArgumentException($m); });
+
+		try {
+			if (null === $string = $replace($fromRegexp, $to, $this->string)) {
+				$lastError = preg_last_error();
+
+				foreach (get_defined_constants(true)['pcre'] as $k => $v) {
+					if ($lastError === $v && '_ERROR' === substr($k, -6)) {
+						throw new RuntimeException('Matching failed with '.$k.'.');
+					}
+				}
+
+				throw new RuntimeException('Matching failed with unknown error code.');
+			}
+		} finally {
+			restore_error_handler();
+		}
+
+		$str = clone $this;
+		$str->string = $string;
+
+		return $str;
+	}
+
+	public function reverse(): parent
+	{
+		$str = clone $this;
+		$str->string = strrev($str->string);
+
+		return $str;
+	}
+
+	public function slice(int $start = 0, int $length = null): parent
+	{
+		$str = clone $this;
+		$str->string = (string) substr($this->string, $start, $length ?? \PHP_INT_MAX);
+
+		return $str;
+	}
+
+	public function snake(): parent
+	{
+		$str = $this->camel()->title();
+		$str->string = strtolower(preg_replace(['/([A-Z]+)([A-Z][a-z])/', '/([a-z\d])([A-Z])/'], '\1_\2', $str->string));
+
+		return $str;
+	}
+
+	public function splice(string $replacement, int $start = 0, int $length = null): parent
+	{
+		$str = clone $this;
+		$str->string = substr_replace($this->string, $replacement, $start, $length ?? \PHP_INT_MAX);
+
+		return $str;
+	}
+
+	public function split(string $delimiter, int $limit = null, int $flags = null): array
+	{
+		if (1 > $limit = $limit ?? \PHP_INT_MAX) {
+			throw new InvalidArgumentException('Split limit must be a positive integer.');
+		}
+
+		if ('' === $delimiter) {
+			throw new InvalidArgumentException('Split delimiter is empty.');
+		}
+
+		if (null !== $flags) {
+			return parent::split($delimiter, $limit, $flags);
+		}
+
+		$str = clone $this;
+		$chunks = $this->ignoreCase
+			? preg_split('{'.preg_quote($delimiter).'}iD', $this->string, $limit)
+			: explode($delimiter, $this->string, $limit);
+
+		foreach ($chunks as &$chunk) {
+			$str->string = $chunk;
+			$chunk = clone $str;
+		}
+
+		return $chunks;
+	}
+
+	public function startsWith($prefix): bool
+	{
+		if ($prefix instanceof parent) {
+			$prefix = $prefix->string;
+		} elseif (!\is_string($prefix)) {
+			return parent::startsWith($prefix);
+		}
+
+		return '' !== $prefix && 0 === ($this->ignoreCase ? strncasecmp($this->string, $prefix, \strlen($prefix)) : strncmp($this->string, $prefix, \strlen($prefix)));
+	}
+
+	public function title(bool $allWords = false): parent
+	{
+		$str = clone $this;
+		$str->string = $allWords ? ucwords($str->string) : ucfirst($str->string);
+
+		return $str;
+	}
+
+	public function toUnicodeString(string $fromEncoding = null): UnicodeString
+	{
+		return new UnicodeString($this->toCodePointString($fromEncoding)->string);
+	}
+
+	public function toCodePointString(string $fromEncoding = null): CodePointString
+	{
+		$u = new CodePointString();
+
+		if (\in_array($fromEncoding, [null, 'utf8', 'utf-8', 'UTF8', 'UTF-8'], true) && preg_match('//u', $this->string)) {
+			$u->string = $this->string;
+
+			return $u;
+		}
 
-        set_error_handler(static function ($t, $m) { throw new InvalidArgumentException($m); });
-
-        try {
-            try {
-                $validEncoding = false !== mb_detect_encoding($this->string, $fromEncoding ?? 'Windows-1252', true);
-            } catch (InvalidArgumentException $e) {
-                if (!\function_exists('iconv')) {
-                    throw $e;
-                }
-
-                $u->string = iconv($fromEncoding ?? 'Windows-1252', 'UTF-8', $this->string);
+		set_error_handler(static function ($t, $m) { throw new InvalidArgumentException($m); });
+
+		try {
+			try {
+				$validEncoding = false !== mb_detect_encoding($this->string, $fromEncoding ?? 'Windows-1252', true);
+			} catch (InvalidArgumentException $e) {
+				if (!\function_exists('iconv')) {
+					throw $e;
+				}
+
+				$u->string = iconv($fromEncoding ?? 'Windows-1252', 'UTF-8', $this->string);
 
-                return $u;
-            }
-        } finally {
-            restore_error_handler();
-        }
-
-        if (!$validEncoding) {
-            throw new InvalidArgumentException(sprintf('Invalid "%s" string.', $fromEncoding ?? 'Windows-1252'));
-        }
-
-        $u->string = mb_convert_encoding($this->string, 'UTF-8', $fromEncoding ?? 'Windows-1252');
-
-        return $u;
-    }
+				return $u;
+			}
+		} finally {
+			restore_error_handler();
+		}
+
+		if (!$validEncoding) {
+			throw new InvalidArgumentException(sprintf('Invalid "%s" string.', $fromEncoding ?? 'Windows-1252'));
+		}
+
+		$u->string = mb_convert_encoding($this->string, 'UTF-8', $fromEncoding ?? 'Windows-1252');
+
+		return $u;
+	}
 
-    public function trim(string $chars = " \t\n\r\0\x0B\x0C"): parent
-    {
-        $str = clone $this;
-        $str->string = trim($str->string, $chars);
-
-        return $str;
-    }
+	public function trim(string $chars = " \t\n\r\0\x0B\x0C"): parent
+	{
+		$str = clone $this;
+		$str->string = trim($str->string, $chars);
+
+		return $str;
+	}
 
-    public function trimEnd(string $chars = " \t\n\r\0\x0B\x0C"): parent
-    {
-        $str = clone $this;
-        $str->string = rtrim($str->string, $chars);
-
-        return $str;
-    }
+	public function trimEnd(string $chars = " \t\n\r\0\x0B\x0C"): parent
+	{
+		$str = clone $this;
+		$str->string = rtrim($str->string, $chars);
+
+		return $str;
+	}
 
-    public function trimStart(string $chars = " \t\n\r\0\x0B\x0C"): parent
-    {
-        $str = clone $this;
-        $str->string = ltrim($str->string, $chars);
+	public function trimStart(string $chars = " \t\n\r\0\x0B\x0C"): parent
+	{
+		$str = clone $this;
+		$str->string = ltrim($str->string, $chars);
 
-        return $str;
-    }
+		return $str;
+	}
 
-    public function upper(): parent
-    {
-        $str = clone $this;
-        $str->string = strtoupper($str->string);
+	public function upper(): parent
+	{
+		$str = clone $this;
+		$str->string = strtoupper($str->string);
 
-        return $str;
-    }
+		return $str;
+	}
 
-    public function width(bool $ignoreAnsiDecoration = true): int
-    {
-        $string = preg_match('//u', $this->string) ? $this->string : preg_replace('/[\x80-\xFF]/', '?', $this->string);
+	public function width(bool $ignoreAnsiDecoration = true): int
+	{
+		$string = preg_match('//u', $this->string) ? $this->string : preg_replace('/[\x80-\xFF]/', '?', $this->string);
 
-        return (new CodePointString($string))->width($ignoreAnsiDecoration);
-    }
+		return (new CodePointString($string))->width($ignoreAnsiDecoration);
+	}
 }

vendor/symfony/string/Inflector/FrenchInflector.php

Indentation +136 added lines, -136 removed lines

@@ -18,140 +18,140 @@
  */
 final class FrenchInflector implements InflectorInterface
 {
-    /**
-     * A list of all rules for pluralise.
-     *
-     * @see https://la-conjugaison.nouvelobs.com/regles/grammaire/le-pluriel-des-noms-121.php
-     */
-    private const PLURALIZE_REGEXP = [
-        // First entry: regexp
-        // Second entry: replacement
-
-        // Words finishing with "s", "x" or "z" are invariables
-        // Les mots finissant par "s", "x" ou "z" sont invariables
-        ['/(s|x|z)$/i', '\1'],
-
-        // Words finishing with "eau" are pluralized with a "x"
-        // Les mots finissant par "eau" prennent tous un "x" au pluriel
-        ['/(eau)$/i', '\1x'],
-
-        // Words finishing with "au" are pluralized with a "x" excepted "landau"
-        // Les mots finissant par "au" prennent un "x" au pluriel sauf "landau"
-        ['/^(landau)$/i', '\1s'],
-        ['/(au)$/i', '\1x'],
-
-        // Words finishing with "eu" are pluralized with a "x" excepted "pneu", "bleu", "émeu"
-        // Les mots finissant en "eu" prennent un "x" au pluriel sauf "pneu", "bleu", "émeu"
-        ['/^(pneu|bleu|émeu)$/i', '\1s'],
-        ['/(eu)$/i', '\1x'],
-
-        // Words finishing with "al" are pluralized with a "aux" excepted
-        // Les mots finissant en "al" se terminent en "aux" sauf
-        ['/^(bal|carnaval|caracal|chacal|choral|corral|étal|festival|récital|val)$/i', '\1s'],
-        ['/al$/i', '\1aux'],
-
-        // Aspirail, bail, corail, émail, fermail, soupirail, travail, vantail et vitrail font leur pluriel en -aux
-        ['/^(aspir|b|cor|ém|ferm|soupir|trav|vant|vitr)ail$/i', '\1aux'],
-
-        // Bijou, caillou, chou, genou, hibou, joujou et pou qui prennent un x au pluriel
-        ['/^(bij|caill|ch|gen|hib|jouj|p)ou$/i', '\1oux'],
-
-        // Invariable words
-        ['/^(cinquante|soixante|mille)$/i', '\1'],
-
-        // French titles
-        ['/^(mon|ma)(sieur|dame|demoiselle|seigneur)$/', 'mes\2s'],
-        ['/^(Mon|Ma)(sieur|dame|demoiselle|seigneur)$/', 'Mes\2s'],
-    ];
-
-    /**
-     * A list of all rules for singularize.
-     */
-    private const SINGULARIZE_REGEXP = [
-        // First entry: regexp
-        // Second entry: replacement
-
-        // Aspirail, bail, corail, émail, fermail, soupirail, travail, vantail et vitrail font leur pluriel en -aux
-        ['/((aspir|b|cor|ém|ferm|soupir|trav|vant|vitr))aux$/i', '\1ail'],
-
-        // Words finishing with "eau" are pluralized with a "x"
-        // Les mots finissant par "eau" prennent tous un "x" au pluriel
-        ['/(eau)x$/i', '\1'],
-
-        // Words finishing with "al" are pluralized with a "aux" expected
-        // Les mots finissant en "al" se terminent en "aux" sauf
-        ['/(amir|anim|arsen|boc|can|capit|capor|chev|crist|génér|hopit|hôpit|idé|journ|littor|loc|m|mét|minér|princip|radic|termin)aux$/i', '\1al'],
-
-        // Words finishing with "au" are pluralized with a "x" excepted "landau"
-        // Les mots finissant par "au" prennent un "x" au pluriel sauf "landau"
-        ['/(au)x$/i', '\1'],
-
-        // Words finishing with "eu" are pluralized with a "x" excepted "pneu", "bleu", "émeu"
-        // Les mots finissant en "eu" prennent un "x" au pluriel sauf "pneu", "bleu", "émeu"
-        ['/(eu)x$/i', '\1'],
-
-        //  Words finishing with "ou" are pluralized with a "s" excepted bijou, caillou, chou, genou, hibou, joujou, pou
-        // Les mots finissant par "ou" prennent un "s" sauf bijou, caillou, chou, genou, hibou, joujou, pou
-        ['/(bij|caill|ch|gen|hib|jouj|p)oux$/i', '\1ou'],
-
-        // French titles
-        ['/^mes(dame|demoiselle)s$/', 'ma\1'],
-        ['/^Mes(dame|demoiselle)s$/', 'Ma\1'],
-        ['/^mes(sieur|seigneur)s$/', 'mon\1'],
-        ['/^Mes(sieur|seigneur)s$/', 'Mon\1'],
-
-        //Default rule
-        ['/s$/i', ''],
-    ];
-
-    /**
-     * A list of words which should not be inflected.
-     * This list is only used by singularize.
-     */
-    private const UNINFLECTED = '/^(abcès|accès|abus|albatros|anchois|anglais|autobus|bois|brebis|carquois|cas|chas|colis|concours|corps|cours|cyprès|décès|devis|discours|dos|embarras|engrais|entrelacs|excès|fils|fois|gâchis|gars|glas|héros|intrus|jars|jus|kermès|lacis|legs|lilas|marais|mars|matelas|mépris|mets|mois|mors|obus|os|palais|paradis|parcours|pardessus|pays|plusieurs|poids|pois|pouls|printemps|processus|progrès|puits|pus|rabais|radis|recors|recours|refus|relais|remords|remous|rictus|rhinocéros|repas|rubis|sas|secours|sens|souris|succès|talus|tapis|tas|taudis|temps|tiers|univers|velours|verglas|vernis|virus)$/i';
-
-    /**
-     * {@inheritdoc}
-     */
-    public function singularize(string $plural): array
-    {
-        if ($this->isInflectedWord($plural)) {
-            return [$plural];
-        }
-
-        foreach (self::SINGULARIZE_REGEXP as $rule) {
-            [$regexp, $replace] = $rule;
-
-            if (1 === preg_match($regexp, $plural)) {
-                return [preg_replace($regexp, $replace, $plural)];
-            }
-        }
-
-        return [$plural];
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function pluralize(string $singular): array
-    {
-        if ($this->isInflectedWord($singular)) {
-            return [$singular];
-        }
-
-        foreach (self::PLURALIZE_REGEXP as $rule) {
-            [$regexp, $replace] = $rule;
-
-            if (1 === preg_match($regexp, $singular)) {
-                return [preg_replace($regexp, $replace, $singular)];
-            }
-        }
-
-        return [$singular.'s'];
-    }
-
-    private function isInflectedWord(string $word): bool
-    {
-        return 1 === preg_match(self::UNINFLECTED, $word);
-    }
+	/**
+	 * A list of all rules for pluralise.
+	 *
+	 * @see https://la-conjugaison.nouvelobs.com/regles/grammaire/le-pluriel-des-noms-121.php
+	 */
+	private const PLURALIZE_REGEXP = [
+		// First entry: regexp
+		// Second entry: replacement
+
+		// Words finishing with "s", "x" or "z" are invariables
+		// Les mots finissant par "s", "x" ou "z" sont invariables
+		['/(s|x|z)$/i', '\1'],
+
+		// Words finishing with "eau" are pluralized with a "x"
+		// Les mots finissant par "eau" prennent tous un "x" au pluriel
+		['/(eau)$/i', '\1x'],
+
+		// Words finishing with "au" are pluralized with a "x" excepted "landau"
+		// Les mots finissant par "au" prennent un "x" au pluriel sauf "landau"
+		['/^(landau)$/i', '\1s'],
+		['/(au)$/i', '\1x'],
+
+		// Words finishing with "eu" are pluralized with a "x" excepted "pneu", "bleu", "émeu"
+		// Les mots finissant en "eu" prennent un "x" au pluriel sauf "pneu", "bleu", "émeu"
+		['/^(pneu|bleu|émeu)$/i', '\1s'],
+		['/(eu)$/i', '\1x'],
+
+		// Words finishing with "al" are pluralized with a "aux" excepted
+		// Les mots finissant en "al" se terminent en "aux" sauf
+		['/^(bal|carnaval|caracal|chacal|choral|corral|étal|festival|récital|val)$/i', '\1s'],
+		['/al$/i', '\1aux'],
+
+		// Aspirail, bail, corail, émail, fermail, soupirail, travail, vantail et vitrail font leur pluriel en -aux
+		['/^(aspir|b|cor|ém|ferm|soupir|trav|vant|vitr)ail$/i', '\1aux'],
+
+		// Bijou, caillou, chou, genou, hibou, joujou et pou qui prennent un x au pluriel
+		['/^(bij|caill|ch|gen|hib|jouj|p)ou$/i', '\1oux'],
+
+		// Invariable words
+		['/^(cinquante|soixante|mille)$/i', '\1'],
+
+		// French titles
+		['/^(mon|ma)(sieur|dame|demoiselle|seigneur)$/', 'mes\2s'],
+		['/^(Mon|Ma)(sieur|dame|demoiselle|seigneur)$/', 'Mes\2s'],
+	];
+
+	/**
+	 * A list of all rules for singularize.
+	 */
+	private const SINGULARIZE_REGEXP = [
+		// First entry: regexp
+		// Second entry: replacement
+
+		// Aspirail, bail, corail, émail, fermail, soupirail, travail, vantail et vitrail font leur pluriel en -aux
+		['/((aspir|b|cor|ém|ferm|soupir|trav|vant|vitr))aux$/i', '\1ail'],
+
+		// Words finishing with "eau" are pluralized with a "x"
+		// Les mots finissant par "eau" prennent tous un "x" au pluriel
+		['/(eau)x$/i', '\1'],
+
+		// Words finishing with "al" are pluralized with a "aux" expected
+		// Les mots finissant en "al" se terminent en "aux" sauf
+		['/(amir|anim|arsen|boc|can|capit|capor|chev|crist|génér|hopit|hôpit|idé|journ|littor|loc|m|mét|minér|princip|radic|termin)aux$/i', '\1al'],
+
+		// Words finishing with "au" are pluralized with a "x" excepted "landau"
+		// Les mots finissant par "au" prennent un "x" au pluriel sauf "landau"
+		['/(au)x$/i', '\1'],
+
+		// Words finishing with "eu" are pluralized with a "x" excepted "pneu", "bleu", "émeu"
+		// Les mots finissant en "eu" prennent un "x" au pluriel sauf "pneu", "bleu", "émeu"
+		['/(eu)x$/i', '\1'],
+
+		//  Words finishing with "ou" are pluralized with a "s" excepted bijou, caillou, chou, genou, hibou, joujou, pou
+		// Les mots finissant par "ou" prennent un "s" sauf bijou, caillou, chou, genou, hibou, joujou, pou
+		['/(bij|caill|ch|gen|hib|jouj|p)oux$/i', '\1ou'],
+
+		// French titles
+		['/^mes(dame|demoiselle)s$/', 'ma\1'],
+		['/^Mes(dame|demoiselle)s$/', 'Ma\1'],
+		['/^mes(sieur|seigneur)s$/', 'mon\1'],
+		['/^Mes(sieur|seigneur)s$/', 'Mon\1'],
+
+		//Default rule
+		['/s$/i', ''],
+	];
+
+	/**
+	 * A list of words which should not be inflected.
+	 * This list is only used by singularize.
+	 */
+	private const UNINFLECTED = '/^(abcès|accès|abus|albatros|anchois|anglais|autobus|bois|brebis|carquois|cas|chas|colis|concours|corps|cours|cyprès|décès|devis|discours|dos|embarras|engrais|entrelacs|excès|fils|fois|gâchis|gars|glas|héros|intrus|jars|jus|kermès|lacis|legs|lilas|marais|mars|matelas|mépris|mets|mois|mors|obus|os|palais|paradis|parcours|pardessus|pays|plusieurs|poids|pois|pouls|printemps|processus|progrès|puits|pus|rabais|radis|recors|recours|refus|relais|remords|remous|rictus|rhinocéros|repas|rubis|sas|secours|sens|souris|succès|talus|tapis|tas|taudis|temps|tiers|univers|velours|verglas|vernis|virus)$/i';
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function singularize(string $plural): array
+	{
+		if ($this->isInflectedWord($plural)) {
+			return [$plural];
+		}
+
+		foreach (self::SINGULARIZE_REGEXP as $rule) {
+			[$regexp, $replace] = $rule;
+
+			if (1 === preg_match($regexp, $plural)) {
+				return [preg_replace($regexp, $replace, $plural)];
+			}
+		}
+
+		return [$plural];
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function pluralize(string $singular): array
+	{
+		if ($this->isInflectedWord($singular)) {
+			return [$singular];
+		}
+
+		foreach (self::PLURALIZE_REGEXP as $rule) {
+			[$regexp, $replace] = $rule;
+
+			if (1 === preg_match($regexp, $singular)) {
+				return [preg_replace($regexp, $replace, $singular)];
+			}
+		}
+
+		return [$singular.'s'];
+	}
+
+	private function isInflectedWord(string $word): bool
+	{
+		return 1 === preg_match(self::UNINFLECTED, $word);
+	}
 }

vendor/symfony/string/Inflector/InflectorInterface.php

Indentation +16 added lines, -16 removed lines

@@ -13,21 +13,21 @@
 
 interface InflectorInterface
 {
-    /**
-     * Returns the singular forms of a string.
-     *
-     * If the method can't determine the form with certainty, several possible singulars are returned.
-     *
-     * @return string[] An array of possible singular forms
-     */
-    public function singularize(string $plural): array;
+	/**
+	 * Returns the singular forms of a string.
+	 *
+	 * If the method can't determine the form with certainty, several possible singulars are returned.
+	 *
+	 * @return string[] An array of possible singular forms
+	 */
+	public function singularize(string $plural): array;
 
-    /**
-     * Returns the plural forms of a string.
-     *
-     * If the method can't determine the form with certainty, several possible plurals are returned.
-     *
-     * @return string[] An array of possible plural forms
-     */
-    public function pluralize(string $singular): array;
+	/**
+	 * Returns the plural forms of a string.
+	 *
+	 * If the method can't determine the form with certainty, several possible plurals are returned.
+	 *
+	 * @return string[] An array of possible plural forms
+	 */
+	public function pluralize(string $singular): array;
 }

vendor/symfony/string/Inflector/EnglishInflector.php

Indentation +392 added lines, -392 removed lines

@@ -13,496 +13,496 @@
 
 final class EnglishInflector implements InflectorInterface
 {
-    /**
-     * Map English plural to singular suffixes.
-     *
-     * @see http://english-zone.com/spelling/plurals.html
-     */
-    private const PLURAL_MAP = [
-        // First entry: plural suffix, reversed
-        // Second entry: length of plural suffix
-        // Third entry: Whether the suffix may succeed a vocal
-        // Fourth entry: Whether the suffix may succeed a consonant
-        // Fifth entry: singular suffix, normal
+	/**
+	 * Map English plural to singular suffixes.
+	 *
+	 * @see http://english-zone.com/spelling/plurals.html
+	 */
+	private const PLURAL_MAP = [
+		// First entry: plural suffix, reversed
+		// Second entry: length of plural suffix
+		// Third entry: Whether the suffix may succeed a vocal
+		// Fourth entry: Whether the suffix may succeed a consonant
+		// Fifth entry: singular suffix, normal
 
-        // bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
-        ['a', 1, true, true, ['on', 'um']],
+		// bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
+		['a', 1, true, true, ['on', 'um']],
 
-        // nebulae (nebula)
-        ['ea', 2, true, true, 'a'],
+		// nebulae (nebula)
+		['ea', 2, true, true, 'a'],
 
-        // services (service)
-        ['secivres', 8, true, true, 'service'],
+		// services (service)
+		['secivres', 8, true, true, 'service'],
 
-        // mice (mouse), lice (louse)
-        ['eci', 3, false, true, 'ouse'],
+		// mice (mouse), lice (louse)
+		['eci', 3, false, true, 'ouse'],
 
-        // geese (goose)
-        ['esee', 4, false, true, 'oose'],
+		// geese (goose)
+		['esee', 4, false, true, 'oose'],
 
-        // fungi (fungus), alumni (alumnus), syllabi (syllabus), radii (radius)
-        ['i', 1, true, true, 'us'],
+		// fungi (fungus), alumni (alumnus), syllabi (syllabus), radii (radius)
+		['i', 1, true, true, 'us'],
 
-        // men (man), women (woman)
-        ['nem', 3, true, true, 'man'],
+		// men (man), women (woman)
+		['nem', 3, true, true, 'man'],
 
-        // children (child)
-        ['nerdlihc', 8, true, true, 'child'],
+		// children (child)
+		['nerdlihc', 8, true, true, 'child'],
 
-        // oxen (ox)
-        ['nexo', 4, false, false, 'ox'],
+		// oxen (ox)
+		['nexo', 4, false, false, 'ox'],
 
-        // indices (index), appendices (appendix), prices (price)
-        ['seci', 4, false, true, ['ex', 'ix', 'ice']],
+		// indices (index), appendices (appendix), prices (price)
+		['seci', 4, false, true, ['ex', 'ix', 'ice']],
 
-        // selfies (selfie)
-        ['seifles', 7, true, true, 'selfie'],
+		// selfies (selfie)
+		['seifles', 7, true, true, 'selfie'],
 
-        // movies (movie)
-        ['seivom', 6, true, true, 'movie'],
+		// movies (movie)
+		['seivom', 6, true, true, 'movie'],
 
-        // conspectuses (conspectus), prospectuses (prospectus)
-        ['sesutcep', 8, true, true, 'pectus'],
+		// conspectuses (conspectus), prospectuses (prospectus)
+		['sesutcep', 8, true, true, 'pectus'],
 
-        // feet (foot)
-        ['teef', 4, true, true, 'foot'],
+		// feet (foot)
+		['teef', 4, true, true, 'foot'],
 
-        // geese (goose)
-        ['eseeg', 5, true, true, 'goose'],
+		// geese (goose)
+		['eseeg', 5, true, true, 'goose'],
 
-        // teeth (tooth)
-        ['hteet', 5, true, true, 'tooth'],
+		// teeth (tooth)
+		['hteet', 5, true, true, 'tooth'],
 
-        // news (news)
-        ['swen', 4, true, true, 'news'],
+		// news (news)
+		['swen', 4, true, true, 'news'],
 
-        // series (series)
-        ['seires', 6, true, true, 'series'],
+		// series (series)
+		['seires', 6, true, true, 'series'],
 
-        // babies (baby)
-        ['sei', 3, false, true, 'y'],
+		// babies (baby)
+		['sei', 3, false, true, 'y'],
 
-        // accesses (access), addresses (address), kisses (kiss)
-        ['sess', 4, true, false, 'ss'],
+		// accesses (access), addresses (address), kisses (kiss)
+		['sess', 4, true, false, 'ss'],
 
-        // analyses (analysis), ellipses (ellipsis), fungi (fungus),
-        // neuroses (neurosis), theses (thesis), emphases (emphasis),
-        // oases (oasis), crises (crisis), houses (house), bases (base),
-        // atlases (atlas)
-        ['ses', 3, true, true, ['s', 'se', 'sis']],
+		// analyses (analysis), ellipses (ellipsis), fungi (fungus),
+		// neuroses (neurosis), theses (thesis), emphases (emphasis),
+		// oases (oasis), crises (crisis), houses (house), bases (base),
+		// atlases (atlas)
+		['ses', 3, true, true, ['s', 'se', 'sis']],
 
-        // objectives (objective), alternative (alternatives)
-        ['sevit', 5, true, true, 'tive'],
+		// objectives (objective), alternative (alternatives)
+		['sevit', 5, true, true, 'tive'],
 
-        // drives (drive)
-        ['sevird', 6, false, true, 'drive'],
+		// drives (drive)
+		['sevird', 6, false, true, 'drive'],
 
-        // lives (life), wives (wife)
-        ['sevi', 4, false, true, 'ife'],
+		// lives (life), wives (wife)
+		['sevi', 4, false, true, 'ife'],
 
-        // moves (move)
-        ['sevom', 5, true, true, 'move'],
+		// moves (move)
+		['sevom', 5, true, true, 'move'],
 
-        // hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf), caves (cave), staves (staff)
-        ['sev', 3, true, true, ['f', 've', 'ff']],
+		// hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf), caves (cave), staves (staff)
+		['sev', 3, true, true, ['f', 've', 'ff']],
 
-        // axes (axis), axes (ax), axes (axe)
-        ['sexa', 4, false, false, ['ax', 'axe', 'axis']],
+		// axes (axis), axes (ax), axes (axe)
+		['sexa', 4, false, false, ['ax', 'axe', 'axis']],
 
-        // indexes (index), matrixes (matrix)
-        ['sex', 3, true, false, 'x'],
+		// indexes (index), matrixes (matrix)
+		['sex', 3, true, false, 'x'],
 
-        // quizzes (quiz)
-        ['sezz', 4, true, false, 'z'],
+		// quizzes (quiz)
+		['sezz', 4, true, false, 'z'],
 
-        // bureaus (bureau)
-        ['suae', 4, false, true, 'eau'],
+		// bureaus (bureau)
+		['suae', 4, false, true, 'eau'],
 
-        // fees (fee), trees (tree), employees (employee)
-        ['see', 3, true, true, 'ee'],
+		// fees (fee), trees (tree), employees (employee)
+		['see', 3, true, true, 'ee'],
 
-        // edges (edge)
-        ['segd', 4, true, true, 'dge'],
+		// edges (edge)
+		['segd', 4, true, true, 'dge'],
 
-        // roses (rose), garages (garage), cassettes (cassette),
-        // waltzes (waltz), heroes (hero), bushes (bush), arches (arch),
-        // shoes (shoe)
-        ['se', 2, true, true, ['', 'e']],
+		// roses (rose), garages (garage), cassettes (cassette),
+		// waltzes (waltz), heroes (hero), bushes (bush), arches (arch),
+		// shoes (shoe)
+		['se', 2, true, true, ['', 'e']],
 
-        // tags (tag)
-        ['s', 1, true, true, ''],
+		// tags (tag)
+		['s', 1, true, true, ''],
 
-        // chateaux (chateau)
-        ['xuae', 4, false, true, 'eau'],
+		// chateaux (chateau)
+		['xuae', 4, false, true, 'eau'],
 
-        // people (person)
-        ['elpoep', 6, true, true, 'person'],
-    ];
+		// people (person)
+		['elpoep', 6, true, true, 'person'],
+	];
 
-    /**
-     * Map English singular to plural suffixes.
-     *
-     * @see http://english-zone.com/spelling/plurals.html
-     */
-    private const SINGULAR_MAP = [
-        // First entry: singular suffix, reversed
-        // Second entry: length of singular suffix
-        // Third entry: Whether the suffix may succeed a vocal
-        // Fourth entry: Whether the suffix may succeed a consonant
-        // Fifth entry: plural suffix, normal
+	/**
+	 * Map English singular to plural suffixes.
+	 *
+	 * @see http://english-zone.com/spelling/plurals.html
+	 */
+	private const SINGULAR_MAP = [
+		// First entry: singular suffix, reversed
+		// Second entry: length of singular suffix
+		// Third entry: Whether the suffix may succeed a vocal
+		// Fourth entry: Whether the suffix may succeed a consonant
+		// Fifth entry: plural suffix, normal
 
-        // criterion (criteria)
-        ['airetirc', 8, false, false, 'criterion'],
+		// criterion (criteria)
+		['airetirc', 8, false, false, 'criterion'],
 
-        // nebulae (nebula)
-        ['aluben', 6, false, false, 'nebulae'],
+		// nebulae (nebula)
+		['aluben', 6, false, false, 'nebulae'],
 
-        // children (child)
-        ['dlihc', 5, true, true, 'children'],
+		// children (child)
+		['dlihc', 5, true, true, 'children'],
 
-        // prices (price)
-        ['eci', 3, false, true, 'ices'],
+		// prices (price)
+		['eci', 3, false, true, 'ices'],
 
-        // services (service)
-        ['ecivres', 7, true, true, 'services'],
+		// services (service)
+		['ecivres', 7, true, true, 'services'],
 
-        // lives (life), wives (wife)
-        ['efi', 3, false, true, 'ives'],
+		// lives (life), wives (wife)
+		['efi', 3, false, true, 'ives'],
 
-        // selfies (selfie)
-        ['eifles', 6, true, true, 'selfies'],
+		// selfies (selfie)
+		['eifles', 6, true, true, 'selfies'],
 
-        // movies (movie)
-        ['eivom', 5, true, true, 'movies'],
+		// movies (movie)
+		['eivom', 5, true, true, 'movies'],
 
-        // lice (louse)
-        ['esuol', 5, false, true, 'lice'],
+		// lice (louse)
+		['esuol', 5, false, true, 'lice'],
 
-        // mice (mouse)
-        ['esuom', 5, false, true, 'mice'],
+		// mice (mouse)
+		['esuom', 5, false, true, 'mice'],
 
-        // geese (goose)
-        ['esoo', 4, false, true, 'eese'],
+		// geese (goose)
+		['esoo', 4, false, true, 'eese'],
 
-        // houses (house), bases (base)
-        ['es', 2, true, true, 'ses'],
+		// houses (house), bases (base)
+		['es', 2, true, true, 'ses'],
 
-        // geese (goose)
-        ['esoog', 5, true, true, 'geese'],
+		// geese (goose)
+		['esoog', 5, true, true, 'geese'],
 
-        // caves (cave)
-        ['ev', 2, true, true, 'ves'],
+		// caves (cave)
+		['ev', 2, true, true, 'ves'],
 
-        // drives (drive)
-        ['evird', 5, false, true, 'drives'],
+		// drives (drive)
+		['evird', 5, false, true, 'drives'],
 
-        // objectives (objective), alternative (alternatives)
-        ['evit', 4, true, true, 'tives'],
+		// objectives (objective), alternative (alternatives)
+		['evit', 4, true, true, 'tives'],
 
-        // moves (move)
-        ['evom', 4, true, true, 'moves'],
+		// moves (move)
+		['evom', 4, true, true, 'moves'],
 
-        // staves (staff)
-        ['ffats', 5, true, true, 'staves'],
+		// staves (staff)
+		['ffats', 5, true, true, 'staves'],
 
-        // hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf)
-        ['ff', 2, true, true, 'ffs'],
+		// hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf)
+		['ff', 2, true, true, 'ffs'],
 
-        // hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf)
-        ['f', 1, true, true, ['fs', 'ves']],
+		// hooves (hoof), dwarves (dwarf), elves (elf), leaves (leaf)
+		['f', 1, true, true, ['fs', 'ves']],
 
-        // arches (arch)
-        ['hc', 2, true, true, 'ches'],
+		// arches (arch)
+		['hc', 2, true, true, 'ches'],
 
-        // bushes (bush)
-        ['hs', 2, true, true, 'shes'],
+		// bushes (bush)
+		['hs', 2, true, true, 'shes'],
 
-        // teeth (tooth)
-        ['htoot', 5, true, true, 'teeth'],
+		// teeth (tooth)
+		['htoot', 5, true, true, 'teeth'],
 
-        // bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
-        ['mu', 2, true, true, 'a'],
+		// bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
+		['mu', 2, true, true, 'a'],
 
-        // men (man), women (woman)
-        ['nam', 3, true, true, 'men'],
+		// men (man), women (woman)
+		['nam', 3, true, true, 'men'],
 
-        // people (person)
-        ['nosrep', 6, true, true, ['persons', 'people']],
+		// people (person)
+		['nosrep', 6, true, true, ['persons', 'people']],
 
-        // bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
-        ['noi', 3, true, true, 'ions'],
+		// bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
+		['noi', 3, true, true, 'ions'],
 
-        // coupon (coupons)
-        ['nop', 3, true, true, 'pons'],
+		// coupon (coupons)
+		['nop', 3, true, true, 'pons'],
 
-        // seasons (season), treasons (treason), poisons (poison), lessons (lesson)
-        ['nos', 3, true, true, 'sons'],
+		// seasons (season), treasons (treason), poisons (poison), lessons (lesson)
+		['nos', 3, true, true, 'sons'],
 
-        // bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
-        ['no', 2, true, true, 'a'],
+		// bacteria (bacterium), criteria (criterion), phenomena (phenomenon)
+		['no', 2, true, true, 'a'],
 
-        // echoes (echo)
-        ['ohce', 4, true, true, 'echoes'],
+		// echoes (echo)
+		['ohce', 4, true, true, 'echoes'],
 
-        // heroes (hero)
-        ['oreh', 4, true, true, 'heroes'],
+		// heroes (hero)
+		['oreh', 4, true, true, 'heroes'],
 
-        // atlases (atlas)
-        ['salta', 5, true, true, 'atlases'],
+		// atlases (atlas)
+		['salta', 5, true, true, 'atlases'],
 
-        // irises (iris)
-        ['siri', 4, true, true, 'irises'],
+		// irises (iris)
+		['siri', 4, true, true, 'irises'],
 
-        // analyses (analysis), ellipses (ellipsis), neuroses (neurosis)
-        // theses (thesis), emphases (emphasis), oases (oasis),
-        // crises (crisis)
-        ['sis', 3, true, true, 'ses'],
+		// analyses (analysis), ellipses (ellipsis), neuroses (neurosis)
+		// theses (thesis), emphases (emphasis), oases (oasis),
+		// crises (crisis)
+		['sis', 3, true, true, 'ses'],
 
-        // accesses (access), addresses (address), kisses (kiss)
-        ['ss', 2, true, false, 'sses'],
+		// accesses (access), addresses (address), kisses (kiss)
+		['ss', 2, true, false, 'sses'],
 
-        // syllabi (syllabus)
-        ['suballys', 8, true, true, 'syllabi'],
+		// syllabi (syllabus)
+		['suballys', 8, true, true, 'syllabi'],
 
-        // buses (bus)
-        ['sub', 3, true, true, 'buses'],
+		// buses (bus)
+		['sub', 3, true, true, 'buses'],
 
-        // circuses (circus)
-        ['suc', 3, true, true, 'cuses'],
+		// circuses (circus)
+		['suc', 3, true, true, 'cuses'],
 
-        // conspectuses (conspectus), prospectuses (prospectus)
-        ['sutcep', 6, true, true, 'pectuses'],
+		// conspectuses (conspectus), prospectuses (prospectus)
+		['sutcep', 6, true, true, 'pectuses'],
 
-        // fungi (fungus), alumni (alumnus), syllabi (syllabus), radii (radius)
-        ['su', 2, true, true, 'i'],
+		// fungi (fungus), alumni (alumnus), syllabi (syllabus), radii (radius)
+		['su', 2, true, true, 'i'],
 
-        // news (news)
-        ['swen', 4, true, true, 'news'],
+		// news (news)
+		['swen', 4, true, true, 'news'],
 
-        // feet (foot)
-        ['toof', 4, true, true, 'feet'],
+		// feet (foot)
+		['toof', 4, true, true, 'feet'],
 
-        // chateaux (chateau), bureaus (bureau)
-        ['uae', 3, false, true, ['eaus', 'eaux']],
+		// chateaux (chateau), bureaus (bureau)
+		['uae', 3, false, true, ['eaus', 'eaux']],
 
-        // oxen (ox)
-        ['xo', 2, false, false, 'oxen'],
+		// oxen (ox)
+		['xo', 2, false, false, 'oxen'],
 
-        // hoaxes (hoax)
-        ['xaoh', 4, true, false, 'hoaxes'],
+		// hoaxes (hoax)
+		['xaoh', 4, true, false, 'hoaxes'],
 
-        // indices (index)
-        ['xedni', 5, false, true, ['indicies', 'indexes']],
+		// indices (index)
+		['xedni', 5, false, true, ['indicies', 'indexes']],
 
-        // boxes (box)
-        ['xo', 2, false, true, 'oxes'],
+		// boxes (box)
+		['xo', 2, false, true, 'oxes'],
 
-        // indexes (index), matrixes (matrix)
-        ['x', 1, true, false, ['cies', 'xes']],
+		// indexes (index), matrixes (matrix)
+		['x', 1, true, false, ['cies', 'xes']],
 
-        // appendices (appendix)
-        ['xi', 2, false, true, 'ices'],
+		// appendices (appendix)
+		['xi', 2, false, true, 'ices'],
 
-        // babies (baby)
-        ['y', 1, false, true, 'ies'],
+		// babies (baby)
+		['y', 1, false, true, 'ies'],
 
-        // quizzes (quiz)
-        ['ziuq', 4, true, false, 'quizzes'],
+		// quizzes (quiz)
+		['ziuq', 4, true, false, 'quizzes'],
 
-        // waltzes (waltz)
-        ['z', 1, true, true, 'zes'],
-    ];
+		// waltzes (waltz)
+		['z', 1, true, true, 'zes'],
+	];
 
-    /**
-     * A list of words which should not be inflected, reversed.
-     */
-    private const UNINFLECTED = [
-        '',
+	/**
+	 * A list of words which should not be inflected, reversed.
+	 */
+	private const UNINFLECTED = [
+		'',
 
-        // data
-        'atad',
+		// data
+		'atad',
 
-        // deer
-        'reed',
+		// deer
+		'reed',
 
-        // feedback
-        'kcabdeef',
+		// feedback
+		'kcabdeef',
 
-        // fish
-        'hsif',
+		// fish
+		'hsif',
 
-        // info
-        'ofni',
+		// info
+		'ofni',
 
-        // moose
-        'esoom',
+		// moose
+		'esoom',
 
-        // series
-        'seires',
+		// series
+		'seires',
 
-        // sheep
-        'peehs',
+		// sheep
+		'peehs',
 
-        // species
-        'seiceps',
-    ];
-
-    /**
-     * {@inheritdoc}
-     */
-    public function singularize(string $plural): array
-    {
-        $pluralRev = strrev($plural);
-        $lowerPluralRev = strtolower($pluralRev);
-        $pluralLength = \strlen($lowerPluralRev);
-
-        // Check if the word is one which is not inflected, return early if so
-        if (\in_array($lowerPluralRev, self::UNINFLECTED, true)) {
-            return [$plural];
-        }
-
-        // The outer loop iterates over the entries of the plural table
-        // The inner loop $j iterates over the characters of the plural suffix
-        // in the plural table to compare them with the characters of the actual
-        // given plural suffix
-        foreach (self::PLURAL_MAP as $map) {
-            $suffix = $map[0];
-            $suffixLength = $map[1];
-            $j = 0;
-
-            // Compare characters in the plural table and of the suffix of the
-            // given plural one by one
-            while ($suffix[$j] === $lowerPluralRev[$j]) {
-                // Let $j point to the next character
-                ++$j;
-
-                // Successfully compared the last character
-                // Add an entry with the singular suffix to the singular array
-                if ($j === $suffixLength) {
-                    // Is there any character preceding the suffix in the plural string?
-                    if ($j < $pluralLength) {
-                        $nextIsVocal = false !== strpos('aeiou', $lowerPluralRev[$j]);
-
-                        if (!$map[2] && $nextIsVocal) {
-                            // suffix may not succeed a vocal but next char is one
-                            break;
-                        }
-
-                        if (!$map[3] && !$nextIsVocal) {
-                            // suffix may not succeed a consonant but next char is one
-                            break;
-                        }
-                    }
-
-                    $newBase = substr($plural, 0, $pluralLength - $suffixLength);
-                    $newSuffix = $map[4];
-
-                    // Check whether the first character in the plural suffix
-                    // is uppercased. If yes, uppercase the first character in
-                    // the singular suffix too
-                    $firstUpper = ctype_upper($pluralRev[$j - 1]);
-
-                    if (\is_array($newSuffix)) {
-                        $singulars = [];
-
-                        foreach ($newSuffix as $newSuffixEntry) {
-                            $singulars[] = $newBase.($firstUpper ? ucfirst($newSuffixEntry) : $newSuffixEntry);
-                        }
-
-                        return $singulars;
-                    }
-
-                    return [$newBase.($firstUpper ? ucfirst($newSuffix) : $newSuffix)];
-                }
-
-                // Suffix is longer than word
-                if ($j === $pluralLength) {
-                    break;
-                }
-            }
-        }
-
-        // Assume that plural and singular is identical
-        return [$plural];
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function pluralize(string $singular): array
-    {
-        $singularRev = strrev($singular);
-        $lowerSingularRev = strtolower($singularRev);
-        $singularLength = \strlen($lowerSingularRev);
-
-        // Check if the word is one which is not inflected, return early if so
-        if (\in_array($lowerSingularRev, self::UNINFLECTED, true)) {
-            return [$singular];
-        }
-
-        // The outer loop iterates over the entries of the singular table
-        // The inner loop $j iterates over the characters of the singular suffix
-        // in the singular table to compare them with the characters of the actual
-        // given singular suffix
-        foreach (self::SINGULAR_MAP as $map) {
-            $suffix = $map[0];
-            $suffixLength = $map[1];
-            $j = 0;
-
-            // Compare characters in the singular table and of the suffix of the
-            // given plural one by one
-
-            while ($suffix[$j] === $lowerSingularRev[$j]) {
-                // Let $j point to the next character
-                ++$j;
-
-                // Successfully compared the last character
-                // Add an entry with the plural suffix to the plural array
-                if ($j === $suffixLength) {
-                    // Is there any character preceding the suffix in the plural string?
-                    if ($j < $singularLength) {
-                        $nextIsVocal = false !== strpos('aeiou', $lowerSingularRev[$j]);
-
-                        if (!$map[2] && $nextIsVocal) {
-                            // suffix may not succeed a vocal but next char is one
-                            break;
-                        }
-
-                        if (!$map[3] && !$nextIsVocal) {
-                            // suffix may not succeed a consonant but next char is one
-                            break;
-                        }
-                    }
-
-                    $newBase = substr($singular, 0, $singularLength - $suffixLength);
-                    $newSuffix = $map[4];
-
-                    // Check whether the first character in the singular suffix
-                    // is uppercased. If yes, uppercase the first character in
-                    // the singular suffix too
-                    $firstUpper = ctype_upper($singularRev[$j - 1]);
-
-                    if (\is_array($newSuffix)) {
-                        $plurals = [];
-
-                        foreach ($newSuffix as $newSuffixEntry) {
-                            $plurals[] = $newBase.($firstUpper ? ucfirst($newSuffixEntry) : $newSuffixEntry);
-                        }
-
-                        return $plurals;
-                    }
-
-                    return [$newBase.($firstUpper ? ucfirst($newSuffix) : $newSuffix)];
-                }
-
-                // Suffix is longer than word
-                if ($j === $singularLength) {
-                    break;
-                }
-            }
-        }
-
-        // Assume that plural is singular with a trailing `s`
-        return [$singular.'s'];
-    }
+		// species
+		'seiceps',
+	];
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function singularize(string $plural): array
+	{
+		$pluralRev = strrev($plural);
+		$lowerPluralRev = strtolower($pluralRev);
+		$pluralLength = \strlen($lowerPluralRev);
+
+		// Check if the word is one which is not inflected, return early if so
+		if (\in_array($lowerPluralRev, self::UNINFLECTED, true)) {
+			return [$plural];
+		}
+
+		// The outer loop iterates over the entries of the plural table
+		// The inner loop $j iterates over the characters of the plural suffix
+		// in the plural table to compare them with the characters of the actual
+		// given plural suffix
+		foreach (self::PLURAL_MAP as $map) {
+			$suffix = $map[0];
+			$suffixLength = $map[1];
+			$j = 0;
+
+			// Compare characters in the plural table and of the suffix of the
+			// given plural one by one
+			while ($suffix[$j] === $lowerPluralRev[$j]) {
+				// Let $j point to the next character
+				++$j;
+
+				// Successfully compared the last character
+				// Add an entry with the singular suffix to the singular array
+				if ($j === $suffixLength) {
+					// Is there any character preceding the suffix in the plural string?
+					if ($j < $pluralLength) {
+						$nextIsVocal = false !== strpos('aeiou', $lowerPluralRev[$j]);
+
+						if (!$map[2] && $nextIsVocal) {
+							// suffix may not succeed a vocal but next char is one
+							break;
+						}
+
+						if (!$map[3] && !$nextIsVocal) {
+							// suffix may not succeed a consonant but next char is one
+							break;
+						}
+					}
+
+					$newBase = substr($plural, 0, $pluralLength - $suffixLength);
+					$newSuffix = $map[4];
+
+					// Check whether the first character in the plural suffix
+					// is uppercased. If yes, uppercase the first character in
+					// the singular suffix too
+					$firstUpper = ctype_upper($pluralRev[$j - 1]);
+
+					if (\is_array($newSuffix)) {
+						$singulars = [];
+
+						foreach ($newSuffix as $newSuffixEntry) {
+							$singulars[] = $newBase.($firstUpper ? ucfirst($newSuffixEntry) : $newSuffixEntry);
+						}
+
+						return $singulars;
+					}
+
+					return [$newBase.($firstUpper ? ucfirst($newSuffix) : $newSuffix)];
+				}
+
+				// Suffix is longer than word
+				if ($j === $pluralLength) {
+					break;
+				}
+			}
+		}
+
+		// Assume that plural and singular is identical
+		return [$plural];
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function pluralize(string $singular): array
+	{
+		$singularRev = strrev($singular);
+		$lowerSingularRev = strtolower($singularRev);
+		$singularLength = \strlen($lowerSingularRev);
+
+		// Check if the word is one which is not inflected, return early if so
+		if (\in_array($lowerSingularRev, self::UNINFLECTED, true)) {
+			return [$singular];
+		}
+
+		// The outer loop iterates over the entries of the singular table
+		// The inner loop $j iterates over the characters of the singular suffix
+		// in the singular table to compare them with the characters of the actual
+		// given singular suffix
+		foreach (self::SINGULAR_MAP as $map) {
+			$suffix = $map[0];
+			$suffixLength = $map[1];
+			$j = 0;
+
+			// Compare characters in the singular table and of the suffix of the
+			// given plural one by one
+
+			while ($suffix[$j] === $lowerSingularRev[$j]) {
+				// Let $j point to the next character
+				++$j;
+
+				// Successfully compared the last character
+				// Add an entry with the plural suffix to the plural array
+				if ($j === $suffixLength) {
+					// Is there any character preceding the suffix in the plural string?
+					if ($j < $singularLength) {
+						$nextIsVocal = false !== strpos('aeiou', $lowerSingularRev[$j]);
+
+						if (!$map[2] && $nextIsVocal) {
+							// suffix may not succeed a vocal but next char is one
+							break;
+						}
+
+						if (!$map[3] && !$nextIsVocal) {
+							// suffix may not succeed a consonant but next char is one
+							break;
+						}
+					}
+
+					$newBase = substr($singular, 0, $singularLength - $suffixLength);
+					$newSuffix = $map[4];
+
+					// Check whether the first character in the singular suffix
+					// is uppercased. If yes, uppercase the first character in
+					// the singular suffix too
+					$firstUpper = ctype_upper($singularRev[$j - 1]);
+
+					if (\is_array($newSuffix)) {
+						$plurals = [];
+
+						foreach ($newSuffix as $newSuffixEntry) {
+							$plurals[] = $newBase.($firstUpper ? ucfirst($newSuffixEntry) : $newSuffixEntry);
+						}
+
+						return $plurals;
+					}
+
+					return [$newBase.($firstUpper ? ucfirst($newSuffix) : $newSuffix)];
+				}
+
+				// Suffix is longer than word
+				if ($j === $singularLength) {
+					break;
+				}
+			}
+		}
+
+		// Assume that plural is singular with a trailing `s`
+		return [$singular.'s'];
+	}
 }

vendor/symfony/filesystem/Exception/FileNotFoundException.php

Indentation +11 added lines, -11 removed lines

@@ -19,16 +19,16 @@
  */
 class FileNotFoundException extends IOException
 {
-    public function __construct(string $message = null, int $code = 0, \Throwable $previous = null, string $path = null)
-    {
-        if (null === $message) {
-            if (null === $path) {
-                $message = 'File could not be found.';
-            } else {
-                $message = sprintf('File "%s" could not be found.', $path);
-            }
-        }
+	public function __construct(string $message = null, int $code = 0, \Throwable $previous = null, string $path = null)
+	{
+		if (null === $message) {
+			if (null === $path) {
+				$message = 'File could not be found.';
+			} else {
+				$message = sprintf('File "%s" could not be found.', $path);
+			}
+		}
 
-        parent::__construct($message, $code, $previous, $path);
-    }
+		parent::__construct($message, $code, $previous, $path);
+	}
 }

vendor/symfony/filesystem/Exception/IOException.php

Indentation +13 added lines, -13 removed lines

@@ -20,20 +20,20 @@
  */
 class IOException extends \RuntimeException implements IOExceptionInterface
 {
-    private $path;
+	private $path;
 
-    public function __construct(string $message, int $code = 0, \Throwable $previous = null, string $path = null)
-    {
-        $this->path = $path;
+	public function __construct(string $message, int $code = 0, \Throwable $previous = null, string $path = null)
+	{
+		$this->path = $path;
 
-        parent::__construct($message, $code, $previous);
-    }
+		parent::__construct($message, $code, $previous);
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    public function getPath()
-    {
-        return $this->path;
-    }
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getPath()
+	{
+		return $this->path;
+	}
 }

vendor/symfony/filesystem/Exception/IOExceptionInterface.php

Indentation +6 added lines, -6 removed lines

@@ -18,10 +18,10 @@
  */
 interface IOExceptionInterface extends ExceptionInterface
 {
-    /**
-     * Returns the associated path for the exception.
-     *
-     * @return string|null The path
-     */
-    public function getPath();
+	/**
+	 * Returns the associated path for the exception.
+	 *
+	 * @return string|null The path
+	 */
+	public function getPath();
 }

vendor/symfony/filesystem/Filesystem.php

Indentation +733 added lines, -733 removed lines

@@ -22,737 +22,737 @@
  */
 class Filesystem
 {
-    private static $lastError;
-
-    /**
-     * Copies a file.
-     *
-     * If the target file is older than the origin file, it's always overwritten.
-     * If the target file is newer, it is overwritten only when the
-     * $overwriteNewerFiles option is set to true.
-     *
-     * @throws FileNotFoundException When originFile doesn't exist
-     * @throws IOException           When copy fails
-     */
-    public function copy(string $originFile, string $targetFile, bool $overwriteNewerFiles = false)
-    {
-        $originIsLocal = stream_is_local($originFile) || 0 === stripos($originFile, 'file://');
-        if ($originIsLocal && !is_file($originFile)) {
-            throw new FileNotFoundException(sprintf('Failed to copy "%s" because file does not exist.', $originFile), 0, null, $originFile);
-        }
-
-        $this->mkdir(\dirname($targetFile));
-
-        $doCopy = true;
-        if (!$overwriteNewerFiles && null === parse_url($originFile, \PHP_URL_HOST) && is_file($targetFile)) {
-            $doCopy = filemtime($originFile) > filemtime($targetFile);
-        }
-
-        if ($doCopy) {
-            // https://bugs.php.net/64634
-            if (!$source = self::box('fopen', $originFile, 'r')) {
-                throw new IOException(sprintf('Failed to copy "%s" to "%s" because source file could not be opened for reading: ', $originFile, $targetFile).self::$lastError, 0, null, $originFile);
-            }
-
-            // Stream context created to allow files overwrite when using FTP stream wrapper - disabled by default
-            if (!$target = self::box('fopen', $targetFile, 'w', false, stream_context_create(['ftp' => ['overwrite' => true]]))) {
-                throw new IOException(sprintf('Failed to copy "%s" to "%s" because target file could not be opened for writing: ', $originFile, $targetFile).self::$lastError, 0, null, $originFile);
-            }
-
-            $bytesCopied = stream_copy_to_stream($source, $target);
-            fclose($source);
-            fclose($target);
-            unset($source, $target);
-
-            if (!is_file($targetFile)) {
-                throw new IOException(sprintf('Failed to copy "%s" to "%s".', $originFile, $targetFile), 0, null, $originFile);
-            }
-
-            if ($originIsLocal) {
-                // Like `cp`, preserve executable permission bits
-                self::box('chmod', $targetFile, fileperms($targetFile) | (fileperms($originFile) & 0111));
-
-                if ($bytesCopied !== $bytesOrigin = filesize($originFile)) {
-                    throw new IOException(sprintf('Failed to copy the whole content of "%s" to "%s" (%g of %g bytes copied).', $originFile, $targetFile, $bytesCopied, $bytesOrigin), 0, null, $originFile);
-                }
-            }
-        }
-    }
-
-    /**
-     * Creates a directory recursively.
-     *
-     * @param string|iterable $dirs The directory path
-     *
-     * @throws IOException On any directory creation failure
-     */
-    public function mkdir($dirs, int $mode = 0777)
-    {
-        foreach ($this->toIterable($dirs) as $dir) {
-            if (is_dir($dir)) {
-                continue;
-            }
-
-            if (!self::box('mkdir', $dir, $mode, true) && !is_dir($dir)) {
-                throw new IOException(sprintf('Failed to create "%s": ', $dir).self::$lastError, 0, null, $dir);
-            }
-        }
-    }
-
-    /**
-     * Checks the existence of files or directories.
-     *
-     * @param string|iterable $files A filename, an array of files, or a \Traversable instance to check
-     *
-     * @return bool true if the file exists, false otherwise
-     */
-    public function exists($files)
-    {
-        $maxPathLength = \PHP_MAXPATHLEN - 2;
-
-        foreach ($this->toIterable($files) as $file) {
-            if (\strlen($file) > $maxPathLength) {
-                throw new IOException(sprintf('Could not check if file exist because path length exceeds %d characters.', $maxPathLength), 0, null, $file);
-            }
-
-            if (!file_exists($file)) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    /**
-     * Sets access and modification time of file.
-     *
-     * @param string|iterable $files A filename, an array of files, or a \Traversable instance to create
-     * @param int|null        $time  The touch time as a Unix timestamp, if not supplied the current system time is used
-     * @param int|null        $atime The access time as a Unix timestamp, if not supplied the current system time is used
-     *
-     * @throws IOException When touch fails
-     */
-    public function touch($files, int $time = null, int $atime = null)
-    {
-        foreach ($this->toIterable($files) as $file) {
-            if (!($time ? self::box('touch', $file, $time, $atime) : self::box('touch', $file))) {
-                throw new IOException(sprintf('Failed to touch "%s": ', $file).self::$lastError, 0, null, $file);
-            }
-        }
-    }
-
-    /**
-     * Removes files or directories.
-     *
-     * @param string|iterable $files A filename, an array of files, or a \Traversable instance to remove
-     *
-     * @throws IOException When removal fails
-     */
-    public function remove($files)
-    {
-        if ($files instanceof \Traversable) {
-            $files = iterator_to_array($files, false);
-        } elseif (!\is_array($files)) {
-            $files = [$files];
-        }
-
-        self::doRemove($files, false);
-    }
-
-    private static function doRemove(array $files, bool $isRecursive): void
-    {
-        $files = array_reverse($files);
-        foreach ($files as $file) {
-            if (is_link($file)) {
-                // See https://bugs.php.net/52176
-                if (!(self::box('unlink', $file) || '\\' !== \DIRECTORY_SEPARATOR || self::box('rmdir', $file)) && file_exists($file)) {
-                    throw new IOException(sprintf('Failed to remove symlink "%s": ', $file).self::$lastError);
-                }
-            } elseif (is_dir($file)) {
-                if (!$isRecursive) {
-                    $tmpName = \dirname(realpath($file)).'/.'.strrev(strtr(base64_encode(random_bytes(2)), '/=', '-.'));
-
-                    if (file_exists($tmpName)) {
-                        try {
-                            self::doRemove([$tmpName], true);
-                        } catch (IOException $e) {
-                        }
-                    }
-
-                    if (!file_exists($tmpName) && self::box('rename', $file, $tmpName)) {
-                        $origFile = $file;
-                        $file = $tmpName;
-                    } else {
-                        $origFile = null;
-                    }
-                }
-
-                $files = new \FilesystemIterator($file, \FilesystemIterator::CURRENT_AS_PATHNAME | \FilesystemIterator::SKIP_DOTS);
-                self::doRemove(iterator_to_array($files, true), true);
-
-                if (!self::box('rmdir', $file) && file_exists($file) && !$isRecursive) {
-                    $lastError = self::$lastError;
-
-                    if (null !== $origFile && self::box('rename', $file, $origFile)) {
-                        $file = $origFile;
-                    }
-
-                    throw new IOException(sprintf('Failed to remove directory "%s": ', $file).$lastError);
-                }
-            } elseif (!self::box('unlink', $file) && (str_contains(self::$lastError, 'Permission denied') || file_exists($file))) {
-                throw new IOException(sprintf('Failed to remove file "%s": ', $file).self::$lastError);
-            }
-        }
-    }
-
-    /**
-     * Change mode for an array of files or directories.
-     *
-     * @param string|iterable $files     A filename, an array of files, or a \Traversable instance to change mode
-     * @param int             $mode      The new mode (octal)
-     * @param int             $umask     The mode mask (octal)
-     * @param bool            $recursive Whether change the mod recursively or not
-     *
-     * @throws IOException When the change fails
-     */
-    public function chmod($files, int $mode, int $umask = 0000, bool $recursive = false)
-    {
-        foreach ($this->toIterable($files) as $file) {
-            if ((\PHP_VERSION_ID < 80000 || \is_int($mode)) && !self::box('chmod', $file, $mode & ~$umask)) {
-                throw new IOException(sprintf('Failed to chmod file "%s": ', $file).self::$lastError, 0, null, $file);
-            }
-            if ($recursive && is_dir($file) && !is_link($file)) {
-                $this->chmod(new \FilesystemIterator($file), $mode, $umask, true);
-            }
-        }
-    }
-
-    /**
-     * Change the owner of an array of files or directories.
-     *
-     * @param string|iterable $files     A filename, an array of files, or a \Traversable instance to change owner
-     * @param string|int      $user      A user name or number
-     * @param bool            $recursive Whether change the owner recursively or not
-     *
-     * @throws IOException When the change fails
-     */
-    public function chown($files, $user, bool $recursive = false)
-    {
-        foreach ($this->toIterable($files) as $file) {
-            if ($recursive && is_dir($file) && !is_link($file)) {
-                $this->chown(new \FilesystemIterator($file), $user, true);
-            }
-            if (is_link($file) && \function_exists('lchown')) {
-                if (!self::box('lchown', $file, $user)) {
-                    throw new IOException(sprintf('Failed to chown file "%s": ', $file).self::$lastError, 0, null, $file);
-                }
-            } else {
-                if (!self::box('chown', $file, $user)) {
-                    throw new IOException(sprintf('Failed to chown file "%s": ', $file).self::$lastError, 0, null, $file);
-                }
-            }
-        }
-    }
-
-    /**
-     * Change the group of an array of files or directories.
-     *
-     * @param string|iterable $files     A filename, an array of files, or a \Traversable instance to change group
-     * @param string|int      $group     A group name or number
-     * @param bool            $recursive Whether change the group recursively or not
-     *
-     * @throws IOException When the change fails
-     */
-    public function chgrp($files, $group, bool $recursive = false)
-    {
-        foreach ($this->toIterable($files) as $file) {
-            if ($recursive && is_dir($file) && !is_link($file)) {
-                $this->chgrp(new \FilesystemIterator($file), $group, true);
-            }
-            if (is_link($file) && \function_exists('lchgrp')) {
-                if (!self::box('lchgrp', $file, $group)) {
-                    throw new IOException(sprintf('Failed to chgrp file "%s": ', $file).self::$lastError, 0, null, $file);
-                }
-            } else {
-                if (!self::box('chgrp', $file, $group)) {
-                    throw new IOException(sprintf('Failed to chgrp file "%s": ', $file).self::$lastError, 0, null, $file);
-                }
-            }
-        }
-    }
-
-    /**
-     * Renames a file or a directory.
-     *
-     * @throws IOException When target file or directory already exists
-     * @throws IOException When origin cannot be renamed
-     */
-    public function rename(string $origin, string $target, bool $overwrite = false)
-    {
-        // we check that target does not exist
-        if (!$overwrite && $this->isReadable($target)) {
-            throw new IOException(sprintf('Cannot rename because the target "%s" already exists.', $target), 0, null, $target);
-        }
-
-        if (!self::box('rename', $origin, $target)) {
-            if (is_dir($origin)) {
-                // See https://bugs.php.net/54097 & https://php.net/rename#113943
-                $this->mirror($origin, $target, null, ['override' => $overwrite, 'delete' => $overwrite]);
-                $this->remove($origin);
-
-                return;
-            }
-            throw new IOException(sprintf('Cannot rename "%s" to "%s": ', $origin, $target).self::$lastError, 0, null, $target);
-        }
-    }
-
-    /**
-     * Tells whether a file exists and is readable.
-     *
-     * @throws IOException When windows path is longer than 258 characters
-     */
-    private function isReadable(string $filename): bool
-    {
-        $maxPathLength = \PHP_MAXPATHLEN - 2;
-
-        if (\strlen($filename) > $maxPathLength) {
-            throw new IOException(sprintf('Could not check if file is readable because path length exceeds %d characters.', $maxPathLength), 0, null, $filename);
-        }
-
-        return is_readable($filename);
-    }
-
-    /**
-     * Creates a symbolic link or copy a directory.
-     *
-     * @throws IOException When symlink fails
-     */
-    public function symlink(string $originDir, string $targetDir, bool $copyOnWindows = false)
-    {
-        if ('\\' === \DIRECTORY_SEPARATOR) {
-            $originDir = strtr($originDir, '/', '\\');
-            $targetDir = strtr($targetDir, '/', '\\');
-
-            if ($copyOnWindows) {
-                $this->mirror($originDir, $targetDir);
-
-                return;
-            }
-        }
-
-        $this->mkdir(\dirname($targetDir));
-
-        if (is_link($targetDir)) {
-            if (readlink($targetDir) === $originDir) {
-                return;
-            }
-            $this->remove($targetDir);
-        }
-
-        if (!self::box('symlink', $originDir, $targetDir)) {
-            $this->linkException($originDir, $targetDir, 'symbolic');
-        }
-    }
-
-    /**
-     * Creates a hard link, or several hard links to a file.
-     *
-     * @param string|string[] $targetFiles The target file(s)
-     *
-     * @throws FileNotFoundException When original file is missing or not a file
-     * @throws IOException           When link fails, including if link already exists
-     */
-    public function hardlink(string $originFile, $targetFiles)
-    {
-        if (!$this->exists($originFile)) {
-            throw new FileNotFoundException(null, 0, null, $originFile);
-        }
-
-        if (!is_file($originFile)) {
-            throw new FileNotFoundException(sprintf('Origin file "%s" is not a file.', $originFile));
-        }
-
-        foreach ($this->toIterable($targetFiles) as $targetFile) {
-            if (is_file($targetFile)) {
-                if (fileinode($originFile) === fileinode($targetFile)) {
-                    continue;
-                }
-                $this->remove($targetFile);
-            }
-
-            if (!self::box('link', $originFile, $targetFile)) {
-                $this->linkException($originFile, $targetFile, 'hard');
-            }
-        }
-    }
-
-    /**
-     * @param string $linkType Name of the link type, typically 'symbolic' or 'hard'
-     */
-    private function linkException(string $origin, string $target, string $linkType)
-    {
-        if (self::$lastError) {
-            if ('\\' === \DIRECTORY_SEPARATOR && str_contains(self::$lastError, 'error code(1314)')) {
-                throw new IOException(sprintf('Unable to create "%s" link due to error code 1314: \'A required privilege is not held by the client\'. Do you have the required Administrator-rights?', $linkType), 0, null, $target);
-            }
-        }
-        throw new IOException(sprintf('Failed to create "%s" link from "%s" to "%s": ', $linkType, $origin, $target).self::$lastError, 0, null, $target);
-    }
-
-    /**
-     * Resolves links in paths.
-     *
-     * With $canonicalize = false (default)
-     *      - if $path does not exist or is not a link, returns null
-     *      - if $path is a link, returns the next direct target of the link without considering the existence of the target
-     *
-     * With $canonicalize = true
-     *      - if $path does not exist, returns null
-     *      - if $path exists, returns its absolute fully resolved final version
-     *
-     * @return string|null
-     */
-    public function readlink(string $path, bool $canonicalize = false)
-    {
-        if (!$canonicalize && !is_link($path)) {
-            return null;
-        }
-
-        if ($canonicalize) {
-            if (!$this->exists($path)) {
-                return null;
-            }
-
-            if ('\\' === \DIRECTORY_SEPARATOR && \PHP_VERSION_ID < 70410) {
-                $path = readlink($path);
-            }
-
-            return realpath($path);
-        }
-
-        if ('\\' === \DIRECTORY_SEPARATOR && \PHP_VERSION_ID < 70400) {
-            return realpath($path);
-        }
-
-        return readlink($path);
-    }
-
-    /**
-     * Given an existing path, convert it to a path relative to a given starting path.
-     *
-     * @return string Path of target relative to starting path
-     */
-    public function makePathRelative(string $endPath, string $startPath)
-    {
-        if (!$this->isAbsolutePath($startPath)) {
-            throw new InvalidArgumentException(sprintf('The start path "%s" is not absolute.', $startPath));
-        }
-
-        if (!$this->isAbsolutePath($endPath)) {
-            throw new InvalidArgumentException(sprintf('The end path "%s" is not absolute.', $endPath));
-        }
-
-        // Normalize separators on Windows
-        if ('\\' === \DIRECTORY_SEPARATOR) {
-            $endPath = str_replace('\\', '/', $endPath);
-            $startPath = str_replace('\\', '/', $startPath);
-        }
-
-        $splitDriveLetter = function ($path) {
-            return (\strlen($path) > 2 && ':' === $path[1] && '/' === $path[2] && ctype_alpha($path[0]))
-                ? [substr($path, 2), strtoupper($path[0])]
-                : [$path, null];
-        };
-
-        $splitPath = function ($path) {
-            $result = [];
-
-            foreach (explode('/', trim($path, '/')) as $segment) {
-                if ('..' === $segment) {
-                    array_pop($result);
-                } elseif ('.' !== $segment && '' !== $segment) {
-                    $result[] = $segment;
-                }
-            }
-
-            return $result;
-        };
-
-        [$endPath, $endDriveLetter] = $splitDriveLetter($endPath);
-        [$startPath, $startDriveLetter] = $splitDriveLetter($startPath);
-
-        $startPathArr = $splitPath($startPath);
-        $endPathArr = $splitPath($endPath);
-
-        if ($endDriveLetter && $startDriveLetter && $endDriveLetter != $startDriveLetter) {
-            // End path is on another drive, so no relative path exists
-            return $endDriveLetter.':/'.($endPathArr ? implode('/', $endPathArr).'/' : '');
-        }
-
-        // Find for which directory the common path stops
-        $index = 0;
-        while (isset($startPathArr[$index]) && isset($endPathArr[$index]) && $startPathArr[$index] === $endPathArr[$index]) {
-            ++$index;
-        }
-
-        // Determine how deep the start path is relative to the common path (ie, "web/bundles" = 2 levels)
-        if (1 === \count($startPathArr) && '' === $startPathArr[0]) {
-            $depth = 0;
-        } else {
-            $depth = \count($startPathArr) - $index;
-        }
-
-        // Repeated "../" for each level need to reach the common path
-        $traverser = str_repeat('../', $depth);
-
-        $endPathRemainder = implode('/', \array_slice($endPathArr, $index));
-
-        // Construct $endPath from traversing to the common path, then to the remaining $endPath
-        $relativePath = $traverser.('' !== $endPathRemainder ? $endPathRemainder.'/' : '');
-
-        return '' === $relativePath ? './' : $relativePath;
-    }
-
-    /**
-     * Mirrors a directory to another.
-     *
-     * Copies files and directories from the origin directory into the target directory. By default:
-     *
-     *  - existing files in the target directory will be overwritten, except if they are newer (see the `override` option)
-     *  - files in the target directory that do not exist in the source directory will not be deleted (see the `delete` option)
-     *
-     * @param \Traversable|null $iterator Iterator that filters which files and directories to copy, if null a recursive iterator is created
-     * @param array             $options  An array of boolean options
-     *                                    Valid options are:
-     *                                    - $options['override'] If true, target files newer than origin files are overwritten (see copy(), defaults to false)
-     *                                    - $options['copy_on_windows'] Whether to copy files instead of links on Windows (see symlink(), defaults to false)
-     *                                    - $options['delete'] Whether to delete files that are not in the source directory (defaults to false)
-     *
-     * @throws IOException When file type is unknown
-     */
-    public function mirror(string $originDir, string $targetDir, \Traversable $iterator = null, array $options = [])
-    {
-        $targetDir = rtrim($targetDir, '/\\');
-        $originDir = rtrim($originDir, '/\\');
-        $originDirLen = \strlen($originDir);
-
-        if (!$this->exists($originDir)) {
-            throw new IOException(sprintf('The origin directory specified "%s" was not found.', $originDir), 0, null, $originDir);
-        }
-
-        // Iterate in destination folder to remove obsolete entries
-        if ($this->exists($targetDir) && isset($options['delete']) && $options['delete']) {
-            $deleteIterator = $iterator;
-            if (null === $deleteIterator) {
-                $flags = \FilesystemIterator::SKIP_DOTS;
-                $deleteIterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($targetDir, $flags), \RecursiveIteratorIterator::CHILD_FIRST);
-            }
-            $targetDirLen = \strlen($targetDir);
-            foreach ($deleteIterator as $file) {
-                $origin = $originDir.substr($file->getPathname(), $targetDirLen);
-                if (!$this->exists($origin)) {
-                    $this->remove($file);
-                }
-            }
-        }
-
-        $copyOnWindows = $options['copy_on_windows'] ?? false;
-
-        if (null === $iterator) {
-            $flags = $copyOnWindows ? \FilesystemIterator::SKIP_DOTS | \FilesystemIterator::FOLLOW_SYMLINKS : \FilesystemIterator::SKIP_DOTS;
-            $iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($originDir, $flags), \RecursiveIteratorIterator::SELF_FIRST);
-        }
-
-        $this->mkdir($targetDir);
-        $filesCreatedWhileMirroring = [];
-
-        foreach ($iterator as $file) {
-            if ($file->getPathname() === $targetDir || $file->getRealPath() === $targetDir || isset($filesCreatedWhileMirroring[$file->getRealPath()])) {
-                continue;
-            }
-
-            $target = $targetDir.substr($file->getPathname(), $originDirLen);
-            $filesCreatedWhileMirroring[$target] = true;
-
-            if (!$copyOnWindows && is_link($file)) {
-                $this->symlink($file->getLinkTarget(), $target);
-            } elseif (is_dir($file)) {
-                $this->mkdir($target);
-            } elseif (is_file($file)) {
-                $this->copy($file, $target, $options['override'] ?? false);
-            } else {
-                throw new IOException(sprintf('Unable to guess "%s" file type.', $file), 0, null, $file);
-            }
-        }
-    }
-
-    /**
-     * Returns whether the file path is an absolute path.
-     *
-     * @return bool
-     */
-    public function isAbsolutePath(string $file)
-    {
-        return '' !== $file && (strspn($file, '/\\', 0, 1)
-            || (\strlen($file) > 3 && ctype_alpha($file[0])
-                && ':' === $file[1]
-                && strspn($file, '/\\', 2, 1)
-            )
-            || null !== parse_url($file, \PHP_URL_SCHEME)
-        );
-    }
-
-    /**
-     * Creates a temporary file with support for custom stream wrappers.
-     *
-     * @param string $prefix The prefix of the generated temporary filename
-     *                       Note: Windows uses only the first three characters of prefix
-     * @param string $suffix The suffix of the generated temporary filename
-     *
-     * @return string The new temporary filename (with path), or throw an exception on failure
-     */
-    public function tempnam(string $dir, string $prefix/*, string $suffix = ''*/)
-    {
-        $suffix = \func_num_args() > 2 ? func_get_arg(2) : '';
-        [$scheme, $hierarchy] = $this->getSchemeAndHierarchy($dir);
-
-        // If no scheme or scheme is "file" or "gs" (Google Cloud) create temp file in local filesystem
-        if ((null === $scheme || 'file' === $scheme || 'gs' === $scheme) && '' === $suffix) {
-            // If tempnam failed or no scheme return the filename otherwise prepend the scheme
-            if ($tmpFile = self::box('tempnam', $hierarchy, $prefix)) {
-                if (null !== $scheme && 'gs' !== $scheme) {
-                    return $scheme.'://'.$tmpFile;
-                }
-
-                return $tmpFile;
-            }
-
-            throw new IOException('A temporary file could not be created: '.self::$lastError);
-        }
-
-        // Loop until we create a valid temp file or have reached 10 attempts
-        for ($i = 0; $i < 10; ++$i) {
-            // Create a unique filename
-            $tmpFile = $dir.'/'.$prefix.uniqid(mt_rand(), true).$suffix;
-
-            // Use fopen instead of file_exists as some streams do not support stat
-            // Use mode 'x+' to atomically check existence and create to avoid a TOCTOU vulnerability
-            if (!$handle = self::box('fopen', $tmpFile, 'x+')) {
-                continue;
-            }
-
-            // Close the file if it was successfully opened
-            self::box('fclose', $handle);
-
-            return $tmpFile;
-        }
-
-        throw new IOException('A temporary file could not be created: '.self::$lastError);
-    }
-
-    /**
-     * Atomically dumps content into a file.
-     *
-     * @param string|resource $content The data to write into the file
-     *
-     * @throws IOException if the file cannot be written to
-     */
-    public function dumpFile(string $filename, $content)
-    {
-        if (\is_array($content)) {
-            throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be string or resource, array given.', __METHOD__));
-        }
-
-        $dir = \dirname($filename);
-
-        if (!is_dir($dir)) {
-            $this->mkdir($dir);
-        }
-
-        // Will create a temp file with 0600 access rights
-        // when the filesystem supports chmod.
-        $tmpFile = $this->tempnam($dir, basename($filename));
-
-        try {
-            if (false === self::box('file_put_contents', $tmpFile, $content)) {
-                throw new IOException(sprintf('Failed to write file "%s": ', $filename).self::$lastError, 0, null, $filename);
-            }
-
-            self::box('chmod', $tmpFile, file_exists($filename) ? fileperms($filename) : 0666 & ~umask());
-
-            $this->rename($tmpFile, $filename, true);
-        } finally {
-            if (file_exists($tmpFile)) {
-                self::box('unlink', $tmpFile);
-            }
-        }
-    }
-
-    /**
-     * Appends content to an existing file.
-     *
-     * @param string|resource $content The content to append
-     *
-     * @throws IOException If the file is not writable
-     */
-    public function appendToFile(string $filename, $content)
-    {
-        if (\is_array($content)) {
-            throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be string or resource, array given.', __METHOD__));
-        }
-
-        $dir = \dirname($filename);
-
-        if (!is_dir($dir)) {
-            $this->mkdir($dir);
-        }
-
-        if (false === self::box('file_put_contents', $filename, $content, \FILE_APPEND)) {
-            throw new IOException(sprintf('Failed to write file "%s": ', $filename).self::$lastError, 0, null, $filename);
-        }
-    }
-
-    private function toIterable($files): iterable
-    {
-        return is_iterable($files) ? $files : [$files];
-    }
-
-    /**
-     * Gets a 2-tuple of scheme (may be null) and hierarchical part of a filename (e.g. file:///tmp -> [file, tmp]).
-     */
-    private function getSchemeAndHierarchy(string $filename): array
-    {
-        $components = explode('://', $filename, 2);
-
-        return 2 === \count($components) ? [$components[0], $components[1]] : [null, $components[0]];
-    }
-
-    /**
-     * @param mixed ...$args
-     *
-     * @return mixed
-     */
-    private static function box(callable $func, ...$args)
-    {
-        self::$lastError = null;
-        set_error_handler(__CLASS__.'::handleError');
-        try {
-            $result = $func(...$args);
-            restore_error_handler();
-
-            return $result;
-        } catch (\Throwable $e) {
-        }
-        restore_error_handler();
-
-        throw $e;
-    }
-
-    /**
-     * @internal
-     */
-    public static function handleError(int $type, string $msg)
-    {
-        self::$lastError = $msg;
-    }
+	private static $lastError;
+
+	/**
+	 * Copies a file.
+	 *
+	 * If the target file is older than the origin file, it's always overwritten.
+	 * If the target file is newer, it is overwritten only when the
+	 * $overwriteNewerFiles option is set to true.
+	 *
+	 * @throws FileNotFoundException When originFile doesn't exist
+	 * @throws IOException           When copy fails
+	 */
+	public function copy(string $originFile, string $targetFile, bool $overwriteNewerFiles = false)
+	{
+		$originIsLocal = stream_is_local($originFile) || 0 === stripos($originFile, 'file://');
+		if ($originIsLocal && !is_file($originFile)) {
+			throw new FileNotFoundException(sprintf('Failed to copy "%s" because file does not exist.', $originFile), 0, null, $originFile);
+		}
+
+		$this->mkdir(\dirname($targetFile));
+
+		$doCopy = true;
+		if (!$overwriteNewerFiles && null === parse_url($originFile, \PHP_URL_HOST) && is_file($targetFile)) {
+			$doCopy = filemtime($originFile) > filemtime($targetFile);
+		}
+
+		if ($doCopy) {
+			// https://bugs.php.net/64634
+			if (!$source = self::box('fopen', $originFile, 'r')) {
+				throw new IOException(sprintf('Failed to copy "%s" to "%s" because source file could not be opened for reading: ', $originFile, $targetFile).self::$lastError, 0, null, $originFile);
+			}
+
+			// Stream context created to allow files overwrite when using FTP stream wrapper - disabled by default
+			if (!$target = self::box('fopen', $targetFile, 'w', false, stream_context_create(['ftp' => ['overwrite' => true]]))) {
+				throw new IOException(sprintf('Failed to copy "%s" to "%s" because target file could not be opened for writing: ', $originFile, $targetFile).self::$lastError, 0, null, $originFile);
+			}
+
+			$bytesCopied = stream_copy_to_stream($source, $target);
+			fclose($source);
+			fclose($target);
+			unset($source, $target);
+
+			if (!is_file($targetFile)) {
+				throw new IOException(sprintf('Failed to copy "%s" to "%s".', $originFile, $targetFile), 0, null, $originFile);
+			}
+
+			if ($originIsLocal) {
+				// Like `cp`, preserve executable permission bits
+				self::box('chmod', $targetFile, fileperms($targetFile) | (fileperms($originFile) & 0111));
+
+				if ($bytesCopied !== $bytesOrigin = filesize($originFile)) {
+					throw new IOException(sprintf('Failed to copy the whole content of "%s" to "%s" (%g of %g bytes copied).', $originFile, $targetFile, $bytesCopied, $bytesOrigin), 0, null, $originFile);
+				}
+			}
+		}
+	}
+
+	/**
+	 * Creates a directory recursively.
+	 *
+	 * @param string|iterable $dirs The directory path
+	 *
+	 * @throws IOException On any directory creation failure
+	 */
+	public function mkdir($dirs, int $mode = 0777)
+	{
+		foreach ($this->toIterable($dirs) as $dir) {
+			if (is_dir($dir)) {
+				continue;
+			}
+
+			if (!self::box('mkdir', $dir, $mode, true) && !is_dir($dir)) {
+				throw new IOException(sprintf('Failed to create "%s": ', $dir).self::$lastError, 0, null, $dir);
+			}
+		}
+	}
+
+	/**
+	 * Checks the existence of files or directories.
+	 *
+	 * @param string|iterable $files A filename, an array of files, or a \Traversable instance to check
+	 *
+	 * @return bool true if the file exists, false otherwise
+	 */
+	public function exists($files)
+	{
+		$maxPathLength = \PHP_MAXPATHLEN - 2;
+
+		foreach ($this->toIterable($files) as $file) {
+			if (\strlen($file) > $maxPathLength) {
+				throw new IOException(sprintf('Could not check if file exist because path length exceeds %d characters.', $maxPathLength), 0, null, $file);
+			}
+
+			if (!file_exists($file)) {
+				return false;
+			}
+		}
+
+		return true;
+	}
+
+	/**
+	 * Sets access and modification time of file.
+	 *
+	 * @param string|iterable $files A filename, an array of files, or a \Traversable instance to create
+	 * @param int|null        $time  The touch time as a Unix timestamp, if not supplied the current system time is used
+	 * @param int|null        $atime The access time as a Unix timestamp, if not supplied the current system time is used
+	 *
+	 * @throws IOException When touch fails
+	 */
+	public function touch($files, int $time = null, int $atime = null)
+	{
+		foreach ($this->toIterable($files) as $file) {
+			if (!($time ? self::box('touch', $file, $time, $atime) : self::box('touch', $file))) {
+				throw new IOException(sprintf('Failed to touch "%s": ', $file).self::$lastError, 0, null, $file);
+			}
+		}
+	}
+
+	/**
+	 * Removes files or directories.
+	 *
+	 * @param string|iterable $files A filename, an array of files, or a \Traversable instance to remove
+	 *
+	 * @throws IOException When removal fails
+	 */
+	public function remove($files)
+	{
+		if ($files instanceof \Traversable) {
+			$files = iterator_to_array($files, false);
+		} elseif (!\is_array($files)) {
+			$files = [$files];
+		}
+
+		self::doRemove($files, false);
+	}
+
+	private static function doRemove(array $files, bool $isRecursive): void
+	{
+		$files = array_reverse($files);
+		foreach ($files as $file) {
+			if (is_link($file)) {
+				// See https://bugs.php.net/52176
+				if (!(self::box('unlink', $file) || '\\' !== \DIRECTORY_SEPARATOR || self::box('rmdir', $file)) && file_exists($file)) {
+					throw new IOException(sprintf('Failed to remove symlink "%s": ', $file).self::$lastError);
+				}
+			} elseif (is_dir($file)) {
+				if (!$isRecursive) {
+					$tmpName = \dirname(realpath($file)).'/.'.strrev(strtr(base64_encode(random_bytes(2)), '/=', '-.'));
+
+					if (file_exists($tmpName)) {
+						try {
+							self::doRemove([$tmpName], true);
+						} catch (IOException $e) {
+						}
+					}
+
+					if (!file_exists($tmpName) && self::box('rename', $file, $tmpName)) {
+						$origFile = $file;
+						$file = $tmpName;
+					} else {
+						$origFile = null;
+					}
+				}
+
+				$files = new \FilesystemIterator($file, \FilesystemIterator::CURRENT_AS_PATHNAME | \FilesystemIterator::SKIP_DOTS);
+				self::doRemove(iterator_to_array($files, true), true);
+
+				if (!self::box('rmdir', $file) && file_exists($file) && !$isRecursive) {
+					$lastError = self::$lastError;
+
+					if (null !== $origFile && self::box('rename', $file, $origFile)) {
+						$file = $origFile;
+					}
+
+					throw new IOException(sprintf('Failed to remove directory "%s": ', $file).$lastError);
+				}
+			} elseif (!self::box('unlink', $file) && (str_contains(self::$lastError, 'Permission denied') || file_exists($file))) {
+				throw new IOException(sprintf('Failed to remove file "%s": ', $file).self::$lastError);
+			}
+		}
+	}
+
+	/**
+	 * Change mode for an array of files or directories.
+	 *
+	 * @param string|iterable $files     A filename, an array of files, or a \Traversable instance to change mode
+	 * @param int             $mode      The new mode (octal)
+	 * @param int             $umask     The mode mask (octal)
+	 * @param bool            $recursive Whether change the mod recursively or not
+	 *
+	 * @throws IOException When the change fails
+	 */
+	public function chmod($files, int $mode, int $umask = 0000, bool $recursive = false)
+	{
+		foreach ($this->toIterable($files) as $file) {
+			if ((\PHP_VERSION_ID < 80000 || \is_int($mode)) && !self::box('chmod', $file, $mode & ~$umask)) {
+				throw new IOException(sprintf('Failed to chmod file "%s": ', $file).self::$lastError, 0, null, $file);
+			}
+			if ($recursive && is_dir($file) && !is_link($file)) {
+				$this->chmod(new \FilesystemIterator($file), $mode, $umask, true);
+			}
+		}
+	}
+
+	/**
+	 * Change the owner of an array of files or directories.
+	 *
+	 * @param string|iterable $files     A filename, an array of files, or a \Traversable instance to change owner
+	 * @param string|int      $user      A user name or number
+	 * @param bool            $recursive Whether change the owner recursively or not
+	 *
+	 * @throws IOException When the change fails
+	 */
+	public function chown($files, $user, bool $recursive = false)
+	{
+		foreach ($this->toIterable($files) as $file) {
+			if ($recursive && is_dir($file) && !is_link($file)) {
+				$this->chown(new \FilesystemIterator($file), $user, true);
+			}
+			if (is_link($file) && \function_exists('lchown')) {
+				if (!self::box('lchown', $file, $user)) {
+					throw new IOException(sprintf('Failed to chown file "%s": ', $file).self::$lastError, 0, null, $file);
+				}
+			} else {
+				if (!self::box('chown', $file, $user)) {
+					throw new IOException(sprintf('Failed to chown file "%s": ', $file).self::$lastError, 0, null, $file);
+				}
+			}
+		}
+	}
+
+	/**
+	 * Change the group of an array of files or directories.
+	 *
+	 * @param string|iterable $files     A filename, an array of files, or a \Traversable instance to change group
+	 * @param string|int      $group     A group name or number
+	 * @param bool            $recursive Whether change the group recursively or not
+	 *
+	 * @throws IOException When the change fails
+	 */
+	public function chgrp($files, $group, bool $recursive = false)
+	{
+		foreach ($this->toIterable($files) as $file) {
+			if ($recursive && is_dir($file) && !is_link($file)) {
+				$this->chgrp(new \FilesystemIterator($file), $group, true);
+			}
+			if (is_link($file) && \function_exists('lchgrp')) {
+				if (!self::box('lchgrp', $file, $group)) {
+					throw new IOException(sprintf('Failed to chgrp file "%s": ', $file).self::$lastError, 0, null, $file);
+				}
+			} else {
+				if (!self::box('chgrp', $file, $group)) {
+					throw new IOException(sprintf('Failed to chgrp file "%s": ', $file).self::$lastError, 0, null, $file);
+				}
+			}
+		}
+	}
+
+	/**
+	 * Renames a file or a directory.
+	 *
+	 * @throws IOException When target file or directory already exists
+	 * @throws IOException When origin cannot be renamed
+	 */
+	public function rename(string $origin, string $target, bool $overwrite = false)
+	{
+		// we check that target does not exist
+		if (!$overwrite && $this->isReadable($target)) {
+			throw new IOException(sprintf('Cannot rename because the target "%s" already exists.', $target), 0, null, $target);
+		}
+
+		if (!self::box('rename', $origin, $target)) {
+			if (is_dir($origin)) {
+				// See https://bugs.php.net/54097 & https://php.net/rename#113943
+				$this->mirror($origin, $target, null, ['override' => $overwrite, 'delete' => $overwrite]);
+				$this->remove($origin);
+
+				return;
+			}
+			throw new IOException(sprintf('Cannot rename "%s" to "%s": ', $origin, $target).self::$lastError, 0, null, $target);
+		}
+	}
+
+	/**
+	 * Tells whether a file exists and is readable.
+	 *
+	 * @throws IOException When windows path is longer than 258 characters
+	 */
+	private function isReadable(string $filename): bool
+	{
+		$maxPathLength = \PHP_MAXPATHLEN - 2;
+
+		if (\strlen($filename) > $maxPathLength) {
+			throw new IOException(sprintf('Could not check if file is readable because path length exceeds %d characters.', $maxPathLength), 0, null, $filename);
+		}
+
+		return is_readable($filename);
+	}
+
+	/**
+	 * Creates a symbolic link or copy a directory.
+	 *
+	 * @throws IOException When symlink fails
+	 */
+	public function symlink(string $originDir, string $targetDir, bool $copyOnWindows = false)
+	{
+		if ('\\' === \DIRECTORY_SEPARATOR) {
+			$originDir = strtr($originDir, '/', '\\');
+			$targetDir = strtr($targetDir, '/', '\\');
+
+			if ($copyOnWindows) {
+				$this->mirror($originDir, $targetDir);
+
+				return;
+			}
+		}
+
+		$this->mkdir(\dirname($targetDir));
+
+		if (is_link($targetDir)) {
+			if (readlink($targetDir) === $originDir) {
+				return;
+			}
+			$this->remove($targetDir);
+		}
+
+		if (!self::box('symlink', $originDir, $targetDir)) {
+			$this->linkException($originDir, $targetDir, 'symbolic');
+		}
+	}
+
+	/**
+	 * Creates a hard link, or several hard links to a file.
+	 *
+	 * @param string|string[] $targetFiles The target file(s)
+	 *
+	 * @throws FileNotFoundException When original file is missing or not a file
+	 * @throws IOException           When link fails, including if link already exists
+	 */
+	public function hardlink(string $originFile, $targetFiles)
+	{
+		if (!$this->exists($originFile)) {
+			throw new FileNotFoundException(null, 0, null, $originFile);
+		}
+
+		if (!is_file($originFile)) {
+			throw new FileNotFoundException(sprintf('Origin file "%s" is not a file.', $originFile));
+		}
+
+		foreach ($this->toIterable($targetFiles) as $targetFile) {
+			if (is_file($targetFile)) {
+				if (fileinode($originFile) === fileinode($targetFile)) {
+					continue;
+				}
+				$this->remove($targetFile);
+			}
+
+			if (!self::box('link', $originFile, $targetFile)) {
+				$this->linkException($originFile, $targetFile, 'hard');
+			}
+		}
+	}
+
+	/**
+	 * @param string $linkType Name of the link type, typically 'symbolic' or 'hard'
+	 */
+	private function linkException(string $origin, string $target, string $linkType)
+	{
+		if (self::$lastError) {
+			if ('\\' === \DIRECTORY_SEPARATOR && str_contains(self::$lastError, 'error code(1314)')) {
+				throw new IOException(sprintf('Unable to create "%s" link due to error code 1314: \'A required privilege is not held by the client\'. Do you have the required Administrator-rights?', $linkType), 0, null, $target);
+			}
+		}
+		throw new IOException(sprintf('Failed to create "%s" link from "%s" to "%s": ', $linkType, $origin, $target).self::$lastError, 0, null, $target);
+	}
+
+	/**
+	 * Resolves links in paths.
+	 *
+	 * With $canonicalize = false (default)
+	 *      - if $path does not exist or is not a link, returns null
+	 *      - if $path is a link, returns the next direct target of the link without considering the existence of the target
+	 *
+	 * With $canonicalize = true
+	 *      - if $path does not exist, returns null
+	 *      - if $path exists, returns its absolute fully resolved final version
+	 *
+	 * @return string|null
+	 */
+	public function readlink(string $path, bool $canonicalize = false)
+	{
+		if (!$canonicalize && !is_link($path)) {
+			return null;
+		}
+
+		if ($canonicalize) {
+			if (!$this->exists($path)) {
+				return null;
+			}
+
+			if ('\\' === \DIRECTORY_SEPARATOR && \PHP_VERSION_ID < 70410) {
+				$path = readlink($path);
+			}
+
+			return realpath($path);
+		}
+
+		if ('\\' === \DIRECTORY_SEPARATOR && \PHP_VERSION_ID < 70400) {
+			return realpath($path);
+		}
+
+		return readlink($path);
+	}
+
+	/**
+	 * Given an existing path, convert it to a path relative to a given starting path.
+	 *
+	 * @return string Path of target relative to starting path
+	 */
+	public function makePathRelative(string $endPath, string $startPath)
+	{
+		if (!$this->isAbsolutePath($startPath)) {
+			throw new InvalidArgumentException(sprintf('The start path "%s" is not absolute.', $startPath));
+		}
+
+		if (!$this->isAbsolutePath($endPath)) {
+			throw new InvalidArgumentException(sprintf('The end path "%s" is not absolute.', $endPath));
+		}
+
+		// Normalize separators on Windows
+		if ('\\' === \DIRECTORY_SEPARATOR) {
+			$endPath = str_replace('\\', '/', $endPath);
+			$startPath = str_replace('\\', '/', $startPath);
+		}
+
+		$splitDriveLetter = function ($path) {
+			return (\strlen($path) > 2 && ':' === $path[1] && '/' === $path[2] && ctype_alpha($path[0]))
+				? [substr($path, 2), strtoupper($path[0])]
+				: [$path, null];
+		};
+
+		$splitPath = function ($path) {
+			$result = [];
+
+			foreach (explode('/', trim($path, '/')) as $segment) {
+				if ('..' === $segment) {
+					array_pop($result);
+				} elseif ('.' !== $segment && '' !== $segment) {
+					$result[] = $segment;
+				}
+			}
+
+			return $result;
+		};
+
+		[$endPath, $endDriveLetter] = $splitDriveLetter($endPath);
+		[$startPath, $startDriveLetter] = $splitDriveLetter($startPath);
+
+		$startPathArr = $splitPath($startPath);
+		$endPathArr = $splitPath($endPath);
+
+		if ($endDriveLetter && $startDriveLetter && $endDriveLetter != $startDriveLetter) {
+			// End path is on another drive, so no relative path exists
+			return $endDriveLetter.':/'.($endPathArr ? implode('/', $endPathArr).'/' : '');
+		}
+
+		// Find for which directory the common path stops
+		$index = 0;
+		while (isset($startPathArr[$index]) && isset($endPathArr[$index]) && $startPathArr[$index] === $endPathArr[$index]) {
+			++$index;
+		}
+
+		// Determine how deep the start path is relative to the common path (ie, "web/bundles" = 2 levels)
+		if (1 === \count($startPathArr) && '' === $startPathArr[0]) {
+			$depth = 0;
+		} else {
+			$depth = \count($startPathArr) - $index;
+		}
+
+		// Repeated "../" for each level need to reach the common path
+		$traverser = str_repeat('../', $depth);
+
+		$endPathRemainder = implode('/', \array_slice($endPathArr, $index));
+
+		// Construct $endPath from traversing to the common path, then to the remaining $endPath
+		$relativePath = $traverser.('' !== $endPathRemainder ? $endPathRemainder.'/' : '');
+
+		return '' === $relativePath ? './' : $relativePath;
+	}
+
+	/**
+	 * Mirrors a directory to another.
+	 *
+	 * Copies files and directories from the origin directory into the target directory. By default:
+	 *
+	 *  - existing files in the target directory will be overwritten, except if they are newer (see the `override` option)
+	 *  - files in the target directory that do not exist in the source directory will not be deleted (see the `delete` option)
+	 *
+	 * @param \Traversable|null $iterator Iterator that filters which files and directories to copy, if null a recursive iterator is created
+	 * @param array             $options  An array of boolean options
+	 *                                    Valid options are:
+	 *                                    - $options['override'] If true, target files newer than origin files are overwritten (see copy(), defaults to false)
+	 *                                    - $options['copy_on_windows'] Whether to copy files instead of links on Windows (see symlink(), defaults to false)
+	 *                                    - $options['delete'] Whether to delete files that are not in the source directory (defaults to false)
+	 *
+	 * @throws IOException When file type is unknown
+	 */
+	public function mirror(string $originDir, string $targetDir, \Traversable $iterator = null, array $options = [])
+	{
+		$targetDir = rtrim($targetDir, '/\\');
+		$originDir = rtrim($originDir, '/\\');
+		$originDirLen = \strlen($originDir);
+
+		if (!$this->exists($originDir)) {
+			throw new IOException(sprintf('The origin directory specified "%s" was not found.', $originDir), 0, null, $originDir);
+		}
+
+		// Iterate in destination folder to remove obsolete entries
+		if ($this->exists($targetDir) && isset($options['delete']) && $options['delete']) {
+			$deleteIterator = $iterator;
+			if (null === $deleteIterator) {
+				$flags = \FilesystemIterator::SKIP_DOTS;
+				$deleteIterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($targetDir, $flags), \RecursiveIteratorIterator::CHILD_FIRST);
+			}
+			$targetDirLen = \strlen($targetDir);
+			foreach ($deleteIterator as $file) {
+				$origin = $originDir.substr($file->getPathname(), $targetDirLen);
+				if (!$this->exists($origin)) {
+					$this->remove($file);
+				}
+			}
+		}
+
+		$copyOnWindows = $options['copy_on_windows'] ?? false;
+
+		if (null === $iterator) {
+			$flags = $copyOnWindows ? \FilesystemIterator::SKIP_DOTS | \FilesystemIterator::FOLLOW_SYMLINKS : \FilesystemIterator::SKIP_DOTS;
+			$iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($originDir, $flags), \RecursiveIteratorIterator::SELF_FIRST);
+		}
+
+		$this->mkdir($targetDir);
+		$filesCreatedWhileMirroring = [];
+
+		foreach ($iterator as $file) {
+			if ($file->getPathname() === $targetDir || $file->getRealPath() === $targetDir || isset($filesCreatedWhileMirroring[$file->getRealPath()])) {
+				continue;
+			}
+
+			$target = $targetDir.substr($file->getPathname(), $originDirLen);
+			$filesCreatedWhileMirroring[$target] = true;
+
+			if (!$copyOnWindows && is_link($file)) {
+				$this->symlink($file->getLinkTarget(), $target);
+			} elseif (is_dir($file)) {
+				$this->mkdir($target);
+			} elseif (is_file($file)) {
+				$this->copy($file, $target, $options['override'] ?? false);
+			} else {
+				throw new IOException(sprintf('Unable to guess "%s" file type.', $file), 0, null, $file);
+			}
+		}
+	}
+
+	/**
+	 * Returns whether the file path is an absolute path.
+	 *
+	 * @return bool
+	 */
+	public function isAbsolutePath(string $file)
+	{
+		return '' !== $file && (strspn($file, '/\\', 0, 1)
+			|| (\strlen($file) > 3 && ctype_alpha($file[0])
+				&& ':' === $file[1]
+				&& strspn($file, '/\\', 2, 1)
+			)
+			|| null !== parse_url($file, \PHP_URL_SCHEME)
+		);
+	}
+
+	/**
+	 * Creates a temporary file with support for custom stream wrappers.
+	 *
+	 * @param string $prefix The prefix of the generated temporary filename
+	 *                       Note: Windows uses only the first three characters of prefix
+	 * @param string $suffix The suffix of the generated temporary filename
+	 *
+	 * @return string The new temporary filename (with path), or throw an exception on failure
+	 */
+	public function tempnam(string $dir, string $prefix/*, string $suffix = ''*/)
+	{
+		$suffix = \func_num_args() > 2 ? func_get_arg(2) : '';
+		[$scheme, $hierarchy] = $this->getSchemeAndHierarchy($dir);
+
+		// If no scheme or scheme is "file" or "gs" (Google Cloud) create temp file in local filesystem
+		if ((null === $scheme || 'file' === $scheme || 'gs' === $scheme) && '' === $suffix) {
+			// If tempnam failed or no scheme return the filename otherwise prepend the scheme
+			if ($tmpFile = self::box('tempnam', $hierarchy, $prefix)) {
+				if (null !== $scheme && 'gs' !== $scheme) {
+					return $scheme.'://'.$tmpFile;
+				}
+
+				return $tmpFile;
+			}
+
+			throw new IOException('A temporary file could not be created: '.self::$lastError);
+		}
+
+		// Loop until we create a valid temp file or have reached 10 attempts
+		for ($i = 0; $i < 10; ++$i) {
+			// Create a unique filename
+			$tmpFile = $dir.'/'.$prefix.uniqid(mt_rand(), true).$suffix;
+
+			// Use fopen instead of file_exists as some streams do not support stat
+			// Use mode 'x+' to atomically check existence and create to avoid a TOCTOU vulnerability
+			if (!$handle = self::box('fopen', $tmpFile, 'x+')) {
+				continue;
+			}
+
+			// Close the file if it was successfully opened
+			self::box('fclose', $handle);
+
+			return $tmpFile;
+		}
+
+		throw new IOException('A temporary file could not be created: '.self::$lastError);
+	}
+
+	/**
+	 * Atomically dumps content into a file.
+	 *
+	 * @param string|resource $content The data to write into the file
+	 *
+	 * @throws IOException if the file cannot be written to
+	 */
+	public function dumpFile(string $filename, $content)
+	{
+		if (\is_array($content)) {
+			throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be string or resource, array given.', __METHOD__));
+		}
+
+		$dir = \dirname($filename);
+
+		if (!is_dir($dir)) {
+			$this->mkdir($dir);
+		}
+
+		// Will create a temp file with 0600 access rights
+		// when the filesystem supports chmod.
+		$tmpFile = $this->tempnam($dir, basename($filename));
+
+		try {
+			if (false === self::box('file_put_contents', $tmpFile, $content)) {
+				throw new IOException(sprintf('Failed to write file "%s": ', $filename).self::$lastError, 0, null, $filename);
+			}
+
+			self::box('chmod', $tmpFile, file_exists($filename) ? fileperms($filename) : 0666 & ~umask());
+
+			$this->rename($tmpFile, $filename, true);
+		} finally {
+			if (file_exists($tmpFile)) {
+				self::box('unlink', $tmpFile);
+			}
+		}
+	}
+
+	/**
+	 * Appends content to an existing file.
+	 *
+	 * @param string|resource $content The content to append
+	 *
+	 * @throws IOException If the file is not writable
+	 */
+	public function appendToFile(string $filename, $content)
+	{
+		if (\is_array($content)) {
+			throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be string or resource, array given.', __METHOD__));
+		}
+
+		$dir = \dirname($filename);
+
+		if (!is_dir($dir)) {
+			$this->mkdir($dir);
+		}
+
+		if (false === self::box('file_put_contents', $filename, $content, \FILE_APPEND)) {
+			throw new IOException(sprintf('Failed to write file "%s": ', $filename).self::$lastError, 0, null, $filename);
+		}
+	}
+
+	private function toIterable($files): iterable
+	{
+		return is_iterable($files) ? $files : [$files];
+	}
+
+	/**
+	 * Gets a 2-tuple of scheme (may be null) and hierarchical part of a filename (e.g. file:///tmp -> [file, tmp]).
+	 */
+	private function getSchemeAndHierarchy(string $filename): array
+	{
+		$components = explode('://', $filename, 2);
+
+		return 2 === \count($components) ? [$components[0], $components[1]] : [null, $components[0]];
+	}
+
+	/**
+	 * @param mixed ...$args
+	 *
+	 * @return mixed
+	 */
+	private static function box(callable $func, ...$args)
+	{
+		self::$lastError = null;
+		set_error_handler(__CLASS__.'::handleError');
+		try {
+			$result = $func(...$args);
+			restore_error_handler();
+
+			return $result;
+		} catch (\Throwable $e) {
+		}
+		restore_error_handler();
+
+		throw $e;
+	}
+
+	/**
+	 * @internal
+	 */
+	public static function handleError(int $type, string $msg)
+	{
+		self::$lastError = $msg;
+	}
 }