Класс FilesystemIterator
(PHP 5 >= 5.3.0, PHP 7)
Введение
Итератор файловой системы
Обзор классов
$path
[, int $flags
= FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS
] )Предопределенные константы
FilesystemIterator::CURRENT_AS_PATHNAME
-
Заставляет метод FilesystemIterator::current() вернуть путь.
FilesystemIterator::CURRENT_AS_FILEINFO
-
Заставляет метод FilesystemIterator::current() вернуть экземпляр SplFileInfo.
FilesystemIterator::CURRENT_AS_SELF
-
Заставляет метод FilesystemIterator::current() вернуть $this (FilesystemIterator).
FilesystemIterator::CURRENT_MODE_MASK
-
Маскирует FilesystemIterator::current()
FilesystemIterator::KEY_AS_PATHNAME
-
Заставляет метод FilesystemIterator::key() вернуть путь.
FilesystemIterator::KEY_AS_FILENAME
-
Заставляет метод FilesystemIterator::key() вернуть имя файла.
FilesystemIterator::FOLLOW_SYMLINKS
-
Заставляет метод RecursiveDirectoryIterator::hasChildren() следовать символическим ссылкам.
FilesystemIterator::KEY_MODE_MASK
-
Маскирует FilesystemIterator::key()
FilesystemIterator::NEW_CURRENT_AND_KEY
-
Тоже, что FilesystemIterator::KEY_AS_FILENAME | FilesystemIterator::CURRENT_AS_FILEINFO.
FilesystemIterator::SKIP_DOTS
-
Пропускает точечные файлы (. and ..).
FilesystemIterator::UNIX_PATHS
-
Заставляет все пути использовать обратный слеш в Unix-стиле, независимо от настроек системы по умолчанию.
Список изменений
Версия | Описание |
---|---|
5.3.1 | Добавлена константа FilesystemIterator::FOLLOW_SYMLINKS |
Содержание
- FilesystemIterator::__construct — Создает новый итератор файловой системы
- FilesystemIterator::current — Текущий файл
- FilesystemIterator::getFlags — Получение флагов настроек объекта
- FilesystemIterator::key — Определение ключа текущего файла
- FilesystemIterator::next — Перемещение указателя на следующий файл
- FilesystemIterator::rewind — Перемещение указателя на начало
- FilesystemIterator::setFlags — Задание настроечных флагов
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Другие базовые расширения
- Стандартная библиотека PHP (SPL)
- Класс AppendIterator
- Класс ArrayIterator
- Класс CachingIterator
- Класс CallbackFilterIterator
- Класс DirectoryIterator
- Класс EmptyIterator
- Класс FilesystemIterator
- Класс FilterIterator
- Класс GlobIterator
- Класс InfiniteIterator
- Класс IteratorIterator
- Класс LimitIterator
- Класс MultipleIterator
- Класс NoRewindIterator
- Класс ParentIterator
- Класс RecursiveArrayIterator
- Класс RecursiveCachingIterator
- Класс RecursiveCallbackFilterIterator
- Класс RecursiveDirectoryIterator
- Класс RecursiveFilterIterator
- Класс RecursiveIteratorIterator
- Класс RecursiveRegexIterator
- Класс RecursiveTreeIterator
- Класс RegexIterator
Коментарии
You may be wondering, like I did, what is the difference between this class and DirectoryIterator?
When you iteterate using DirectoryIterator each "value" returned is the same DirectoryIterator object. The internal state is changed so when you call isDir(), getPathname(), etc the correct information is returned. If you were to ask for a key when iterating you will get an integer index value.
FilesystemIterator (and RecursiveDirectoryIterator) on the other hand returns a new, different SplFileInfo object for each iteration step. The key is the full pathname of the file. This is by default. You can change what is returned for the key or value using the "flags" arguement to the constructor.
DirectoryIterator returns virtual directories "." and ".." in a loop.
But FilesystemIterator ignores them.
Here's a great little drop in replacement for FilesystemIterator I wrote to easily Iterate your filesystem, including:
* Sorting - using ArrayIterator
* Regex Matching - using RegexIterator
* Limiting - using LimitIterator
It's fully chainable
<?php
// Sort by filemtime
$files = (new AdvancedFilesystemIterator('/path/to/files'))->sortByMTime();
// Sort by filemtime -> Limit output to 10
$files = (new AdvancedFilesystemIterator('/path/to/files'))->sortByMTime()->limit(0, 10);
// Sort by filemtime -> Only get CSV files -> Limit to 10
$files = (new AdvancedFilesystemIterator('/path/to/files'))->sortByMTime()->match('/csv$/')->limit(0, 10);
// Sort by filemtime -> Only get CSV files -> Limit to 10 -> and back to sorting by Filename
$files = (new AdvancedFilesystemIterator('/path/to/files'))->sortByMTime()->match('/csv$/')->limit(0, 10)->sortByFilename();
// Sort by any of SplFileInfo's get*() methods i.e. Owner, CTime, Basename, ATime, Perms, Type, isFile, anything
$files = (new AdvancedFilesystemIterator('/path/to/files'))->sortByOwner();
// Foreach
foreach ((new AdvancedFilesystemIterator('/path/to/files'))->sortByMTime()->match('/csv$/')->limit(0, 10) AS $file)
{
print $file->getFilename() . "<br>\n";
}
// The Class
class AdvancedFilesystemIterator extends ArrayIterator
{
public function __construct(string $path, int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS)
{
parent::__construct(iterator_to_array(new FilesystemIterator($path, $flags)));
}
public function __call(string $name, array $arguments)
{
if (preg_match('/^sortBy(.*)/', $name, $m)) return $this->sort('get' . $m[1]);
throw new MemberAccessException('Method ' . $methodName . ' not exists');
}
public function sort($method)
{
if (!method_exists('SplFileInfo', $method)) throw new InvalidArgumentException(sprintf('Method "%s" does not exist in SplFileInfo', $method));
$this->uasort(function(SplFileInfo $a, SplFileInfo $b) use ($method) { return (is_string($a->$method()) ? strnatcmp($a->$method(), $b->$method()) : $b->$method() - $a->$method()); });
return $this;
}
public function limit(int $offset = 0, int $limit = -1)
{
return parent::__construct(iterator_to_array(new LimitIterator($this, $offset, $limit))) ?? $this;
}
public function match(string $regex, int $mode = RegexIterator::MATCH, int $flags = 0, int $preg_flags = 0)
{
return parent::__construct(iterator_to_array(new RegexIterator($this, $regex, $mode, $flags, $preg_flags))) ?? $this;
}
}
Here's the difference between DirectoryIterator and FileSystemIterator.
FileSystemIterator extends DirectoryIterator, inheriting all of it's functionalities, but extending it with additional options and features:
- Additional flags and options (e.g., FileSystemIterator::SKIP_DOTS to skip . and .. entries).
- Offers more control and flexibility over the iteration process.
- Suitable for more complex directory traversal requirements where additional control is needed.
So if you just need the contents of a directory, use DirectoryIterator.
If you need to do directory traversal, use FileSystemIterator.