Inheritance diagram for ILIAS\Filesystem\Finder\Finder:

Collaboration diagram for ILIAS\Filesystem\Finder\Finder:

Public Member Functions
	__construct (private Filesystem $filesystem)

	files ()

	directories ()

	allTypes ()

	exclude (array $directories)

	in (array $directories)

	depth (string\|int $level)
	Adds tests for the directory depth. More...

	date (string $date)
	Adds tests for file dates. More...

	size (string\|int\|array $sizes)
	Adds tests for file sizes. More...

	reverseSorting ()

	ignoreVCS (bool $ignoreVCS)

	addVCSPattern (array $pattern)

	sort (Closure $closure)
	Sorts files and directories by an anonymous function. More...

	sortByName (bool $useNaturalSort=false)

	sortByType ()

	sortByTime ()

	append (iterable $iterator)
	Appends an existing set of files/directories to the finder. More...

	getIterator ()

	count ()

Protected Attributes
array	$dirs = []

Private Member Functions
	searchInDirectory (string $dir)

Private Attributes
const	IGNORE_VCS_FILES = 1

const	IGNORE_DOT_FILES = 2

array	$vcsPatterns = ['.svn', '_svn', 'CVS', '_darcs', '.arch-params', '.monotone', '.bzr', '.git', '.hg']

array	$iterators = []

array	$exclude = []

int	$ignore = 0

int	$mode = Iterator\FileTypeFilterIterator::ALL

bool	$reverseSorting = false

array	$dates = []

array	$sizes = []

array	$depths = []

	$sort = SortableIterator::SORT_BY_NONE

Detailed Description

Definition at line 44 of file Finder.php.

Constructor & Destructor Documentation

◆ __construct()

ILIAS\Filesystem\Finder\Finder::__construct ( private Filesystem $filesystem )

Definition at line 68 of file Finder.php.

     {
         $this->ignore = self::IGNORE_VCS_FILES|self::IGNORE_DOT_FILES;
     }

Member Function Documentation

◆ addVCSPattern()

ILIAS\Filesystem\Finder\Finder::addVCSPattern ( array $pattern )

Parameters

string[] $pattern

Exceptions

InvalidArgumentException

Definition at line 225 of file Finder.php.

                                                  : self
     {
         array_walk($pattern, static function ($p): void {
             if (!is_string($p)) {
                 throw new InvalidArgumentException(sprintf('Invalid pattern given: %s', $p::class));
             }
         });
 
         $clone = clone $this;
         foreach ($pattern as $p) {
             $clone->vcsPatterns[] = $p;
         }
 
         $clone->vcsPatterns = array_unique($clone->vcsPatterns);
 
         return $clone;
     }

◆ allTypes()

ILIAS\Filesystem\Finder\Finder::allTypes ( )

Definition at line 89 of file Finder.php.

References ILIAS\Filesystem\Finder\Iterator\FileTypeFilterIterator\ALL.

                               : self
     {
         $clone = clone $this;
         $clone->mode = Iterator\FileTypeFilterIterator::ALL;
 
         return $clone;
     }

◆ append()

