gravityview / GravityView

vendor/symfony/finder/Iterator/RecursiveDirectoryIterator.php

Indentation +125 added lines, -125 removed lines

@@ -21,129 +21,129 @@
  */
 class RecursiveDirectoryIterator extends \RecursiveDirectoryIterator
 {
-    /**
-     * @var bool
-     */
-    private $ignoreUnreadableDirs;
-
-    /**
-     * @var bool
-     */
-    private $rewindable;
-
-    // these 3 properties take part of the performance optimization to avoid redoing the same work in all iterations
-    private $rootPath;
-    private $subPath;
-    private $directorySeparator = '/';
-
-    /**
-     * @throws \RuntimeException
-     */
-    public function __construct(string $path, int $flags, bool $ignoreUnreadableDirs = false)
-    {
-        if ($flags & (self::CURRENT_AS_PATHNAME | self::CURRENT_AS_SELF)) {
-            throw new \RuntimeException('This iterator only support returning current as fileinfo.');
-        }
-
-        parent::__construct($path, $flags);
-        $this->ignoreUnreadableDirs = $ignoreUnreadableDirs;
-        $this->rootPath = $path;
-        if ('/' !== \DIRECTORY_SEPARATOR && !($flags & self::UNIX_PATHS)) {
-            $this->directorySeparator = \DIRECTORY_SEPARATOR;
-        }
-    }
-
-    /**
-     * Return an instance of SplFileInfo with support for relative paths.
-     *
-     * @return SplFileInfo File information
-     */
-    #[\ReturnTypeWillChange]
-    public function current()
-    {
-        // the logic here avoids redoing the same work in all iterations
-
-        if (null === $subPathname = $this->subPath) {
-            $subPathname = $this->subPath = (string) $this->getSubPath();
-        }
-        if ('' !== $subPathname) {
-            $subPathname .= $this->directorySeparator;
-        }
-        $subPathname .= $this->getFilename();
-
-        if ('/' !== $basePath = $this->rootPath) {
-            $basePath .= $this->directorySeparator;
-        }
-
-        return new SplFileInfo($basePath.$subPathname, $this->subPath, $subPathname);
-    }
-
-    /**
-     * @return \RecursiveIterator
-     *
-     * @throws AccessDeniedException
-     */
-    #[\ReturnTypeWillChange]
-    public function getChildren()
-    {
-        try {
-            $children = parent::getChildren();
-
-            if ($children instanceof self) {
-                // parent method will call the constructor with default arguments, so unreadable dirs won't be ignored anymore
-                $children->ignoreUnreadableDirs = $this->ignoreUnreadableDirs;
-
-                // performance optimization to avoid redoing the same work in all children
-                $children->rewindable = &$this->rewindable;
-                $children->rootPath = $this->rootPath;
-            }
-
-            return $children;
-        } catch (\UnexpectedValueException $e) {
-            if ($this->ignoreUnreadableDirs) {
-                // If directory is unreadable and finder is set to ignore it, a fake empty content is returned.
-                return new \RecursiveArrayIterator([]);
-            } else {
-                throw new AccessDeniedException($e->getMessage(), $e->getCode(), $e);
-            }
-        }
-    }
-
-    /**
-     * Do nothing for non rewindable stream.
-     *
-     * @return void
-     */
-    #[\ReturnTypeWillChange]
-    public function rewind()
-    {
-        if (false === $this->isRewindable()) {
-            return;
-        }
-
-        parent::rewind();
-    }
-
-    /**
-     * Checks if the stream is rewindable.
-     *
-     * @return bool true when the stream is rewindable, false otherwise
-     */
-    public function isRewindable()
-    {
-        if (null !== $this->rewindable) {
-            return $this->rewindable;
-        }
-
-        if (false !== $stream = @opendir($this->getPath())) {
-            $infos = stream_get_meta_data($stream);
-            closedir($stream);
-
-            if ($infos['seekable']) {
-                return $this->rewindable = true;
-            }
-        }
-
-        return $this->rewindable = false;
-    }
+	/**
+	 * @var bool
+	 */
+	private $ignoreUnreadableDirs;
+
+	/**
+	 * @var bool
+	 */
+	private $rewindable;
+
+	// these 3 properties take part of the performance optimization to avoid redoing the same work in all iterations
+	private $rootPath;
+	private $subPath;
+	private $directorySeparator = '/';
+
+	/**
+	 * @throws \RuntimeException
+	 */
+	public function __construct(string $path, int $flags, bool $ignoreUnreadableDirs = false)
+	{
+		if ($flags & (self::CURRENT_AS_PATHNAME | self::CURRENT_AS_SELF)) {
+			throw new \RuntimeException('This iterator only support returning current as fileinfo.');
+		}
+
+		parent::__construct($path, $flags);
+		$this->ignoreUnreadableDirs = $ignoreUnreadableDirs;
+		$this->rootPath = $path;
+		if ('/' !== \DIRECTORY_SEPARATOR && !($flags & self::UNIX_PATHS)) {
+			$this->directorySeparator = \DIRECTORY_SEPARATOR;
+		}
+	}
+
+	/**
+	 * Return an instance of SplFileInfo with support for relative paths.
+	 *
+	 * @return SplFileInfo File information
+	 */
+	#[\ReturnTypeWillChange]
+	public function current()
+	{
+		// the logic here avoids redoing the same work in all iterations
+
+		if (null === $subPathname = $this->subPath) {
+			$subPathname = $this->subPath = (string) $this->getSubPath();
+		}
+		if ('' !== $subPathname) {
+			$subPathname .= $this->directorySeparator;
+		}
+		$subPathname .= $this->getFilename();
+
+		if ('/' !== $basePath = $this->rootPath) {
+			$basePath .= $this->directorySeparator;
+		}
+
+		return new SplFileInfo($basePath.$subPathname, $this->subPath, $subPathname);
+	}
+
+	/**
+	 * @return \RecursiveIterator
+	 *
+	 * @throws AccessDeniedException
+	 */
+	#[\ReturnTypeWillChange]
+	public function getChildren()
+	{
+		try {
+			$children = parent::getChildren();
+
+			if ($children instanceof self) {
+				// parent method will call the constructor with default arguments, so unreadable dirs won't be ignored anymore
+				$children->ignoreUnreadableDirs = $this->ignoreUnreadableDirs;
+
+				// performance optimization to avoid redoing the same work in all children
+				$children->rewindable = &$this->rewindable;
+				$children->rootPath = $this->rootPath;
+			}
+
+			return $children;
+		} catch (\UnexpectedValueException $e) {
+			if ($this->ignoreUnreadableDirs) {
+				// If directory is unreadable and finder is set to ignore it, a fake empty content is returned.
+				return new \RecursiveArrayIterator([]);
+			} else {
+				throw new AccessDeniedException($e->getMessage(), $e->getCode(), $e);
+			}
+		}
+	}
+
+	/**
+	 * Do nothing for non rewindable stream.
+	 *
+	 * @return void
+	 */
+	#[\ReturnTypeWillChange]
+	public function rewind()
+	{
+		if (false === $this->isRewindable()) {
+			return;
+		}
+
+		parent::rewind();
+	}
+
+	/**
+	 * Checks if the stream is rewindable.
+	 *
+	 * @return bool true when the stream is rewindable, false otherwise
+	 */
+	public function isRewindable()
+	{
+		if (null !== $this->rewindable) {
+			return $this->rewindable;
+		}
+
+		if (false !== $stream = @opendir($this->getPath())) {
+			$infos = stream_get_meta_data($stream);
+			closedir($stream);
+
+			if ($infos['seekable']) {
+				return $this->rewindable = true;
+			}
+		}
+
+		return $this->rewindable = false;
+	}
 }

vendor/symfony/finder/Iterator/LazyIterator.php

Indentation +9 added lines, -9 removed lines

@@ -18,15 +18,15 @@
  */
 class LazyIterator implements \IteratorAggregate
 {
-    private $iteratorFactory;
+	private $iteratorFactory;
 
-    public function __construct(callable $iteratorFactory)
-    {
-        $this->iteratorFactory = $iteratorFactory;
-    }
+	public function __construct(callable $iteratorFactory)
+	{
+		$this->iteratorFactory = $iteratorFactory;
+	}
 
-    public function getIterator(): \Traversable
-    {
-        yield from ($this->iteratorFactory)();
-    }
+	public function getIterator(): \Traversable
+	{
+		yield from ($this->iteratorFactory)();
+	}
 }

vendor/symfony/finder/Iterator/SizeRangeFilterIterator.php

Indentation +35 added lines, -35 removed lines

