Finder.php

Go to the documentation of this file.

<?php
declare(strict_types=1);
 
namespace ILIAS\Filesystem\Finder;
 
use ILIAS\Filesystem\DTO\Metadata;
use ILIAS\Filesystem\Filesystem;
use ILIAS\Filesystem\MetadataType;
 
final class Finder implements \IteratorAggregate, \Countable
{
    const IGNORE_VCS_FILES = 1;
    const IGNORE_DOT_FILES = 2;
 
    private $filesystem;
 
    private $vcsPatterns = ['.svn', '_svn', 'CVS', '_darcs', '.arch-params', '.monotone', '.bzr', '.git', '.hg'];
 
    private $iterators = [];
 
    protected $dirs = [];
 
    private $exclude = [];
 
    private $ignore = 0;
 
    private $mode = Iterator\FileTypeFilterIterator::ALL;
 
    private $reverseSorting = false;
 
    private $dates = [];
 
    private $sizes = [];
 
    private $depths = [];
 
    private $sort = false;
 
    public function __construct(Filesystem $filesystem)
    {
        $this->filesystem = $filesystem;
        $this->ignore = static::IGNORE_VCS_FILES | static::IGNORE_DOT_FILES;
    }
 
    public function files() : self
    {
        $clone = clone $this;
        $clone->mode = Iterator\FileTypeFilterIterator::ONLY_FILES;
 
        return $clone;
    }
 
    public function directories() : self
    {
        $clone = clone $this;
        $clone->mode = Iterator\FileTypeFilterIterator::ONLY_DIRECTORIES;
 
        return $clone;
    }
 
    public function allTypes() : self
    {
        $clone = clone $this;
        $clone->mode = Iterator\FileTypeFilterIterator::ALL;
 
        return $clone;
    }
 
    public function exclude(array $directories) : self
    {
        array_walk($directories, function ($directory) {
            if (!is_string($directory)) {
                if (is_object($directory)) {
                    throw new \InvalidArgumentException(sprintf('Invalid directory given: %s', get_class($directory)));
                }
 
                throw new \InvalidArgumentException(sprintf('Invalid directory given: %s', gettype($directory)));
            }
        });
 
        $clone = clone $this;
        $clone->exclude = array_merge($clone->exclude, $directories);
 
        return $clone;
    }
 
    public function in(array $directories) : self
    {
        array_walk($directories, function ($directory) {
            if (!is_string($directory)) {
                if (is_object($directory)) {
                    throw new \InvalidArgumentException(sprintf('Invalid directory given: %s', get_class($directory)));
                }
 
                throw new \InvalidArgumentException(sprintf('Invalid directory given: %s', gettype($directory)));
            }
        });
 
        $clone = clone $this;
        $clone->dirs = array_unique(array_merge($clone->dirs, $directories));
 
        return $clone;
    }
 
    public function depth($level) : self
    {
        $clone = clone $this;
        $clone->depths[] = new Comparator\NumberComparator((string) $level);
 
        return $clone;
    }
 
    public function date(string $date) : self
    {
        $clone = clone $this;
        $clone->dates[] = new Comparator\DateComparator($date);
 
        return $clone;
    }
 
    public function size($sizes) : self
    {
        if (!is_array($sizes)) {
            $sizes = [$sizes];
        }
 
        $clone = clone $this;
 
        foreach ($sizes as $size) {
            $clone->sizes[] = new Comparator\NumberComparator((string) $size);
        }
 
        return $clone;
    }
 
    public function reverseSorting() : self
    {
        $clone = clone $this;
        $clone->reverseSorting = true;
 
        return $clone;
    }
 
    public function ignoreVCS(bool $ignoreVCS) : self
    {
        $clone = clone $this;
        if ($ignoreVCS) {
            $clone->ignore |= static::IGNORE_VCS_FILES;
        } else {
            $clone->ignore &= ~static::IGNORE_VCS_FILES;
        }
 
        return $clone;
    }
 