ILIAS\Filesystem\Finder\Finder::append ( iterable $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.

Exceptions

InvalidArgumentException when the given argument is not iterable

Definition at line 288 of file Finder.php.

                                               : self
     {
         $clone = clone $this;
 
         if ($iterator instanceof IteratorAggregate) {
             $clone->iterators[] = $iterator->getIterator();
         } elseif ($iterator instanceof PhpIterator) {
             $clone->iterators[] = $iterator;
         } elseif (is_iterable($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;
     }

◆ count()

ILIAS\Filesystem\Finder\Finder::count ( )

Definition at line 389 of file Finder.php.

References ILIAS\Filesystem\Finder\Finder\getIterator().

Referenced by ILIAS\Filesystem\Finder\Finder\getIterator().

                            : int
     {
         return iterator_count($this->getIterator());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ date()

ILIAS\Filesystem\Finder\Finder::date ( string $date )

Adds tests for file dates.

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');

Parameters

string $date A date range string

See also: strtotime; DateRangeFilterIterator; DateComparator; ::getTimestamp()

Definition at line 167 of file Finder.php.

                                       : self
     {
         $clone = clone $this;
         $clone->dates[] = new Comparator\DateComparator($date);
 
         return $clone;
     }

◆ depth()

ILIAS\Filesystem\Finder\Finder::depth ( string|int $level )

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.

Parameters

string | int $level The depth level expression

See also: DepthRangeFilterIterator; NumberComparator

Definition at line 144 of file Finder.php.

                                             : self
     {
         $clone = clone $this;
         $clone->depths[] = new Comparator\NumberComparator((string) $level);
 
         return $clone;
     }

◆ directories()

ILIAS\Filesystem\Finder\Finder::directories ( )

Definition at line 81 of file Finder.php.

References ILIAS\Filesystem\Finder\Iterator\FileTypeFilterIterator\ONLY_DIRECTORIES.

                                  : self
     {
         $clone = clone $this;
         $clone->mode = Iterator\FileTypeFilterIterator::ONLY_DIRECTORIES;
 
         return $clone;
     }

◆ exclude()

ILIAS\Filesystem\Finder\Finder::exclude ( array $directories )

Parameters

string[] $directories

Exceptions

InvalidArgumentException

Definition at line 101 of file Finder.php.

Referenced by ILIAS\Filesystem\Finder\Finder\searchInDirectory().

                                                : self
     {
         array_walk($directories, static function ($directory): void {
             if (!is_string($directory)) {
                 throw new InvalidArgumentException(sprintf('Invalid directory given: %s', $directory::class));
             }
         });
 
         $clone = clone $this;
         $clone->exclude = array_merge($clone->exclude, $directories);
 
         return $clone;
     }

Here is the caller graph for this function:

◆ files()

ILIAS\Filesystem\Finder\Finder::files ( )

Definition at line 73 of file Finder.php.

References ILIAS\Filesystem\Finder\Iterator\FileTypeFilterIterator\ONLY_FILES.

Referenced by ILIAS\Filesystem\Finder\Iterator\RecursiveDirectoryIterator\current(), ILIAS\Filesystem\Finder\Iterator\RecursiveDirectoryIterator\key(), ILIAS\Filesystem\Finder\Iterator\RecursiveDirectoryIterator\next(), ILIAS\Filesystem\Finder\Iterator\RecursiveDirectoryIterator\rewind(), and ILIAS\Filesystem\Finder\Iterator\RecursiveDirectoryIterator\valid().

                            : self
     {
         $clone = clone $this;
         $clone->mode = Iterator\FileTypeFilterIterator::ONLY_FILES;
 
         return $clone;
     }

Here is the caller graph for this function:

◆ getIterator()

ILIAS\Filesystem\Finder\Finder::getIterator ( )

Returns: PhpIterator|Metadata[]

Exceptions

LogicException

Definition at line 364 of file Finder.php.

References ILIAS\Filesystem\Finder\Finder\count(), and ILIAS\Filesystem\Finder\Finder\searchInDirectory().

Referenced by ILIAS\Filesystem\Finder\Finder\count().

                                  : \Iterator
     {
         if ([] === $this->dirs && [] === $this->iterators) {
             throw new LogicException('You must call one of in() or append() methods before iterating over a Finder.');
         }
 
         if (1 === count($this->dirs) && [] === $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;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ignoreVCS()

ILIAS\Filesystem\Finder\Finder::ignoreVCS ( bool $ignoreVCS )

Definition at line 209 of file Finder.php.

References ILIAS\Filesystem\Finder\Finder\IGNORE_VCS_FILES.

                                               : self
     {
         $clone = clone $this;
         if ($ignoreVCS) {
             $clone->ignore |= self::IGNORE_VCS_FILES;
         } else {
             $clone->ignore &= ~self::IGNORE_VCS_FILES;
         }
 
         return $clone;
     }

◆ in()

ILIAS\Filesystem\Finder\Finder::in ( array $directories )

Parameters

string[] $directories

Exceptions

InvalidArgumentException

Definition at line 119 of file Finder.php.

                                           : self
     {
         array_walk($directories, static function ($directory): void {
             if (!is_string($directory)) {
                 throw new InvalidArgumentException(sprintf('Invalid directory given: %s', $directory::class));
             }
         });
 
         $clone = clone $this;
         $clone->dirs = array_unique(array_merge($clone->dirs, $directories));
 
         return $clone;
     }

◆ reverseSorting()

ILIAS\Filesystem\Finder\Finder::reverseSorting ( )

Definition at line 201 of file Finder.php.

Referenced by ILIAS\Filesystem\Finder\Finder\searchInDirectory().

                                     : self
     {
         $clone = clone $this;
         $clone->reverseSorting = true;
 
         return $clone;
     }

Here is the caller graph for this function:

◆ searchInDirectory()

ILIAS\Filesystem\Finder\Finder::searchInDirectory ( string $dir )

private

Definition at line 315 of file Finder.php.

References ILIAS\Filesystem\Finder\Finder\exclude(), ILIAS\Repository\filesystem(), ILIAS\Filesystem\Finder\Finder\reverseSorting(), and ILIAS\Filesystem\Finder\Finder\sort().

Referenced by ILIAS\Filesystem\Finder\Finder\getIterator().

                                                    : \Traversable
     {
         if (self::IGNORE_VCS_FILES === (self::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 !== 0) {
             $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;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ size()

ILIAS\Filesystem\Finder\Finder::size ( string|int|array $sizes )

Adds tests for file sizes.

$finder->size('> 10K'); $finder->size('<= 1Ki'); $finder->size(4); $finder->size(['> 10K', '< 20K'])

Parameters

string|int|string[]|int[] $sizes A size range string or an integer or an array of size ranges

See also: SizeRangeFilterIterator; NumberComparator; ::getSize()

Definition at line 188 of file Finder.php.

References ILIAS\Filesystem\Finder\Finder\$sizes.

                                                  : self
     {
         $sizes = is_array($sizes) ? $sizes : [$sizes];
 
         $clone = clone $this;
 
         foreach ($sizes as $size) {
             $clone->sizes[] = new Comparator\NumberComparator((string) $size);
         }
 
         return $clone;
     }

◆ sort()

ILIAS\Filesystem\Finder\Finder::sort ( Closure $closure )

Sorts files and directories by an anonymous function.

The anonymous function receives two Metadata instances to compare. This can be slow as all the matching files and directories must be retrieved for comparison.

Definition at line 248 of file Finder.php.

Referenced by ILIAS\Filesystem\Finder\Iterator\SortableIterator\__construct(), ILIAS\Filesystem\Finder\Iterator\SortableIterator\getIterator(), and ILIAS\Filesystem\Finder\Finder\searchInDirectory().

                                           : self
     {
         $clone = clone $this;
         $clone->sort = $closure;
 
         return $clone;
     }

Here is the caller graph for this function:

◆ sortByName()

ILIAS\Filesystem\Finder\Finder::sortByName ( bool $useNaturalSort = false )

Definition at line 256 of file Finder.php.

References ILIAS\Filesystem\Finder\Iterator\SortableIterator\SORT_BY_NAME, and ILIAS\Filesystem\Finder\Iterator\SortableIterator\SORT_BY_NAME_NATURAL.

                                                             : self
     {
         $clone = clone $this;
         $clone->sort = Iterator\SortableIterator::SORT_BY_NAME;
         if ($useNaturalSort) {
             $clone->sort = Iterator\SortableIterator::SORT_BY_NAME_NATURAL;
         }
 
         return $clone;
     }

◆ sortByTime()

ILIAS\Filesystem\Finder\Finder::sortByTime ( )

Definition at line 275 of file Finder.php.

References ILIAS\Filesystem\Finder\Iterator\SortableIterator\SORT_BY_TIME.

                                 : self
     {
         $clone = clone $this;
         $clone->sort = Iterator\SortableIterator::SORT_BY_TIME;
 
         return $clone;
     }

◆ sortByType()

ILIAS\Filesystem\Finder\Finder::sortByType ( )

Definition at line 267 of file Finder.php.

References ILIAS\Filesystem\Finder\Iterator\SortableIterator\SORT_BY_TYPE.

                                 : self
     {
         $clone = clone $this;
         $clone->sort = Iterator\SortableIterator::SORT_BY_TYPE;
 
         return $clone;
     }

Field Documentation

◆ $dates

array ILIAS\Filesystem\Finder\Finder::$dates = []

private

Definition at line 60 of file Finder.php.

◆ $depths

array ILIAS\Filesystem\Finder\Finder::$depths = []

private

Definition at line 64 of file Finder.php.

◆ $dirs

array ILIAS\Filesystem\Finder\Finder::$dirs = []

protected

Definition at line 53 of file Finder.php.

◆ $exclude

array ILIAS\Filesystem\Finder\Finder::$exclude = []

private

Definition at line 55 of file Finder.php.

◆ $ignore

int ILIAS\Filesystem\Finder\Finder::$ignore = 0

private

Definition at line 56 of file Finder.php.

◆ $iterators

array ILIAS\Filesystem\Finder\Finder::$iterators = []

private

Definition at line 51 of file Finder.php.

◆ $mode

int ILIAS\Filesystem\Finder\Finder::$mode = Iterator\FileTypeFilterIterator::ALL

private

Definition at line 57 of file Finder.php.

◆ $reverseSorting

bool ILIAS\Filesystem\Finder\Finder::$reverseSorting = false

private

Definition at line 58 of file Finder.php.

◆ $sizes

array ILIAS\Filesystem\Finder\Finder::$sizes = []

private

Definition at line 62 of file Finder.php.

Referenced by ILIAS\Filesystem\Finder\Finder\size().

◆ $sort

ILIAS\Filesystem\Finder\Finder::$sort = SortableIterator::SORT_BY_NONE

private

Definition at line 66 of file Finder.php.

◆ $vcsPatterns

array ILIAS\Filesystem\Finder\Finder::$vcsPatterns = ['.svn', '_svn', 'CVS', '_darcs', '.arch-params', '.monotone', '.bzr', '.git', '.hg']

private

Definition at line 49 of file Finder.php.

◆ IGNORE_DOT_FILES

const ILIAS\Filesystem\Finder\Finder::IGNORE_DOT_FILES = 2

private

Definition at line 47 of file Finder.php.

◆ IGNORE_VCS_FILES

const ILIAS\Filesystem\Finder\Finder::IGNORE_VCS_FILES = 1

private

Definition at line 46 of file Finder.php.

Referenced by ILIAS\Filesystem\Finder\Finder\ignoreVCS().

The documentation for this class was generated from the following file:

components/ILIAS/Filesystem/src/Finder/Finder.php

Public Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addVCSPattern()

◆ allTypes()

◆ append()

◆ count()

◆ date()

◆ depth()

◆ directories()

◆ exclude()

◆ files()

◆ getIterator()

◆ ignoreVCS()

◆ in()

◆ reverseSorting()

◆ searchInDirectory()

◆ size()

◆ sort()

◆ sortByName()

◆ sortByTime()

◆ sortByType()

Field Documentation

◆ $dates

◆ $depths

◆ $dirs

◆ $exclude

◆ $ignore

◆ $iterators

◆ $mode

◆ $reverseSorting

◆ $sizes

◆ $sort

◆ $vcsPatterns

◆ IGNORE_DOT_FILES

◆ IGNORE_VCS_FILES