@@ -20,39 +20,39 @@
  */
 class SizeRangeFilterIterator extends \FilterIterator
 {
-    private $comparators = [];
-
-    /**
-     * @param \Iterator          $iterator    The Iterator to filter
-     * @param NumberComparator[] $comparators An array of NumberComparator instances
-     */
-    public function __construct(\Iterator $iterator, array $comparators)
-    {
-        $this->comparators = $comparators;
-
-        parent::__construct($iterator);
-    }
-
-    /**
-     * Filters the iterator values.
-     *
-     * @return bool true if the value should be kept, false otherwise
-     */
-    #[\ReturnTypeWillChange]
-    public function accept()
-    {
-        $fileinfo = $this->current();
-        if (!$fileinfo->isFile()) {
-            return true;
-        }
-
-        $filesize = $fileinfo->getSize();
-        foreach ($this->comparators as $compare) {
-            if (!$compare->test($filesize)) {
-                return false;
-            }
-        }
-
-        return true;
-    }
+	private $comparators = [];
+
+	/**
+	 * @param \Iterator          $iterator    The Iterator to filter
+	 * @param NumberComparator[] $comparators An array of NumberComparator instances
+	 */
+	public function __construct(\Iterator $iterator, array $comparators)
+	{
+		$this->comparators = $comparators;
+
+		parent::__construct($iterator);
+	}
+
+	/**
+	 * Filters the iterator values.
+	 *
+	 * @return bool true if the value should be kept, false otherwise
+	 */
+	#[\ReturnTypeWillChange]
+	public function accept()
+	{
+		$fileinfo = $this->current();
+		if (!$fileinfo->isFile()) {
+			return true;
+		}
+
+		$filesize = $fileinfo->getSize();
+		foreach ($this->comparators as $compare) {
+			if (!$compare->test($filesize)) {
+				return false;
+			}
+		}
+
+		return true;
+	}
 }

vendor/symfony/finder/Iterator/MultiplePcreFilterIterator.php

Indentation +73 added lines, -73 removed lines

@@ -18,89 +18,89 @@
  */
 abstract class MultiplePcreFilterIterator extends \FilterIterator
 {
-    protected $matchRegexps = [];
-    protected $noMatchRegexps = [];
+	protected $matchRegexps = [];
+	protected $noMatchRegexps = [];
 
-    /**
-     * @param \Iterator $iterator        The Iterator to filter
-     * @param string[]  $matchPatterns   An array of patterns that need to match
-     * @param string[]  $noMatchPatterns An array of patterns that need to not match
-     */
-    public function __construct(\Iterator $iterator, array $matchPatterns, array $noMatchPatterns)
-    {
-        foreach ($matchPatterns as $pattern) {
-            $this->matchRegexps[] = $this->toRegex($pattern);
-        }
+	/**
+	 * @param \Iterator $iterator        The Iterator to filter
+	 * @param string[]  $matchPatterns   An array of patterns that need to match
+	 * @param string[]  $noMatchPatterns An array of patterns that need to not match
+	 */
+	public function __construct(\Iterator $iterator, array $matchPatterns, array $noMatchPatterns)
+	{
+		foreach ($matchPatterns as $pattern) {
+			$this->matchRegexps[] = $this->toRegex($pattern);
+		}
 
-        foreach ($noMatchPatterns as $pattern) {
-            $this->noMatchRegexps[] = $this->toRegex($pattern);
-        }
+		foreach ($noMatchPatterns as $pattern) {
+			$this->noMatchRegexps[] = $this->toRegex($pattern);
+		}
 
-        parent::__construct($iterator);
-    }
+		parent::__construct($iterator);
+	}
 
-    /**
-     * Checks whether the string is accepted by the regex filters.
-     *
-     * If there is no regexps defined in the class, this method will accept the string.
-     * Such case can be handled by child classes before calling the method if they want to
-     * apply a different behavior.
-     *
-     * @return bool
-     */
-    protected function isAccepted(string $string)
-    {
-        // should at least not match one rule to exclude
-        foreach ($this->noMatchRegexps as $regex) {
-            if (preg_match($regex, $string)) {
-                return false;
-            }
-        }
+	/**
+	 * Checks whether the string is accepted by the regex filters.
+	 *
+	 * If there is no regexps defined in the class, this method will accept the string.
+	 * Such case can be handled by child classes before calling the method if they want to
+	 * apply a different behavior.
+	 *
+	 * @return bool
+	 */
+	protected function isAccepted(string $string)
+	{
+		// should at least not match one rule to exclude
+		foreach ($this->noMatchRegexps as $regex) {
+			if (preg_match($regex, $string)) {
+				return false;
+			}
+		}
 
-        // should at least match one rule
-        if ($this->matchRegexps) {
-            foreach ($this->matchRegexps as $regex) {
-                if (preg_match($regex, $string)) {
-                    return true;
-                }
-            }
+		// should at least match one rule
+		if ($this->matchRegexps) {
+			foreach ($this->matchRegexps as $regex) {
+				if (preg_match($regex, $string)) {
+					return true;
+				}
+			}
 
-            return false;
-        }
+			return false;
+		}
 
-        // If there is no match rules, the file is accepted
-        return true;
-    }
+		// If there is no match rules, the file is accepted
+		return true;
+	}
 
-    /**
-     * Checks whether the string is a regex.
-     *
-     * @return bool
-     */
-    protected function isRegex(string $str)
-    {
-        if (preg_match('/^(.{3,}?)[imsxuADU]*$/', $str, $m)) {
-            $start = substr($m[1], 0, 1);
-            $end = substr($m[1], -1);
+	/**
+	 * Checks whether the string is a regex.
+	 *
+	 * @return bool
+	 */
+	protected function isRegex(string $str)
+	{
+		if (preg_match('/^(.{3,}?)[imsxuADU]*$/', $str, $m)) {
+			$start = substr($m[1], 0, 1);
+			$end = substr($m[1], -1);
 
-            if ($start === $end) {
-                return !preg_match('/[*?[:alnum:] \\\\]/', $start);
-            }
+			if ($start === $end) {
+				return !preg_match('/[*?[:alnum:] \\\\]/', $start);
+			}
 
-            foreach ([['{', '}'], ['(', ')'], ['[', ']'], ['<', '>']] as $delimiters) {
-                if ($start === $delimiters[0] && $end === $delimiters[1]) {
-                    return true;
-                }
-            }
-        }
+			foreach ([['{', '}'], ['(', ')'], ['[', ']'], ['<', '>']] as $delimiters) {
+				if ($start === $delimiters[0] && $end === $delimiters[1]) {
+					return true;
+				}
+			}
+		}
 
-        return false;
-    }
+		return false;
+	}
 
-    /**
-     * Converts string into regexp.
-     *
-     * @return string
-     */
-    abstract protected function toRegex(string $str);
+	/**
+	 * Converts string into regexp.
+	 *
+	 * @return string
+	 */
+	abstract protected function toRegex(string $str);
 }

vendor/symfony/finder/Iterator/PathFilterIterator.php

Indentation +32 added lines, -32 removed lines

@@ -19,39 +19,39 @@
  */
 class PathFilterIterator extends MultiplePcreFilterIterator
 {
-    /**
-     * Filters the iterator values.
-     *
-     * @return bool true if the value should be kept, false otherwise
-     */
-    #[\ReturnTypeWillChange]
-    public function accept()
-    {
-        $filename = $this->current()->getRelativePathname();
+	/**
+	 * Filters the iterator values.
+	 *
+	 * @return bool true if the value should be kept, false otherwise
+	 */
+	#[\ReturnTypeWillChange]
+	public function accept()
+	{
+		$filename = $this->current()->getRelativePathname();
 
-        if ('\\' === \DIRECTORY_SEPARATOR) {
-            $filename = str_replace('\\', '/', $filename);
-        }
+		if ('\\' === \DIRECTORY_SEPARATOR) {
+			$filename = str_replace('\\', '/', $filename);
+		}
 
-        return $this->isAccepted($filename);
-    }
+		return $this->isAccepted($filename);
+	}
 
-    /**
-     * Converts strings to regexp.
-     *
-     * PCRE patterns are left unchanged.
-     *
-     * Default conversion:
-     *     'lorem/ipsum/dolor' ==>  'lorem\/ipsum\/dolor/'
-     *
-     * Use only / as directory separator (on Windows also).
-     *
-     * @param string $str Pattern: regexp or dirname
-     *
-     * @return string regexp corresponding to a given string or regexp
-     */
-    protected function toRegex(string $str)
-    {
-        return $this->isRegex($str) ? $str : '/'.preg_quote($str, '/').'/';
-    }
+	/**
+	 * Converts strings to regexp.
+	 *
+	 * PCRE patterns are left unchanged.
+	 *
+	 * Default conversion:
+	 *     'lorem/ipsum/dolor' ==>  'lorem\/ipsum\/dolor/'
+	 *
+	 * Use only / as directory separator (on Windows also).
+	 *
+	 * @param string $str Pattern: regexp or dirname
+	 *
+	 * @return string regexp corresponding to a given string or regexp
+	 */
+	protected function toRegex(string $str)
+	{
+		return $this->isRegex($str) ? $str : '/'.preg_quote($str, '/').'/';
+	}
 }

vendor/symfony/finder/Iterator/FileTypeFilterIterator.php

Indentation +33 added lines, -33 removed lines