    public function addVCSPattern(array $pattern) : self
    {
        array_walk($pattern, function ($p) {
            if (!is_string($p)) {
                if (is_object($p)) {
                    throw new \InvalidArgumentException(sprintf('Invalid pattern given: %s', get_class($p)));
                }
 
                throw new \InvalidArgumentException(sprintf('Invalid pattern given: %s', gettype($p)));
            }
        });
 
        $clone = clone $this;
        foreach ($pattern as $p) {
            $clone->vcsPatterns[] = $p;
        }
 
        $clone->vcsPatterns = array_unique($clone->vcsPatterns);
 
        return $clone;
    }
 
    public function sort(\Closure $closure) : self
    {
        $clone = clone $this;
        $clone->sort = $closure;
 
        return $clone;
    }
 
    public function sortByName(bool $useNaturalSort = false) : self
    {
        $clone = clone $this;
        $clone->sort = Iterator\SortableIterator::SORT_BY_NAME;
        if ($useNaturalSort) {
            $clone->sort = Iterator\SortableIterator::SORT_BY_NAME_NATURAL;
        }
 
        return $clone;
    }
 
    public function sortByType() : self
    {
        $clone = clone $this;
        $clone->sort = Iterator\SortableIterator::SORT_BY_TYPE;
 
        return $clone;
    }
 
    public function sortByTime() : self
    {
        $clone = clone $this;
        $clone->sort = Iterator\SortableIterator::SORT_BY_TIME;
 
        return $clone;
    }
 
    public function append(iterable $iterator) : self
    {
        $clone = clone $this;
 
        if ($iterator instanceof \IteratorAggregate) {
            $clone->iterators[] = $iterator->getIterator();
        } elseif ($iterator instanceof \Iterator) {
            $clone->iterators[] = $iterator;
        } elseif ($iterator instanceof \Traversable || is_array($iterator)) {
            $it = new \ArrayIterator();
            foreach ($iterator as $file) {
                if ($file instanceof MetadataType) {
                    $it->append($file);
                } else {
                    throw new \InvalidArgumentException('Finder::append() method wrong argument type in passed iterator.');
                }
            }
            $clone->iterators[] = $it;
        } else {
            throw new \InvalidArgumentException('Finder::append() method wrong argument type.');
        }
 
        return $clone;
    }
 
    private function searchInDirectory(string $dir) : \Iterator
    {
        if (static::IGNORE_VCS_FILES === (static::IGNORE_VCS_FILES & $this->ignore)) {
            $this->exclude = array_merge($this->exclude, $this->vcsPatterns);
        }
 
        $iterator = new Iterator\RecursiveDirectoryIterator($this->filesystem, $dir);
 
        if ($this->exclude) {
            $iterator = new Iterator\ExcludeDirectoryFilterIterator($iterator, $this->exclude);
        }
 
        $iterator = new \RecursiveIteratorIterator($iterator, \RecursiveIteratorIterator::SELF_FIRST);
 
        if ($this->depths) {
            $iterator = new Iterator\DepthRangeFilterIterator($iterator, $this->depths);
        }
 
        if ($this->mode) {
            $iterator = new Iterator\FileTypeFilterIterator($iterator, $this->mode);
        }
 
        if ($this->dates) {
            $iterator = new Iterator\DateRangeFilterIterator($this->filesystem, $iterator, $this->dates);
        }
 
        if ($this->sizes) {
            $iterator = new Iterator\SizeRangeFilterIterator($this->filesystem, $iterator, $this->sizes);
        }
 
        if ($this->sort || $this->reverseSorting) {
            $iteratorAggregate = new Iterator\SortableIterator(
                $this->filesystem,
                $iterator,
                $this->sort,
                $this->reverseSorting
            );
            $iterator = $iteratorAggregate->getIterator();
        }
 
        return $iterator;
    }
 
    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)) {
            return $this->searchInDirectory($this->dirs[0]);
        }
 
        $iterator = new \AppendIterator();
        foreach ($this->dirs as $dir) {
            $iterator->append($this->searchInDirectory($dir));
        }
 
        foreach ($this->iterators as $it) {
            $iterator->append($it);
        }
 
        return $iterator;
    }
 
    public function count()
    {
        return iterator_count($this->getIterator());
    }
}