<h2>File Contents: /home/planet5/www/tracking/vendor/symfony/finder/Finder.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/tracking/vendor/symfony/finder/Finder.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier &lt;fabien@symfony.com&gt;
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Finder;

use Symfony\Component\Finder\Comparator\DateComparator;
use Symfony\Component\Finder\Comparator\NumberComparator;
use Symfony\Component\Finder\Iterator\CustomFilterIterator;
use Symfony\Component\Finder\Iterator\DateRangeFilterIterator;
use Symfony\Component\Finder\Iterator\DepthRangeFilterIterator;
use Symfony\Component\Finder\Iterator\ExcludeDirectoryFilterIterator;
use Symfony\Component\Finder\Iterator\FilecontentFilterIterator;
use Symfony\Component\Finder\Iterator\FilenameFilterIterator;
use Symfony\Component\Finder\Iterator\SizeRangeFilterIterator;
use Symfony\Component\Finder\Iterator\SortableIterator;

/**
 * Finder allows to build rules to find files and directories.
 *
 * It is a thin wrapper around several specialized iterator classes.
 *
 * All rules may be invoked several times.
 *
 * All methods return the current Finder object to allow easy chaining:
 *
 * $finder = Finder::create()-&gt;files()-&gt;name(&#039;*.php&#039;)-&gt;in(__DIR__);
 *
 * @author Fabien Potencier &lt;fabien@symfony.com&gt;
 */
class Finder implements \IteratorAggregate, \Countable
{
    const IGNORE_VCS_FILES = 1;
    const IGNORE_DOT_FILES = 2;

    private $mode = 0;
    private $names = array();
    private $notNames = array();
    private $exclude = array();
    private $filters = array();
    private $depths = array();
    private $sizes = array();
    private $followLinks = false;
    private $sort = false;
    private $ignore = 0;
    private $dirs = array();
    private $dates = array();
    private $iterators = array();
    private $contains = array();
    private $notContains = array();
    private $paths = array();
    private $notPaths = array();
    private $ignoreUnreadableDirs = false;