@@ -18,37 +18,37 @@
  */
 class FileTypeFilterIterator extends \FilterIterator
 {
-    public const ONLY_FILES = 1;
-    public const ONLY_DIRECTORIES = 2;
-
-    private $mode;
-
-    /**
-     * @param \Iterator $iterator The Iterator to filter
-     * @param int       $mode     The mode (self::ONLY_FILES or self::ONLY_DIRECTORIES)
-     */
-    public function __construct(\Iterator $iterator, int $mode)
-    {
-        $this->mode = $mode;
-
-        parent::__construct($iterator);
-    }
-
-    /**
-     * Filters the iterator values.
-     *
-     * @return bool true if the value should be kept, false otherwise
-     */
-    #[\ReturnTypeWillChange]
-    public function accept()
-    {
-        $fileinfo = $this->current();
-        if (self::ONLY_DIRECTORIES === (self::ONLY_DIRECTORIES & $this->mode) && $fileinfo->isFile()) {
-            return false;
-        } elseif (self::ONLY_FILES === (self::ONLY_FILES & $this->mode) && $fileinfo->isDir()) {
-            return false;
-        }
-
-        return true;
-    }
+	public const ONLY_FILES = 1;
+	public const ONLY_DIRECTORIES = 2;
+
+	private $mode;
+
+	/**
+	 * @param \Iterator $iterator The Iterator to filter
+	 * @param int       $mode     The mode (self::ONLY_FILES or self::ONLY_DIRECTORIES)
+	 */
+	public function __construct(\Iterator $iterator, int $mode)
+	{
+		$this->mode = $mode;
+
+		parent::__construct($iterator);
+	}
+
+	/**
+	 * Filters the iterator values.
+	 *
+	 * @return bool true if the value should be kept, false otherwise
+	 */
+	#[\ReturnTypeWillChange]
+	public function accept()
+	{
+		$fileinfo = $this->current();
+		if (self::ONLY_DIRECTORIES === (self::ONLY_DIRECTORIES & $this->mode) && $fileinfo->isFile()) {
+			return false;
+		} elseif (self::ONLY_FILES === (self::ONLY_FILES & $this->mode) && $fileinfo->isDir()) {
+			return false;
+		}
+
+		return true;
+	}
 }

vendor/symfony/finder/Iterator/CustomFilterIterator.php

Indentation +38 added lines, -38 removed lines

@@ -21,42 +21,42 @@
  */
 class CustomFilterIterator extends \FilterIterator
 {
-    private $filters = [];
-
-    /**
-     * @param \Iterator  $iterator The Iterator to filter
-     * @param callable[] $filters  An array of PHP callbacks
-     *
-     * @throws \InvalidArgumentException
-     */
-    public function __construct(\Iterator $iterator, array $filters)
-    {
-        foreach ($filters as $filter) {
-            if (!\is_callable($filter)) {
-                throw new \InvalidArgumentException('Invalid PHP callback.');
-            }
-        }
-        $this->filters = $filters;
-
-        parent::__construct($iterator);
-    }
-
-    /**
-     * Filters the iterator values.
-     *
-     * @return bool true if the value should be kept, false otherwise
-     */
-    #[\ReturnTypeWillChange]
-    public function accept()
-    {
-        $fileinfo = $this->current();
-
-        foreach ($this->filters as $filter) {
-            if (false === $filter($fileinfo)) {
-                return false;
-            }
-        }
-
-        return true;
-    }
+	private $filters = [];
+
+	/**
+	 * @param \Iterator  $iterator The Iterator to filter
+	 * @param callable[] $filters  An array of PHP callbacks
+	 *
+	 * @throws \InvalidArgumentException
+	 */
+	public function __construct(\Iterator $iterator, array $filters)
+	{
+		foreach ($filters as $filter) {
+			if (!\is_callable($filter)) {
+				throw new \InvalidArgumentException('Invalid PHP callback.');
+			}
+		}
+		$this->filters = $filters;
+
+		parent::__construct($iterator);
+	}
+
+	/**
+	 * Filters the iterator values.
+	 *
+	 * @return bool true if the value should be kept, false otherwise
+	 */
+	#[\ReturnTypeWillChange]
+	public function accept()
+	{
+		$fileinfo = $this->current();
+
+		foreach ($this->filters as $filter) {
+			if (false === $filter($fileinfo)) {
+				return false;
+			}
+		}
+
+		return true;
+	}
 }

vendor/symfony/finder/Glob.php

Indentation +65 added lines, -65 removed lines

@@ -35,77 +35,77 @@
  */
 class Glob
 {
-    /**
-     * Returns a regexp which is the equivalent of the glob pattern.
-     *
-     * @return string
-     */
-    public static function toRegex(string $glob, bool $strictLeadingDot = true, bool $strictWildcardSlash = true, string $delimiter = '#')
-    {
-        $firstByte = true;
-        $escaping = false;
-        $inCurlies = 0;
-        $regex = '';
-        $sizeGlob = \strlen($glob);
-        for ($i = 0; $i < $sizeGlob; ++$i) {
-            $car = $glob[$i];
-            if ($firstByte && $strictLeadingDot && '.' !== $car) {
-                $regex .= '(?=[^\.])';
-            }
+	/**
+	 * Returns a regexp which is the equivalent of the glob pattern.
+	 *
+	 * @return string
+	 */
+	public static function toRegex(string $glob, bool $strictLeadingDot = true, bool $strictWildcardSlash = true, string $delimiter = '#')
+	{
+		$firstByte = true;
+		$escaping = false;
+		$inCurlies = 0;
+		$regex = '';
+		$sizeGlob = \strlen($glob);
+		for ($i = 0; $i < $sizeGlob; ++$i) {
+			$car = $glob[$i];
+			if ($firstByte && $strictLeadingDot && '.' !== $car) {
+				$regex .= '(?=[^\.])';
+			}
 
-            $firstByte = '/' === $car;
+			$firstByte = '/' === $car;
 
-            if ($firstByte && $strictWildcardSlash && isset($glob[$i + 2]) && '**' === $glob[$i + 1].$glob[$i + 2] && (!isset($glob[$i + 3]) || '/' === $glob[$i + 3])) {
-                $car = '[^/]++/';
-                if (!isset($glob[$i + 3])) {
-                    $car .= '?';
-                }
+			if ($firstByte && $strictWildcardSlash && isset($glob[$i + 2]) && '**' === $glob[$i + 1].$glob[$i + 2] && (!isset($glob[$i + 3]) || '/' === $glob[$i + 3])) {
+				$car = '[^/]++/';
+				if (!isset($glob[$i + 3])) {
+					$car .= '?';
+				}
 
-                if ($strictLeadingDot) {
-                    $car = '(?=[^\.])'.$car;
-                }
+				if ($strictLeadingDot) {
+					$car = '(?=[^\.])'.$car;
+				}
 
-                $car = '/(?:'.$car.')*';
-                $i += 2 + isset($glob[$i + 3]);
+				$car = '/(?:'.$car.')*';
+				$i += 2 + isset($glob[$i + 3]);
 
-                if ('/' === $delimiter) {
-                    $car = str_replace('/', '\\/', $car);
-                }
-            }
+				if ('/' === $delimiter) {
+					$car = str_replace('/', '\\/', $car);
+				}
+			}
 
-            if ($delimiter === $car || '.' === $car || '(' === $car || ')' === $car || '|' === $car || '+' === $car || '^' === $car || '$' === $car) {
-                $regex .= "\\$car";
-            } elseif ('*' === $car) {
-                $regex .= $escaping ? '\\*' : ($strictWildcardSlash ? '[^/]*' : '.*');
-            } elseif ('?' === $car) {
-                $regex .= $escaping ? '\\?' : ($strictWildcardSlash ? '[^/]' : '.');
-            } elseif ('{' === $car) {
-                $regex .= $escaping ? '\\{' : '(';
-                if (!$escaping) {
-                    ++$inCurlies;
-                }
-            } elseif ('}' === $car && $inCurlies) {
-                $regex .= $escaping ? '}' : ')';
-                if (!$escaping) {
-                    --$inCurlies;
-                }
-            } elseif (',' === $car && $inCurlies) {
-                $regex .= $escaping ? ',' : '|';
-            } elseif ('\\' === $car) {
-                if ($escaping) {
-                    $regex .= '\\\\';
-                    $escaping = false;
-                } else {
-                    $escaping = true;
-                }
+			if ($delimiter === $car || '.' === $car || '(' === $car || ')' === $car || '|' === $car || '+' === $car || '^' === $car || '$' === $car) {
+				$regex .= "\\$car";
+			} elseif ('*' === $car) {
+				$regex .= $escaping ? '\\*' : ($strictWildcardSlash ? '[^/]*' : '.*');
+			} elseif ('?' === $car) {
+				$regex .= $escaping ? '\\?' : ($strictWildcardSlash ? '[^/]' : '.');
+			} elseif ('{' === $car) {
+				$regex .= $escaping ? '\\{' : '(';
+				if (!$escaping) {
+					++$inCurlies;
+				}
+			} elseif ('}' === $car && $inCurlies) {
+				$regex .= $escaping ? '}' : ')';
+				if (!$escaping) {
+					--$inCurlies;
+				}
+			} elseif (',' === $car && $inCurlies) {
+				$regex .= $escaping ? ',' : '|';
+			} elseif ('\\' === $car) {
+				if ($escaping) {
+					$regex .= '\\\\';
+					$escaping = false;
+				} else {
+					$escaping = true;
+				}
 
-                continue;
-            } else {
-                $regex .= $car;
-            }
-            $escaping = false;
-        }
+				continue;
+			} else {
+				$regex .= $car;
+			}
+			$escaping = false;
+		}
 
-        return $delimiter.'^'.$regex.'$'.$delimiter;
-    }
+		return $delimiter.'^'.$regex.'$'.$delimiter;
+	}
 }

vendor/symfony/finder/Finder.php

Indentation +766 added lines, -766 removed lines

@@ -39,770 +39,770 @@
  */
 class Finder implements \IteratorAggregate, \Countable
 {
-    public const IGNORE_VCS_FILES = 1;
-    public const IGNORE_DOT_FILES = 2;
-    public const IGNORE_VCS_IGNORED_FILES = 4;
-
-    private $mode = 0;
-    private $names = [];
-    private $notNames = [];
-    private $exclude = [];
-    private $filters = [];
-    private $depths = [];
-    private $sizes = [];
-    private $followLinks = false;
-    private $reverseSorting = false;
-    private $sort = false;
-    private $ignore = 0;
-    private $dirs = [];
-    private $dates = [];
-    private $iterators = [];
-    private $contains = [];
-    private $notContains = [];
-    private $paths = [];
-    private $notPaths = [];
-    private $ignoreUnreadableDirs = false;
-
-    private static $vcsPatterns = ['.svn', '_svn', 'CVS', '_darcs', '.arch-params', '.monotone', '.bzr', '.git', '.hg'];
-
-    public function __construct()
-    {
-        $this->ignore = static::IGNORE_VCS_FILES | static::IGNORE_DOT_FILES;
-    }
-
-    /**
-     * Creates a new Finder.
-     *
-     * @return static
-     */
-    public static function create()
-    {
-        return new static();
-    }
-
-    /**
-     * Restricts the matching to directories only.
-     *
-     * @return $this
-     */
-    public function directories()
-    {
-        $this->mode = Iterator\FileTypeFilterIterator::ONLY_DIRECTORIES;
-
-        return $this;
-    }
-
-    /**
-     * Restricts the matching to files only.
-     *
-     * @return $this
-     */
-    public function files()
-    {
-        $this->mode = Iterator\FileTypeFilterIterator::ONLY_FILES;
-
-        return $this;
-    }
-
-    /**
-     * Adds tests for the directory depth.
-     *
-     * Usage:
-     *
-     *     $finder->depth('> 1') // the Finder will start matching at level 1.
-     *     $finder->depth('< 3') // the Finder will descend at most 3 levels of directories below the starting point.
-     *     $finder->depth(['>= 1', '< 3'])
-     *
-     * @param string|int|string[]|int[] $levels The depth level expression or an array of depth levels
-     *
-     * @return $this
-     *
-     * @see DepthRangeFilterIterator
-     * @see NumberComparator
-     */
-    public function depth($levels)
-    {
-        foreach ((array) $levels as $level) {
-            $this->depths[] = new Comparator\NumberComparator($level);
-        }
-
-        return $this;
-    }
-
-    /**
-     * Adds tests for file dates (last modified).
-     *
-     * The date must be something that strtotime() is able to parse:
-     *
-     *     $finder->date('since yesterday');
-     *     $finder->date('until 2 days ago');
-     *     $finder->date('> now - 2 hours');
-     *     $finder->date('>= 2005-10-15');
-     *     $finder->date(['>= 2005-10-15', '<= 2006-05-27']);
-     *
-     * @param string|string[] $dates A date range string or an array of date ranges
-     *
-     * @return $this
-     *
-     * @see strtotime
-     * @see DateRangeFilterIterator
-     * @see DateComparator
-     */
-    public function date($dates)
-    {
-        foreach ((array) $dates as $date) {
-            $this->dates[] = new Comparator\DateComparator($date);
-        }
-
-        return $this;
-    }
-
-    /**
-     * Adds rules that files must match.
-     *
-     * You can use patterns (delimited with / sign), globs or simple strings.
-     *
-     *     $finder->name('*.php')
-     *     $finder->name('/\.php$/') // same as above
-     *     $finder->name('test.php')
-     *     $finder->name(['test.py', 'test.php'])
-     *
-     * @param string|string[] $patterns A pattern (a regexp, a glob, or a string) or an array of patterns
-     *
-     * @return $this
-     *
-     * @see FilenameFilterIterator
-     */
-    public function name($patterns)
-    {
-        $this->names = array_merge($this->names, (array) $patterns);
-
-        return $this;
-    }
-
-    /**
-     * Adds rules that files must not match.
-     *
-     * @param string|string[] $patterns A pattern (a regexp, a glob, or a string) or an array of patterns
-     *
-     * @return $this
-     *
-     * @see FilenameFilterIterator
-     */
-    public function notName($patterns)
-    {
-        $this->notNames = array_merge($this->notNames, (array) $patterns);
-
-        return $this;
-    }
-
-    /**
-     * Adds tests that file contents must match.
-     *
-     * Strings or PCRE patterns can be used:
-     *
-     *     $finder->contains('Lorem ipsum')
-     *     $finder->contains('/Lorem ipsum/i')
-     *     $finder->contains(['dolor', '/ipsum/i'])
-     *
-     * @param string|string[] $patterns A pattern (string or regexp) or an array of patterns
-     *
-     * @return $this
-     *
-     * @see FilecontentFilterIterator
-     */
-    public function contains($patterns)
-    {
-        $this->contains = array_merge($this->contains, (array) $patterns);
-
-        return $this;
-    }
-
-    /**
-     * Adds tests that file contents must not match.
-     *
-     * Strings or PCRE patterns can be used:
-     *
-     *     $finder->notContains('Lorem ipsum')
-     *     $finder->notContains('/Lorem ipsum/i')
-     *     $finder->notContains(['lorem', '/dolor/i'])
-     *
-     * @param string|string[] $patterns A pattern (string or regexp) or an array of patterns
-     *
-     * @return $this
-     *
-     * @see FilecontentFilterIterator
-     */
-    public function notContains($patterns)
-    {
-        $this->notContains = array_merge($this->notContains, (array) $patterns);
-
-        return $this;
-    }
-
-    /**
-     * Adds rules that filenames must match.
-     *
-     * You can use patterns (delimited with / sign) or simple strings.
-     *
-     *     $finder->path('some/special/dir')
-     *     $finder->path('/some\/special\/dir/') // same as above
-     *     $finder->path(['some dir', 'another/dir'])
-     *
-     * Use only / as dirname separator.
-     *
-     * @param string|string[] $patterns A pattern (a regexp or a string) or an array of patterns
-     *
-     * @return $this
-     *
-     * @see FilenameFilterIterator
-     */
-    public function path($patterns)
-    {
-        $this->paths = array_merge($this->paths, (array) $patterns);
-
-        return $this;
-    }
-
-    /**
-     * Adds rules that filenames must not match.
-     *
-     * You can use patterns (delimited with / sign) or simple strings.
-     *
-     *     $finder->notPath('some/special/dir')
-     *     $finder->notPath('/some\/special\/dir/') // same as above
-     *     $finder->notPath(['some/file.txt', 'another/file.log'])
-     *
-     * Use only / as dirname separator.
-     *
-     * @param string|string[] $patterns A pattern (a regexp or a string) or an array of patterns
-     *
-     * @return $this
-     *
-     * @see FilenameFilterIterator
-     */
-    public function notPath($patterns)
-    {
-        $this->notPaths = array_merge($this->notPaths, (array) $patterns);
-
-        return $this;
-    }
-
-    /**
-     * Adds tests for file sizes.
-     *
-     *     $finder->size('> 10K');
-     *     $finder->size('<= 1Ki');
-     *     $finder->size(4);
-     *     $finder->size(['> 10K', '< 20K'])
-     *
-     * @param string|int|string[]|int[] $sizes A size range string or an integer or an array of size ranges
-     *
-     * @return $this
-     *
-     * @see SizeRangeFilterIterator
-     * @see NumberComparator
-     */
-    public function size($sizes)
-    {
-        foreach ((array) $sizes as $size) {
-            $this->sizes[] = new Comparator\NumberComparator($size);
-        }
-
-        return $this;
-    }
-
-    /**
-     * Excludes directories.
-     *
-     * Directories passed as argument must be relative to the ones defined with the `in()` method. For example:
-     *
-     *     $finder->in(__DIR__)->exclude('ruby');
-     *
-     * @param string|array $dirs A directory path or an array of directories
-     *
-     * @return $this
-     *
-     * @see ExcludeDirectoryFilterIterator
-     */
-    public function exclude($dirs)
-    {
-        $this->exclude = array_merge($this->exclude, (array) $dirs);
-
-        return $this;
-    }
-
-    /**
-     * Excludes "hidden" directories and files (starting with a dot).
-     *
-     * This option is enabled by default.
-     *
-     * @return $this
-     *
-     * @see ExcludeDirectoryFilterIterator
-     */
-    public function ignoreDotFiles(bool $ignoreDotFiles)
-    {
-        if ($ignoreDotFiles) {
-            $this->ignore |= static::IGNORE_DOT_FILES;
-        } else {
-            $this->ignore &= ~static::IGNORE_DOT_FILES;
-        }
-
-        return $this;
-    }
-
-    /**
-     * Forces the finder to ignore version control directories.
-     *
-     * This option is enabled by default.
-     *
-     * @return $this
-     *
-     * @see ExcludeDirectoryFilterIterator
-     */
-    public function ignoreVCS(bool $ignoreVCS)
-    {
-        if ($ignoreVCS) {
-            $this->ignore |= static::IGNORE_VCS_FILES;
-        } else {
-            $this->ignore &= ~static::IGNORE_VCS_FILES;
-        }
-
-        return $this;
-    }
-
-    /**
-     * Forces Finder to obey .gitignore and ignore files based on rules listed there.
-     *
-     * This option is disabled by default.
-     *
-     * @return $this
-     */
-    public function ignoreVCSIgnored(bool $ignoreVCSIgnored)
-    {
-        if ($ignoreVCSIgnored) {
-            $this->ignore |= static::IGNORE_VCS_IGNORED_FILES;
-        } else {
-            $this->ignore &= ~static::IGNORE_VCS_IGNORED_FILES;
-        }
-
-        return $this;
-    }
-
-    /**
-     * Adds VCS patterns.
-     *
-     * @see ignoreVCS()
-     *
-     * @param string|string[] $pattern VCS patterns to ignore
-     */
-    public static function addVCSPattern($pattern)
-    {
-        foreach ((array) $pattern as $p) {
-            self::$vcsPatterns[] = $p;
-        }
-
-        self::$vcsPatterns = array_unique(self::$vcsPatterns);
-    }
-
-    /**
-     * Sorts files and directories by an anonymous function.
-     *
-     * The anonymous function receives two \SplFileInfo instances to compare.
-     *
-     * This can be slow as all the matching files and directories must be retrieved for comparison.
-     *
-     * @return $this
-     *
-     * @see SortableIterator
-     */
-    public function sort(\Closure $closure)
-    {
-        $this->sort = $closure;
-
-        return $this;
-    }
-
-    /**
-     * Sorts files and directories by name.
-     *
-     * This can be slow as all the matching files and directories must be retrieved for comparison.
-     *
-     * @return $this
-     *
-     * @see SortableIterator
-     */
-    public function sortByName(bool $useNaturalSort = false)
-    {
-        $this->sort = $useNaturalSort ? Iterator\SortableIterator::SORT_BY_NAME_NATURAL : Iterator\SortableIterator::SORT_BY_NAME;
-
-        return $this;
-    }
-
-    /**
-     * Sorts files and directories by type (directories before files), then by name.
-     *
-     * This can be slow as all the matching files and directories must be retrieved for comparison.
-     *
-     * @return $this
-     *
-     * @see SortableIterator
-     */
-    public function sortByType()
-    {
-        $this->sort = Iterator\SortableIterator::SORT_BY_TYPE;
-
-        return $this;
-    }
-
-    /**
-     * Sorts files and directories by the last accessed time.
-     *
-     * This is the time that the file was last accessed, read or written to.
-     *
-     * This can be slow as all the matching files and directories must be retrieved for comparison.
-     *
-     * @return $this
-     *
-     * @see SortableIterator
-     */
-    public function sortByAccessedTime()
-    {
-        $this->sort = Iterator\SortableIterator::SORT_BY_ACCESSED_TIME;
-
-        return $this;
-    }
-
-    /**
-     * Reverses the sorting.
-     *
-     * @return $this
-     */
-    public function reverseSorting()
-    {
-        $this->reverseSorting = true;
-
-        return $this;
-    }
-
-    /**
-     * Sorts files and directories by the last inode changed time.
-     *
-     * This is the time that the inode information was last modified (permissions, owner, group or other metadata).
-     *
-     * On Windows, since inode is not available, changed time is actually the file creation time.
-     *
-     * This can be slow as all the matching files and directories must be retrieved for comparison.
-     *
-     * @return $this
-     *
-     * @see SortableIterator
-     */
-    public function sortByChangedTime()
-    {
-        $this->sort = Iterator\SortableIterator::SORT_BY_CHANGED_TIME;
-
-        return $this;
-    }
-
-    /**
-     * Sorts files and directories by the last modified time.
-     *
-     * This is the last time the actual contents of the file were last modified.
-     *
-     * This can be slow as all the matching files and directories must be retrieved for comparison.
-     *
-     * @return $this
-     *
-     * @see SortableIterator
-     */
-    public function sortByModifiedTime()
-    {
-        $this->sort = Iterator\SortableIterator::SORT_BY_MODIFIED_TIME;
-
-        return $this;
-    }
-
-    /**
-     * Filters the iterator with an anonymous function.
-     *
-     * The anonymous function receives a \SplFileInfo and must return false
-     * to remove files.
-     *
-     * @return $this
-     *
-     * @see CustomFilterIterator
-     */
-    public function filter(\Closure $closure)
-    {
-        $this->filters[] = $closure;
-
-        return $this;
-    }
-
-    /**
-     * Forces the following of symlinks.
-     *
-     * @return $this
-     */
-    public function followLinks()
-    {
-        $this->followLinks = true;
-
-        return $this;
-    }
-
-    /**
-     * Tells finder to ignore unreadable directories.
-     *
-     * By default, scanning unreadable directories content throws an AccessDeniedException.
-     *
-     * @return $this
-     */
-    public function ignoreUnreadableDirs(bool $ignore = true)
-    {
-        $this->ignoreUnreadableDirs = $ignore;
-
-        return $this;
-    }
-
-    /**
-     * Searches files and directories which match defined rules.
-     *
-     * @param string|string[] $dirs A directory path or an array of directories
-     *
-     * @return $this
-     *
-     * @throws DirectoryNotFoundException if one of the directories does not exist
-     */
-    public function in($dirs)
-    {
-        $resolvedDirs = [];
-
-        foreach ((array) $dirs as $dir) {
-            if (is_dir($dir)) {
-                $resolvedDirs[] = $this->normalizeDir($dir);
-            } elseif ($glob = glob($dir, (\defined('GLOB_BRACE') ? \GLOB_BRACE : 0) | \GLOB_ONLYDIR | \GLOB_NOSORT)) {
-                sort($glob);
-                $resolvedDirs = array_merge($resolvedDirs, array_map([$this, 'normalizeDir'], $glob));
-            } else {
-                throw new DirectoryNotFoundException(sprintf('The "%s" directory does not exist.', $dir));
-            }
-        }
-
-        $this->dirs = array_merge($this->dirs, $resolvedDirs);
-
-        return $this;
-    }
-
-    /**
-     * Returns an Iterator for the current Finder configuration.
-     *
-     * This method implements the IteratorAggregate interface.
-     *
-     * @return \Iterator|SplFileInfo[] An iterator
-     *
-     * @throws \LogicException if the in() method has not been called
-     */
-    #[\ReturnTypeWillChange]
-    public function getIterator()
-    {
-        if (0 === \count($this->dirs) && 0 === \count($this->iterators)) {
-            throw new \LogicException('You must call one of in() or append() methods before iterating over a Finder.');
-        }
-
-        if (1 === \count($this->dirs) && 0 === \count($this->iterators)) {
-            $iterator = $this->searchInDirectory($this->dirs[0]);
-
-            if ($this->sort || $this->reverseSorting) {
-                $iterator = (new Iterator\SortableIterator($iterator, $this->sort, $this->reverseSorting))->getIterator();
-            }
-
-            return $iterator;
-        }
-
-        $iterator = new \AppendIterator();
-        foreach ($this->dirs as $dir) {
-            $iterator->append(new \IteratorIterator(new LazyIterator(function () use ($dir) {
-                return $this->searchInDirectory($dir);
-            })));
-        }
-
-        foreach ($this->iterators as $it) {
-            $iterator->append($it);
-        }
-
-        if ($this->sort || $this->reverseSorting) {
-            $iterator = (new Iterator\SortableIterator($iterator, $this->sort, $this->reverseSorting))->getIterator();
-        }
-
-        return $iterator;
-    }
-
-    /**
-     * Appends an existing set of files/directories to the finder.
-     *
-     * The set can be another Finder, an Iterator, an IteratorAggregate, or even a plain array.
-     *
-     * @return $this
-     *
-     * @throws \InvalidArgumentException when the given argument is not iterable
-     */
-    public function append(iterable $iterator)
-    {
-        if ($iterator instanceof \IteratorAggregate) {
-            $this->iterators[] = $iterator->getIterator();
-        } elseif ($iterator instanceof \Iterator) {
-            $this->iterators[] = $iterator;
-        } elseif (is_iterable($iterator)) {
-            $it = new \ArrayIterator();
-            foreach ($iterator as $file) {
-                $file = $file instanceof \SplFileInfo ? $file : new \SplFileInfo($file);
-                $it[$file->getPathname()] = $file;
-            }
-            $this->iterators[] = $it;
-        } else {
-            throw new \InvalidArgumentException('Finder::append() method wrong argument type.');
-        }
-
-        return $this;
-    }
-
-    /**
-     * Check if any results were found.
-     *
-     * @return bool
-     */
-    public function hasResults()
-    {
-        foreach ($this->getIterator() as $_) {
-            return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * Counts all the results collected by the iterators.
-     *
-     * @return int
-     */
-    #[\ReturnTypeWillChange]
-    public function count()
-    {
-        return iterator_count($this->getIterator());
-    }
-
-    private function searchInDirectory(string $dir): \Iterator
-    {
-        $exclude = $this->exclude;
-        $notPaths = $this->notPaths;
-
-        if (static::IGNORE_VCS_FILES === (static::IGNORE_VCS_FILES & $this->ignore)) {
-            $exclude = array_merge($exclude, self::$vcsPatterns);
-        }
-
-        if (static::IGNORE_DOT_FILES === (static::IGNORE_DOT_FILES & $this->ignore)) {
-            $notPaths[] = '#(^|/)\..+(/|$)#';
-        }
-
-        if (static::IGNORE_VCS_IGNORED_FILES === (static::IGNORE_VCS_IGNORED_FILES & $this->ignore)) {
-            $gitignoreFilePath = sprintf('%s/.gitignore', $dir);
-            if (!is_readable($gitignoreFilePath)) {
-                throw new \RuntimeException(sprintf('The "ignoreVCSIgnored" option cannot be used by the Finder as the "%s" file is not readable.', $gitignoreFilePath));
-            }
-            $notPaths = array_merge($notPaths, [Gitignore::toRegex(file_get_contents($gitignoreFilePath))]);
-        }
-
-        $minDepth = 0;
-        $maxDepth = \PHP_INT_MAX;
-
-        foreach ($this->depths as $comparator) {
-            switch ($comparator->getOperator()) {
-                case '>':
-                    $minDepth = $comparator->getTarget() + 1;
-                    break;
-                case '>=':
-                    $minDepth = $comparator->getTarget();
-                    break;
-                case '<':
-                    $maxDepth = $comparator->getTarget() - 1;
-                    break;
-                case '<=':
-                    $maxDepth = $comparator->getTarget();
-                    break;
-                default:
-                    $minDepth = $maxDepth = $comparator->getTarget();
-            }
-        }
-
-        $flags = \RecursiveDirectoryIterator::SKIP_DOTS;
-
-        if ($this->followLinks) {
-            $flags |= \RecursiveDirectoryIterator::FOLLOW_SYMLINKS;
-        }
-
-        $iterator = new Iterator\RecursiveDirectoryIterator($dir, $flags, $this->ignoreUnreadableDirs);
-
-        if ($exclude) {
-            $iterator = new Iterator\ExcludeDirectoryFilterIterator($iterator, $exclude);
-        }
-
-        $iterator = new \RecursiveIteratorIterator($iterator, \RecursiveIteratorIterator::SELF_FIRST);
-
-        if ($minDepth > 0 || $maxDepth < \PHP_INT_MAX) {
-            $iterator = new Iterator\DepthRangeFilterIterator($iterator, $minDepth, $maxDepth);
-        }
-
-        if ($this->mode) {
-            $iterator = new Iterator\FileTypeFilterIterator($iterator, $this->mode);
-        }
-
-        if ($this->names || $this->notNames) {
-            $iterator = new Iterator\FilenameFilterIterator($iterator, $this->names, $this->notNames);
-        }
-
-        if ($this->contains || $this->notContains) {
-            $iterator = new Iterator\FilecontentFilterIterator($iterator, $this->contains, $this->notContains);
-        }
-
-        if ($this->sizes) {
-            $iterator = new Iterator\SizeRangeFilterIterator($iterator, $this->sizes);
-        }
-
-        if ($this->dates) {
-            $iterator = new Iterator\DateRangeFilterIterator($iterator, $this->dates);
-        }
-
-        if ($this->filters) {
-            $iterator = new Iterator\CustomFilterIterator($iterator, $this->filters);
-        }
-
-        if ($this->paths || $notPaths) {
-            $iterator = new Iterator\PathFilterIterator($iterator, $this->paths, $notPaths);
-        }
-
-        return $iterator;
-    }
-
-    /**
-     * Normalizes given directory names by removing trailing slashes.
-     *
-     * Excluding: (s)ftp:// or ssh2.(s)ftp:// wrapper
-     */
-    private function normalizeDir(string $dir): string
-    {
-        if ('/' === $dir) {
-            return $dir;
-        }
-
-        $dir = rtrim($dir, '/'.\DIRECTORY_SEPARATOR);
-
-        if (preg_match('#^(ssh2\.)?s?ftp://#', $dir)) {
-            $dir .= '/';
-        }
-
-        return $dir;
-    }
+	public const IGNORE_VCS_FILES = 1;
+	public const IGNORE_DOT_FILES = 2;
+	public const IGNORE_VCS_IGNORED_FILES = 4;
+
+	private $mode = 0;
+	private $names = [];
+	private $notNames = [];
+	private $exclude = [];
+	private $filters = [];
+	private $depths = [];
+	private $sizes = [];
+	private $followLinks = false;
+	private $reverseSorting = false;
+	private $sort = false;
+	private $ignore = 0;
+	private $dirs = [];
+	private $dates = [];
+	private $iterators = [];
+	private $contains = [];
+	private $notContains = [];
+	private $paths = [];
+	private $notPaths = [];
+	private $ignoreUnreadableDirs = false;
+
+	private static $vcsPatterns = ['.svn', '_svn', 'CVS', '_darcs', '.arch-params', '.monotone', '.bzr', '.git', '.hg'];
+
+	public function __construct()
+	{
+		$this->ignore = static::IGNORE_VCS_FILES | static::IGNORE_DOT_FILES;
+	}
+
+	/**
+	 * Creates a new Finder.
+	 *
+	 * @return static
+	 */
+	public static function create()
+	{
+		return new static();
+	}
+
+	/**
+	 * Restricts the matching to directories only.
+	 *
+	 * @return $this
+	 */
+	public function directories()
+	{
+		$this->mode = Iterator\FileTypeFilterIterator::ONLY_DIRECTORIES;
+
+		return $this;
+	}
+
+	/**
+	 * Restricts the matching to files only.
+	 *
+	 * @return $this
+	 */
+	public function files()
+	{
+		$this->mode = Iterator\FileTypeFilterIterator::ONLY_FILES;
+
+		return $this;
+	}
+
+	/**
+	 * Adds tests for the directory depth.
+	 *
+	 * Usage:
+	 *
+	 *     $finder->depth('> 1') // the Finder will start matching at level 1.
+	 *     $finder->depth('< 3') // the Finder will descend at most 3 levels of directories below the starting point.
+	 *     $finder->depth(['>= 1', '< 3'])
+	 *
+	 * @param string|int|string[]|int[] $levels The depth level expression or an array of depth levels
+	 *
+	 * @return $this
+	 *
+	 * @see DepthRangeFilterIterator
+	 * @see NumberComparator
+	 */
+	public function depth($levels)
+	{
+		foreach ((array) $levels as $level) {
+			$this->depths[] = new Comparator\NumberComparator($level);
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Adds tests for file dates (last modified).
+	 *
+	 * The date must be something that strtotime() is able to parse:
+	 *
+	 *     $finder->date('since yesterday');
+	 *     $finder->date('until 2 days ago');
+	 *     $finder->date('> now - 2 hours');
+	 *     $finder->date('>= 2005-10-15');
+	 *     $finder->date(['>= 2005-10-15', '<= 2006-05-27']);
+	 *
+	 * @param string|string[] $dates A date range string or an array of date ranges
+	 *
+	 * @return $this
+	 *
+	 * @see strtotime
+	 * @see DateRangeFilterIterator
+	 * @see DateComparator
+	 */
+	public function date($dates)
+	{
+		foreach ((array) $dates as $date) {
+			$this->dates[] = new Comparator\DateComparator($date);
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Adds rules that files must match.
+	 *
+	 * You can use patterns (delimited with / sign), globs or simple strings.
+	 *
+	 *     $finder->name('*.php')
+	 *     $finder->name('/\.php$/') // same as above
+	 *     $finder->name('test.php')
+	 *     $finder->name(['test.py', 'test.php'])
+	 *
+	 * @param string|string[] $patterns A pattern (a regexp, a glob, or a string) or an array of patterns
+	 *
+	 * @return $this
+	 *
+	 * @see FilenameFilterIterator
+	 */
+	public function name($patterns)
+	{
+		$this->names = array_merge($this->names, (array) $patterns);
+
+		return $this;
+	}
+
+	/**
+	 * Adds rules that files must not match.
+	 *
+	 * @param string|string[] $patterns A pattern (a regexp, a glob, or a string) or an array of patterns
+	 *
+	 * @return $this
+	 *
+	 * @see FilenameFilterIterator
+	 */
+	public function notName($patterns)
+	{
+		$this->notNames = array_merge($this->notNames, (array) $patterns);
+
+		return $this;
+	}
+
+	/**
+	 * Adds tests that file contents must match.
+	 *
+	 * Strings or PCRE patterns can be used:
+	 *
+	 *     $finder->contains('Lorem ipsum')
+	 *     $finder->contains('/Lorem ipsum/i')
+	 *     $finder->contains(['dolor', '/ipsum/i'])
+	 *
+	 * @param string|string[] $patterns A pattern (string or regexp) or an array of patterns
+	 *
+	 * @return $this
+	 *
+	 * @see FilecontentFilterIterator
+	 */
+	public function contains($patterns)
+	{
+		$this->contains = array_merge($this->contains, (array) $patterns);
+
+		return $this;
+	}
+
+	/**
+	 * Adds tests that file contents must not match.
+	 *
+	 * Strings or PCRE patterns can be used:
+	 *
+	 *     $finder->notContains('Lorem ipsum')
+	 *     $finder->notContains('/Lorem ipsum/i')
+	 *     $finder->notContains(['lorem', '/dolor/i'])
+	 *
+	 * @param string|string[] $patterns A pattern (string or regexp) or an array of patterns
+	 *
+	 * @return $this
+	 *
+	 * @see FilecontentFilterIterator
+	 */
+	public function notContains($patterns)
+	{
+		$this->notContains = array_merge($this->notContains, (array) $patterns);
+
+		return $this;
+	}
+
+	/**
+	 * Adds rules that filenames must match.
+	 *
+	 * You can use patterns (delimited with / sign) or simple strings.
+	 *
+	 *     $finder->path('some/special/dir')
+	 *     $finder->path('/some\/special\/dir/') // same as above
+	 *     $finder->path(['some dir', 'another/dir'])
+	 *
+	 * Use only / as dirname separator.
+	 *
+	 * @param string|string[] $patterns A pattern (a regexp or a string) or an array of patterns
+	 *
+	 * @return $this
+	 *
+	 * @see FilenameFilterIterator
+	 */
+	public function path($patterns)
+	{
+		$this->paths = array_merge($this->paths, (array) $patterns);
+
+		return $this;
+	}
+
+	/**
+	 * Adds rules that filenames must not match.
+	 *
+	 * You can use patterns (delimited with / sign) or simple strings.
+	 *
+	 *     $finder->notPath('some/special/dir')
+	 *     $finder->notPath('/some\/special\/dir/') // same as above
+	 *     $finder->notPath(['some/file.txt', 'another/file.log'])
+	 *
+	 * Use only / as dirname separator.
+	 *
+	 * @param string|string[] $patterns A pattern (a regexp or a string) or an array of patterns
+	 *
+	 * @return $this
+	 *
+	 * @see FilenameFilterIterator
+	 */
+	public function notPath($patterns)
+	{
+		$this->notPaths = array_merge($this->notPaths, (array) $patterns);
+
+		return $this;
+	}
+
+	/**
+	 * Adds tests for file sizes.
+	 *
+	 *     $finder->size('> 10K');
+	 *     $finder->size('<= 1Ki');
+	 *     $finder->size(4);
+	 *     $finder->size(['> 10K', '< 20K'])
+	 *
+	 * @param string|int|string[]|int[] $sizes A size range string or an integer or an array of size ranges
+	 *
+	 * @return $this
+	 *
+	 * @see SizeRangeFilterIterator
+	 * @see NumberComparator
+	 */
+	public function size($sizes)
+	{
+		foreach ((array) $sizes as $size) {
+			$this->sizes[] = new Comparator\NumberComparator($size);
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Excludes directories.
+	 *
+	 * Directories passed as argument must be relative to the ones defined with the `in()` method. For example:
+	 *
+	 *     $finder->in(__DIR__)->exclude('ruby');
+	 *
+	 * @param string|array $dirs A directory path or an array of directories
+	 *
+	 * @return $this
+	 *
+	 * @see ExcludeDirectoryFilterIterator
+	 */
+	public function exclude($dirs)
+	{
+		$this->exclude = array_merge($this->exclude, (array) $dirs);
+
+		return $this;
+	}
+
+	/**
+	 * Excludes "hidden" directories and files (starting with a dot).
+	 *
+	 * This option is enabled by default.
+	 *
+	 * @return $this
+	 *
+	 * @see ExcludeDirectoryFilterIterator
+	 */
+	public function ignoreDotFiles(bool $ignoreDotFiles)
+	{
+		if ($ignoreDotFiles) {
+			$this->ignore |= static::IGNORE_DOT_FILES;
+		} else {
+			$this->ignore &= ~static::IGNORE_DOT_FILES;
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Forces the finder to ignore version control directories.
+	 *
+	 * This option is enabled by default.
+	 *
+	 * @return $this
+	 *
+	 * @see ExcludeDirectoryFilterIterator
+	 */
+	public function ignoreVCS(bool $ignoreVCS)
+	{
+		if ($ignoreVCS) {
+			$this->ignore |= static::IGNORE_VCS_FILES;
+		} else {
+			$this->ignore &= ~static::IGNORE_VCS_FILES;
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Forces Finder to obey .gitignore and ignore files based on rules listed there.
+	 *
+	 * This option is disabled by default.
+	 *
+	 * @return $this
+	 */
+	public function ignoreVCSIgnored(bool $ignoreVCSIgnored)
+	{
+		if ($ignoreVCSIgnored) {
+			$this->ignore |= static::IGNORE_VCS_IGNORED_FILES;
+		} else {
+			$this->ignore &= ~static::IGNORE_VCS_IGNORED_FILES;
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Adds VCS patterns.
+	 *
+	 * @see ignoreVCS()
+	 *
+	 * @param string|string[] $pattern VCS patterns to ignore
+	 */
+	public static function addVCSPattern($pattern)
+	{
+		foreach ((array) $pattern as $p) {
+			self::$vcsPatterns[] = $p;
+		}
+
+		self::$vcsPatterns = array_unique(self::$vcsPatterns);
+	}
+
+	/**
+	 * Sorts files and directories by an anonymous function.
+	 *
+	 * The anonymous function receives two \SplFileInfo instances to compare.
+	 *
+	 * This can be slow as all the matching files and directories must be retrieved for comparison.
+	 *
+	 * @return $this
+	 *
+	 * @see SortableIterator
+	 */
+	public function sort(\Closure $closure)
+	{
+		$this->sort = $closure;
+
+		return $this;
+	}
+
+	/**
+	 * Sorts files and directories by name.
+	 *
+	 * This can be slow as all the matching files and directories must be retrieved for comparison.
+	 *
+	 * @return $this
+	 *
+	 * @see SortableIterator
+	 */
+	public function sortByName(bool $useNaturalSort = false)
+	{
+		$this->sort = $useNaturalSort ? Iterator\SortableIterator::SORT_BY_NAME_NATURAL : Iterator\SortableIterator::SORT_BY_NAME;
+
+		return $this;
+	}
+
+	/**
+	 * Sorts files and directories by type (directories before files), then by name.
+	 *
+	 * This can be slow as all the matching files and directories must be retrieved for comparison.
+	 *
+	 * @return $this
+	 *
+	 * @see SortableIterator
+	 */
+	public function sortByType()
+	{
+		$this->sort = Iterator\SortableIterator::SORT_BY_TYPE;
+
+		return $this;
+	}
+
+	/**
+	 * Sorts files and directories by the last accessed time.
+	 *
+	 * This is the time that the file was last accessed, read or written to.
+	 *
+	 * This can be slow as all the matching files and directories must be retrieved for comparison.
+	 *
+	 * @return $this
+	 *
+	 * @see SortableIterator
+	 */
+	public function sortByAccessedTime()
+	{
+		$this->sort = Iterator\SortableIterator::SORT_BY_ACCESSED_TIME;
+
+		return $this;
+	}
+
+	/**
+	 * Reverses the sorting.
+	 *
+	 * @return $this
+	 */
+	public function reverseSorting()
+	{
+		$this->reverseSorting = true;
+
+		return $this;
+	}
+
+	/**
+	 * Sorts files and directories by the last inode changed time.
+	 *
+	 * This is the time that the inode information was last modified (permissions, owner, group or other metadata).
+	 *
+	 * On Windows, since inode is not available, changed time is actually the file creation time.
+	 *
+	 * This can be slow as all the matching files and directories must be retrieved for comparison.
+	 *
+	 * @return $this
+	 *
+	 * @see SortableIterator
+	 */
+	public function sortByChangedTime()
+	{
+		$this->sort = Iterator\SortableIterator::SORT_BY_CHANGED_TIME;
+
+		return $this;
+	}
+
+	/**
+	 * Sorts files and directories by the last modified time.
+	 *
+	 * This is the last time the actual contents of the file were last modified.
+	 *
+	 * This can be slow as all the matching files and directories must be retrieved for comparison.
+	 *
+	 * @return $this
+	 *
+	 * @see SortableIterator
+	 */
+	public function sortByModifiedTime()
+	{
+		$this->sort = Iterator\SortableIterator::SORT_BY_MODIFIED_TIME;
+
+		return $this;
+	}
+
+	/**
+	 * Filters the iterator with an anonymous function.
+	 *
+	 * The anonymous function receives a \SplFileInfo and must return false
+	 * to remove files.
+	 *
+	 * @return $this
+	 *
+	 * @see CustomFilterIterator
+	 */
+	public function filter(\Closure $closure)
+	{
+		$this->filters[] = $closure;
+
+		return $this;
+	}
+
+	/**
+	 * Forces the following of symlinks.
+	 *
+	 * @return $this
+	 */
+	public function followLinks()
+	{
+		$this->followLinks = true;
+
+		return $this;
+	}
+
+	/**
+	 * Tells finder to ignore unreadable directories.
+	 *
+	 * By default, scanning unreadable directories content throws an AccessDeniedException.
+	 *
+	 * @return $this
+	 */
+	public function ignoreUnreadableDirs(bool $ignore = true)
+	{
+		$this->ignoreUnreadableDirs = $ignore;
+
+		return $this;
+	}
+
+	/**
+	 * Searches files and directories which match defined rules.
+	 *
+	 * @param string|string[] $dirs A directory path or an array of directories
+	 *
+	 * @return $this
+	 *
+	 * @throws DirectoryNotFoundException if one of the directories does not exist
+	 */
+	public function in($dirs)
+	{
+		$resolvedDirs = [];
+
+		foreach ((array) $dirs as $dir) {
+			if (is_dir($dir)) {
+				$resolvedDirs[] = $this->normalizeDir($dir);
+			} elseif ($glob = glob($dir, (\defined('GLOB_BRACE') ? \GLOB_BRACE : 0) | \GLOB_ONLYDIR | \GLOB_NOSORT)) {
+				sort($glob);
+				$resolvedDirs = array_merge($resolvedDirs, array_map([$this, 'normalizeDir'], $glob));
+			} else {
+				throw new DirectoryNotFoundException(sprintf('The "%s" directory does not exist.', $dir));
+			}
+		}
+
+		$this->dirs = array_merge($this->dirs, $resolvedDirs);
+
+		return $this;
+	}
+
+	/**
+	 * Returns an Iterator for the current Finder configuration.
+	 *
+	 * This method implements the IteratorAggregate interface.
+	 *
+	 * @return \Iterator|SplFileInfo[] An iterator
+	 *
+	 * @throws \LogicException if the in() method has not been called
+	 */
+	#[\ReturnTypeWillChange]
+	public function getIterator()
+	{
+		if (0 === \count($this->dirs) && 0 === \count($this->iterators)) {
+			throw new \LogicException('You must call one of in() or append() methods before iterating over a Finder.');
+		}
+
+		if (1 === \count($this->dirs) && 0 === \count($this->iterators)) {
+			$iterator = $this->searchInDirectory($this->dirs[0]);
+
+			if ($this->sort || $this->reverseSorting) {
+				$iterator = (new Iterator\SortableIterator($iterator, $this->sort, $this->reverseSorting))->getIterator();
+			}
+
+			return $iterator;
+		}
+
+		$iterator = new \AppendIterator();
+		foreach ($this->dirs as $dir) {
+			$iterator->append(new \IteratorIterator(new LazyIterator(function () use ($dir) {
+				return $this->searchInDirectory($dir);
+			})));
+		}
+
+		foreach ($this->iterators as $it) {
+			$iterator->append($it);
+		}
+
+		if ($this->sort || $this->reverseSorting) {
+			$iterator = (new Iterator\SortableIterator($iterator, $this->sort, $this->reverseSorting))->getIterator();
+		}
+
+		return $iterator;
+	}
+
+	/**
+	 * Appends an existing set of files/directories to the finder.
+	 *
+	 * The set can be another Finder, an Iterator, an IteratorAggregate, or even a plain array.
+	 *
+	 * @return $this
+	 *
+	 * @throws \InvalidArgumentException when the given argument is not iterable
+	 */
+	public function append(iterable $iterator)
+	{
+		if ($iterator instanceof \IteratorAggregate) {
+			$this->iterators[] = $iterator->getIterator();
+		} elseif ($iterator instanceof \Iterator) {
+			$this->iterators[] = $iterator;
+		} elseif (is_iterable($iterator)) {
+			$it = new \ArrayIterator();
+			foreach ($iterator as $file) {
+				$file = $file instanceof \SplFileInfo ? $file : new \SplFileInfo($file);
+				$it[$file->getPathname()] = $file;
+			}
+			$this->iterators[] = $it;
+		} else {
+			throw new \InvalidArgumentException('Finder::append() method wrong argument type.');
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Check if any results were found.
+	 *
+	 * @return bool
+	 */
+	public function hasResults()
+	{
+		foreach ($this->getIterator() as $_) {
+			return true;
+		}
+
+		return false;
+	}
+
+	/**
+	 * Counts all the results collected by the iterators.
+	 *
+	 * @return int
+	 */
+	#[\ReturnTypeWillChange]
+	public function count()
+	{
+		return iterator_count($this->getIterator());
+	}
+
+	private function searchInDirectory(string $dir): \Iterator
+	{
+		$exclude = $this->exclude;
+		$notPaths = $this->notPaths;
+
+		if (static::IGNORE_VCS_FILES === (static::IGNORE_VCS_FILES & $this->ignore)) {
+			$exclude = array_merge($exclude, self::$vcsPatterns);
+		}
+
+		if (static::IGNORE_DOT_FILES === (static::IGNORE_DOT_FILES & $this->ignore)) {
+			$notPaths[] = '#(^|/)\..+(/|$)#';
+		}
+
+		if (static::IGNORE_VCS_IGNORED_FILES === (static::IGNORE_VCS_IGNORED_FILES & $this->ignore)) {
+			$gitignoreFilePath = sprintf('%s/.gitignore', $dir);
+			if (!is_readable($gitignoreFilePath)) {
+				throw new \RuntimeException(sprintf('The "ignoreVCSIgnored" option cannot be used by the Finder as the "%s" file is not readable.', $gitignoreFilePath));
+			}
+			$notPaths = array_merge($notPaths, [Gitignore::toRegex(file_get_contents($gitignoreFilePath))]);
+		}
+
+		$minDepth = 0;
+		$maxDepth = \PHP_INT_MAX;
+
+		foreach ($this->depths as $comparator) {
+			switch ($comparator->getOperator()) {
+				case '>':
+					$minDepth = $comparator->getTarget() + 1;
+					break;
+				case '>=':
+					$minDepth = $comparator->getTarget();
+					break;
+				case '<':
+					$maxDepth = $comparator->getTarget() - 1;
+					break;
+				case '<=':
+					$maxDepth = $comparator->getTarget();
+					break;
+				default:
+					$minDepth = $maxDepth = $comparator->getTarget();
+			}
+		}
+
+		$flags = \RecursiveDirectoryIterator::SKIP_DOTS;
+
+		if ($this->followLinks) {
+			$flags |= \RecursiveDirectoryIterator::FOLLOW_SYMLINKS;
+		}
+
+		$iterator = new Iterator\RecursiveDirectoryIterator($dir, $flags, $this->ignoreUnreadableDirs);
+
+		if ($exclude) {
+			$iterator = new Iterator\ExcludeDirectoryFilterIterator($iterator, $exclude);
+		}
+
+		$iterator = new \RecursiveIteratorIterator($iterator, \RecursiveIteratorIterator::SELF_FIRST);
+
+		if ($minDepth > 0 || $maxDepth < \PHP_INT_MAX) {
+			$iterator = new Iterator\DepthRangeFilterIterator($iterator, $minDepth, $maxDepth);
+		}
+
+		if ($this->mode) {
+			$iterator = new Iterator\FileTypeFilterIterator($iterator, $this->mode);
+		}
+
+		if ($this->names || $this->notNames) {
+			$iterator = new Iterator\FilenameFilterIterator($iterator, $this->names, $this->notNames);
+		}
+
+		if ($this->contains || $this->notContains) {
+			$iterator = new Iterator\FilecontentFilterIterator($iterator, $this->contains, $this->notContains);
+		}
+
+		if ($this->sizes) {
+			$iterator = new Iterator\SizeRangeFilterIterator($iterator, $this->sizes);
+		}
+
+		if ($this->dates) {
+			$iterator = new Iterator\DateRangeFilterIterator($iterator, $this->dates);
+		}
+
+		if ($this->filters) {
+			$iterator = new Iterator\CustomFilterIterator($iterator, $this->filters);
+		}
+
+		if ($this->paths || $notPaths) {
+			$iterator = new Iterator\PathFilterIterator($iterator, $this->paths, $notPaths);
+		}
+
+		return $iterator;
+	}
+
+	/**
+	 * Normalizes given directory names by removing trailing slashes.
+	 *
+	 * Excluding: (s)ftp:// or ssh2.(s)ftp:// wrapper
+	 */
+	private function normalizeDir(string $dir): string
+	{
+		if ('/' === $dir) {
+			return $dir;
+		}
+
+		$dir = rtrim($dir, '/'.\DIRECTORY_SEPARATOR);
+
+		if (preg_match('#^(ssh2\.)?s?ftp://#', $dir)) {
+			$dir .= '/';
+		}
+
+		return $dir;
+	}
 }