    private static $vcsPatterns = array(&#039;.svn&#039;, &#039;_svn&#039;, &#039;CVS&#039;, &#039;_darcs&#039;, &#039;.arch-params&#039;, &#039;.monotone&#039;, &#039;.bzr&#039;, &#039;.git&#039;, &#039;.hg&#039;);

    public function __construct()
    {
        $this-&gt;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-&gt;mode = Iterator\FileTypeFilterIterator::ONLY_DIRECTORIES;

        return $this;
    }

    /**
     * Restricts the matching to files only.
     *
     * @return $this
     */
    public function files()
    {
        $this-&gt;mode = Iterator\FileTypeFilterIterator::ONLY_FILES;

        return $this;
    }

    /**
     * Adds tests for the directory depth.
     *
     * Usage:
     *
     *   $finder-&gt;depth(&#039;&gt; 1&#039;) // the Finder will start matching at level 1.
     *   $finder-&gt;depth(&#039;&lt; 3&#039;) // the Finder will descend at most 3 levels of directories below the starting point.
     *
     * @param string|int $level The depth level expression
     *
     * @return $this
     *
     * @see DepthRangeFilterIterator
     * @see NumberComparator
     */
    public function depth($level)
    {
        $this-&gt;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-&gt;date(&#039;since yesterday&#039;);
     *   $finder-&gt;date(&#039;until 2 days ago&#039;);
     *   $finder-&gt;date(&#039;&gt; now - 2 hours&#039;);
     *   $finder-&gt;date(&#039;&gt;= 2005-10-15&#039;);
     *
     * @param string $date A date range string
     *
     * @return $this
     *
     * @see strtotime
     * @see DateRangeFilterIterator
     * @see DateComparator
     */
    public function date($date)
    {
        $this-&gt;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-&gt;name(&#039;*.php&#039;)
     * $finder-&gt;name(&#039;/\.php$/&#039;) // same as above
     * $finder-&gt;name(&#039;test.php&#039;)
     *
     * @param string $pattern A pattern (a regexp, a glob, or a string)
     *
     * @return $this
     *
     * @see FilenameFilterIterator
     */
    public function name($pattern)
    {
        $this-&gt;names[] = $pattern;

        return $this;
    }

    /**
     * Adds rules that files must not match.
     *
     * @param string $pattern A pattern (a regexp, a glob, or a string)
     *
     * @return $this
     *
     * @see FilenameFilterIterator
     */
    public function notName($pattern)
    {
        $this-&gt;notNames[] = $pattern;

        return $this;
    }

    /**
     * Adds tests that file contents must match.
     *
     * Strings or PCRE patterns can be used:
     *
     * $finder-&gt;contains(&#039;Lorem ipsum&#039;)
     * $finder-&gt;contains(&#039;/Lorem ipsum/i&#039;)
     *
     * @param string $pattern A pattern (string or regexp)
     *
     * @return $this
     *
     * @see FilecontentFilterIterator
     */
    public function contains($pattern)
    {
        $this-&gt;contains[] = $pattern;

        return $this;
    }

    /**
     * Adds tests that file contents must not match.
     *
     * Strings or PCRE patterns can be used:
     *
     * $finder-&gt;notContains(&#039;Lorem ipsum&#039;)
     * $finder-&gt;notContains(&#039;/Lorem ipsum/i&#039;)
     *
     * @param string $pattern A pattern (string or regexp)
     *
     * @return $this
     *
     * @see FilecontentFilterIterator
     */
    public function notContains($pattern)
    {
        $this-&gt;notContains[] = $pattern;

        return $this;
    }

    /**
     * Adds rules that filenames must match.
     *
     * You can use patterns (delimited with / sign) or simple strings.
     *
     * $finder-&gt;path(&#039;some/special/dir&#039;)
     * $finder-&gt;path(&#039;/some\/special\/dir/&#039;) // same as above
     *
     * Use only / as dirname separator.
     *
     * @param string $pattern A pattern (a regexp or a string)
     *
     * @return $this
     *
     * @see FilenameFilterIterator
     */
    public function path($pattern)
    {
        $this-&gt;paths[] = $pattern;

        return $this;
    }

    /**
     * Adds rules that filenames must not match.
     *
     * You can use patterns (delimited with / sign) or simple strings.
     *
     * $finder-&gt;notPath(&#039;some/special/dir&#039;)
     * $finder-&gt;notPath(&#039;/some\/special\/dir/&#039;) // same as above
     *
     * Use only / as dirname separator.
     *
     * @param string $pattern A pattern (a regexp or a string)
     *
     * @return $this
     *
     * @see FilenameFilterIterator
     */
    public function notPath($pattern)
    {
        $this-&gt;notPaths[] = $pattern;

        return $this;
    }

    /**
     * Adds tests for file sizes.
     *
     * $finder-&gt;size(&#039;&gt; 10K&#039;);
     * $finder-&gt;size(&#039;&lt;= 1Ki&#039;);
     * $finder-&gt;size(4);
     *
     * @param string|int $size A size range string or an integer
     *
     * @return $this
     *
     * @see SizeRangeFilterIterator
     * @see NumberComparator
     */
    public function size($size)
    {
        $this-&gt;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-&gt;in(__DIR__)-&gt;exclude(&#039;ruby&#039;);
     *
     * @param string|array $dirs A directory path or an array of directories
     *
     * @return $this
     *
     * @see ExcludeDirectoryFilterIterator
     */
    public function exclude($dirs)
    {
        $this-&gt;exclude = array_merge($this-&gt;exclude, (array) $dirs);

        return $this;
    }

    /**
     * Excludes &quot;hidden&quot; directories and files (starting with a dot).
     *
     * This option is enabled by default.
     *
     * @param bool $ignoreDotFiles Whether to exclude &quot;hidden&quot; files or not
     *
     * @return $this
     *
     * @see ExcludeDirectoryFilterIterator
     */
    public function ignoreDotFiles($ignoreDotFiles)
    {
        if ($ignoreDotFiles) {
            $this-&gt;ignore |= static::IGNORE_DOT_FILES;
        } else {
            $this-&gt;ignore &amp;= ~static::IGNORE_DOT_FILES;
        }

        return $this;
    }

    /**
     * Forces the finder to ignore version control directories.
     *
     * This option is enabled by default.
     *
     * @param bool $ignoreVCS Whether to exclude VCS files or not
     *
     * @return $this
     *
     * @see ExcludeDirectoryFilterIterator
     */
    public function ignoreVCS($ignoreVCS)
    {
        if ($ignoreVCS) {
            $this-&gt;ignore |= static::IGNORE_VCS_FILES;
        } else {
            $this-&gt;ignore &amp;= ~static::IGNORE_VCS_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-&gt;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()
    {
        $this-&gt;sort = 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-&gt;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-&gt;sort = Iterator\SortableIterator::SORT_BY_ACCESSED_TIME;

        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-&gt;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-&gt;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-&gt;filters[] = $closure;

        return $this;
    }

    /**
     * Forces the following of symlinks.
     *
     * @return $this
     */
    public function followLinks()
    {
        $this-&gt;followLinks = true;

        return $this;
    }

    /**
     * Tells finder to ignore unreadable directories.
     *
     * By default, scanning unreadable directories content throws an AccessDeniedException.
     *
     * @param bool $ignore
     *
     * @return $this
     */
    public function ignoreUnreadableDirs($ignore = true)
    {
        $this-&gt;ignoreUnreadableDirs = (bool) $ignore;

        return $this;
    }

    /**
     * Searches files and directories which match defined rules.
     *
     * @param string|array $dirs A directory path or an array of directories
     *
     * @return $this
     *
     * @throws \InvalidArgumentException if one of the directories does not exist
     */
    public function in($dirs)
    {
        $resolvedDirs = array();

        foreach ((array) $dirs as $dir) {
            if (is_dir($dir)) {
                $resolvedDirs[] = $dir;
            } elseif ($glob = glob($dir, (defined(&#039;GLOB_BRACE&#039;) ? GLOB_BRACE : 0) | GLOB_ONLYDIR)) {
                $resolvedDirs = array_merge($resolvedDirs, $glob);
            } else {
                throw new \InvalidArgumentException(sprintf(&#039;The &quot;%s&quot; directory does not exist.&#039;, $dir));
            }
        }

        $this-&gt;dirs = array_merge($this-&gt;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
     */
    public function getIterator()
    {
        if (0 === count($this-&gt;dirs) &amp;&amp; 0 === count($this-&gt;iterators)) {
            throw new \LogicException(&#039;You must call one of in() or append() methods before iterating over a Finder.&#039;);
        }

        if (1 === count($this-&gt;dirs) &amp;&amp; 0 === count($this-&gt;iterators)) {
            return $this-&gt;searchInDirectory($this-&gt;dirs[0]);
        }

        $iterator = new \AppendIterator();
        foreach ($this-&gt;dirs as $dir) {
            $iterator-&gt;append($this-&gt;searchInDirectory($dir));
        }

        foreach ($this-&gt;iterators as $it) {
            $iterator-&gt;append($it);
        }

        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.
     *
     * @param mixed $iterator
     *
     * @return $this
     *
     * @throws \InvalidArgumentException when the given argument is not iterable
     */
    public function append($iterator)
    {
        if ($iterator instanceof \IteratorAggregate) {
            $this-&gt;iterators[] = $iterator-&gt;getIterator();
        } elseif ($iterator instanceof \Iterator) {
            $this-&gt;iterators[] = $iterator;
        } elseif ($iterator instanceof \Traversable || is_array($iterator)) {
            $it = new \ArrayIterator();
            foreach ($iterator as $file) {
                $it-&gt;append($file instanceof \SplFileInfo ? $file : new \SplFileInfo($file));
            }
            $this-&gt;iterators[] = $it;
        } else {
            throw new \InvalidArgumentException(&#039;Finder::append() method wrong argument type.&#039;);
        }

        return $this;
    }

    /**
     * Check if the any results were found.
     *
     * @return bool
     */
    public function hasResults()
    {
        foreach ($this-&gt;getIterator() as $_) {
            return true;
        }

        return false;
    }

    /**
     * Counts all the results collected by the iterators.
     *
     * @return int
     */
    public function count()
    {
        return iterator_count($this-&gt;getIterator());
    }

    private function searchInDirectory(string $dir): \Iterator
    {
        if (static::IGNORE_VCS_FILES === (static::IGNORE_VCS_FILES &amp; $this-&gt;ignore)) {
            $this-&gt;exclude = array_merge($this-&gt;exclude, self::$vcsPatterns);
        }

        if (static::IGNORE_DOT_FILES === (static::IGNORE_DOT_FILES &amp; $this-&gt;ignore)) {
            $this-&gt;notPaths[] = &#039;#(^|/)\..+(/|$)#&#039;;
        }

        $minDepth = 0;
        $maxDepth = PHP_INT_MAX;

        foreach ($this-&gt;depths as $comparator) {
            switch ($comparator-&gt;getOperator()) {
                case &#039;&gt;&#039;:
                    $minDepth = $comparator-&gt;getTarget() + 1;
                    break;
                case &#039;&gt;=&#039;:
                    $minDepth = $comparator-&gt;getTarget();
                    break;
                case &#039;&lt;&#039;:
                    $maxDepth = $comparator-&gt;getTarget() - 1;
                    break;
                case &#039;&lt;=&#039;:
                    $maxDepth = $comparator-&gt;getTarget();
                    break;
                default:
                    $minDepth = $maxDepth = $comparator-&gt;getTarget();
            }
        }

        $flags = \RecursiveDirectoryIterator::SKIP_DOTS;

        if ($this-&gt;followLinks) {
            $flags |= \RecursiveDirectoryIterator::FOLLOW_SYMLINKS;
        }

        $iterator = new Iterator\RecursiveDirectoryIterator($dir, $flags, $this-&gt;ignoreUnreadableDirs);

        if ($this-&gt;exclude) {
            $iterator = new Iterator\ExcludeDirectoryFilterIterator($iterator, $this-&gt;exclude);
        }

        $iterator = new \RecursiveIteratorIterator($iterator, \RecursiveIteratorIterator::SELF_FIRST);

        if ($minDepth &gt; 0 || $maxDepth &lt; PHP_INT_MAX) {
            $iterator = new Iterator\DepthRangeFilterIterator($iterator, $minDepth, $maxDepth);
        }

        if ($this-&gt;mode) {
            $iterator = new Iterator\FileTypeFilterIterator($iterator, $this-&gt;mode);
        }

        if ($this-&gt;names || $this-&gt;notNames) {
            $iterator = new Iterator\FilenameFilterIterator($iterator, $this-&gt;names, $this-&gt;notNames);
        }

        if ($this-&gt;contains || $this-&gt;notContains) {
            $iterator = new Iterator\FilecontentFilterIterator($iterator, $this-&gt;contains, $this-&gt;notContains);
        }

        if ($this-&gt;sizes) {
            $iterator = new Iterator\SizeRangeFilterIterator($iterator, $this-&gt;sizes);
        }

        if ($this-&gt;dates) {
            $iterator = new Iterator\DateRangeFilterIterator($iterator, $this-&gt;dates);
        }

        if ($this-&gt;filters) {
            $iterator = new Iterator\CustomFilterIterator($iterator, $this-&gt;filters);
        }

        if ($this-&gt;paths || $this-&gt;notPaths) {
            $iterator = new Iterator\PathFilterIterator($iterator, $this-&gt;paths, $this-&gt;notPaths);
        }

        if ($this-&gt;sort) {
            $iteratorAggregate = new Iterator\SortableIterator($iterator, $this-&gt;sort);
            $iterator = $iteratorAggregate-&gt;getIterator();
        }

        return $iterator;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Ftracking%2Fvendor%2Fsymfony%2Ffinder'>⬅ Back to Directory</a>