Spec-Zone.ru › CakePHP 4.2

Класс
Folder

Обозреватель структуры папок, перечисляет папки и файлы. Предоставляет интерфейс объекта для общих задач, связанных с каталогами.

Пространство имён: Cake\Filesystem
Устарело: 4.0.0 Будет удалено в 5.0.
Ссылка: https://book.cakephp.org/4/ru/core-libraries/file-folder.html#folder-api

Константы

  • string
    MERGE 
    'merge'

    Схема по умолчанию для Folder::copy. Рекурсивно сливает подпапки с одинаковым именем.

  • string
    OVERWRITE 
    'overwrite'

    Схема перезаписи для Folder::copy. Подпапки с одинаковым именем будут заменены.

  • string
    SKIP 
    'skip'

    Схема пропуска для Folder::copy. Если подпапка с таким же именем существует, она будет пропущена.

  • string
    SORT_NAME 
    'name'

    Режим сортировки по имени.

  • string
    SORT_TIME 
    'time'

    Режим сортировки по времени.

Краткое описание свойств

  • $_directories protected
    array

    Хранит массив полных путей к каталогам.

  • $_errors protected
    array

    Хранит ошибки от последнего метода.

  • $_files protected
    array

    Хранит массив полных путей к файлам.

  • $_fsorts protected
    string[]

    Массив функций, вызываемых в зависимости от выбранного типа сортировки.

  • $_messages protected
    array

    Хранит сообщения от последнего метода.

  • $mode public
    int

    Режим, используемый при создании. Ничего не делает на платформах Windows.

  • $path public
    string

    Путь к папке.

  • $sort public
    bool

    Сортировка. Определяет, должны ли результаты списка сортироваться по имени.

Краткое описание методов

  • __construct() public

    Конструктор.

  • _findRecursive() protected

    Вспомогательная функция для findRecursive.

  • addPathElement() public static

    Возвращает $path с добавленным $element, с правильным слэшем между ними.

  • cd() public

    Изменить директорию на $path.

  • chmod() public

    Изменить режим структуры каталога рекурсивно. Это включает в себя изменение режима файлов также.

  • copy() public

    Рекурсивное копирование каталога.

  • correctSlashFor() public static

    Возвращает правильный набор слэшей для заданного $path. (\ для путей Windows и / для других путей.)

  • create() public

    Рекурсивно создать структуру каталога.

  • delete() public

    Рекурсивно удалить каталоги, если система позволяет.

  • dirsize() public

    Возвращает размер в байтах этой папки и ее содержимого.

  • errors() public

    Получить ошибки от последнего метода.

  • find() public

    Возвращает массив всех соответствующих файлов в текущей директории.

  • findRecursive() public

    Возвращает массив всех соответствующих файлов в и ниже текущей директории.

  • inPath() public

    Возвращает true, если папка находится в указанном пути.

  • isAbsolute() public static

    Возвращает true, если заданный $path является абсолютным путем.

  • isRegisteredStreamWrapper() public static

    Возвращает true, если заданный $path является зарегистрированным обработчиком потоков.

  • isSlashTerm() public static

    Возвращает true, если заданный $path заканчивается слэшем (т.е. заканчивается слэшем).

  • isWindowsPath() public static

    Возвращает true, если заданный $path является путем Windows.

  • messages() public

    Получить сообщения от последнего метода.

  • move() public

    Рекурсивное перемещение каталога.

  • normalizeFullPath() public static

    Возвращает правильный набор слэшей для заданного $path. (\ для путей Windows и / для других путей.)

  • pwd() public

    Возвращает текущий путь.

  • read() public

    Возвращает массив содержимого текущей директории. Возвращаемый массив содержит два массива: один для каталогов и один для файлов.

  • realpath() public

    Получить реальный путь (учитывая «..» и тому подобное)

  • slashTerm() public static

    Возвращает $path с добавленным завершающим слэшем (скорректированным для Windows или другой ОС).

  • subdirectories() public

    Возвращает массив подкаталогов для указанного или текущего пути.

  • tree() public

    Возвращает массив вложенных каталогов и файлов в каждом каталоге

END_OF_DOCUMENT_MARKER

Подробное описание методов

__construct() public 

__construct(string|null $path = null, bool $create = false, int|null $mode = null)

Конструктор.

Параметры

string|null $path необязательно

Путь к папке

bool $create необязательно

Создать папку, если она не найдена

int|null $mode необязательно

Режим (CHMOD) для применения к созданной папке, false - пропустить

_findRecursive() protected 

_findRecursive(string $pattern, bool $sort = false): array

Вспомогательная функция для findRecursive.

Параметры

string $pattern

Шаблон для сопоставления

bool $sort необязательно

Нужно ли сортировать результаты.

Возвращает

array

addPathElement() public static 

addPathElement(string $path, string|array $element): string

Возвращает $path с добавленным $element, с правильным слешем между ними.

Параметры

string $path

Путь

string|array $element

Элемент, добавляемый в конец пути

Возвращает

string

cd() public 

cd(string $path): string|false

Изменить текущую директорию на $path.

Параметры

string $path

Путь к директории, на которую нужно перейти

Возвращает

string|false

chmod() public 

chmod(string $path, int|null $mode = null, bool $recursive = true, string[] $exceptions = []): bool

Рекурсивно изменяет режим каталога. Это включает изменение режима файлов также.

Параметры

string $path

Путь для chmod.

int|null $mode необязательно

Восьмеричное значение, например, 0755.

bool $recursive необязательно

Рекурсивное изменение режима, установите в false, чтобы изменить только текущую директорию.

string[] $exceptions необязательно

Массив файлов и директорий, которые нужно пропустить.

Возвращает

bool

copy() public 

copy(string $to, array $options = []): bool

Рекурсивное копирование директорий.

Параметры

  • from Директория для копирования, это вызовет cd(), изменив результаты pwd().
  • mode Режим копирования файлов/директорий в виде целого числа, например, 0775.
  • skip Файлы/директории для пропуска.
  • scheme Folder::MERGE, Folder::OVERWRITE, Folder::SKIP
  • recursive Нужно ли копировать рекурсивно (по умолчанию: true - рекурсивно)

Параметры

string $to

Директория для копирования.

array $options необязательно

Массив параметров (см. выше).

Возвращает

bool

correctSlashFor() public static 

correctSlashFor(string $path): string

Возвращает правильный набор слешей для данного $path. (\ для путей Windows и / для других путей.)

Параметры

string $path

Путь для проверки

Возвращает

string

create() public 

create(string $pathname, int|null $mode = null): bool

Рекурсивно создаёт структуру каталогов.

Может использоваться для создания глубоких структур путей, таких как /foo/bar/baz/shoe/horn

Параметры

string $pathname

Структура каталогов для создания. Абсолютный или относительный путь. Если путь является относительным и существует в текущем каталоге процесса, он не будет создан. В противном случае относительные пути будут префиксрованы текущим pwd().

int|null $mode необязательно

восьмеричное значение 0755

Возвращает

bool

delete() public 

delete(string|null $path = null): bool

Рекурсивно удаляет директории, если система это позволяет.

Параметры

string|null $path необязательно

Путь к директории для удаления

Возвращает

bool

dirsize() public 

dirsize(): int

Возвращает размер в байтах этой папки и её содержимого.

Возвращает

int

errors() public 

errors(bool $reset = true): array

Получить ошибку от последнего метода

Параметры

bool $reset необязательно

Сбросить стек ошибок после чтения

Возвращает

array

find() public 

find(string $regexpPattern = '.*', string|bool $sort = false): array

Возвращает массив всех соответствующих файлов в текущей директории.

Параметры

string $regexpPattern необязательно

Шаблон preg_match (По умолчанию: .*)

string|bool $sort необязательно

Нужно ли сортировать результаты.

Возвращает

array

findRecursive() public 

findRecursive(string $pattern = '.*', string|bool $sort = false): array

Возвращает массив всех соответствующих файлов в текущей и дочерних директориях.

Параметры

string $pattern необязательно

Шаблон preg_match (По умолчанию: .*)

string|bool $sort необязательно

Нужно ли сортировать результаты.

Возвращает

array

inPath() public 

inPath(string $path, bool $reverse = false): bool

Возвращает true, если папка находится в указанном пути.

Параметры

string $path

Абсолютный путь для проверки, что текущая pwd() находится внутри.

bool $reverse необязательно

Обратить поиск, проверить, находится ли заданный $path внутри текущей pwd().

Возвращает

bool

Выбрасывает

InvalidArgumentException
Когда заданный аргумент `$path` не является абсолютным путем.

isAbsolute() public static 

isAbsolute(string $path): bool

Возвращает true, если заданный $path является абсолютным путем.

Параметры

string $path

Путь для проверки

Возвращает

bool

isRegisteredStreamWrapper() public static 

isRegisteredStreamWrapper(string $path): bool

Возвращает true, если заданный $path является зарегистрированным обработчиком потоков.

Параметры

string $path

Путь для проверки

Возвращает

bool

isSlashTerm() public static 

isSlashTerm(string $path): bool

Возвращает true, если заданный $path заканчивается слешем (т.е. является слеш-терминированным).

Параметры

string $path

Путь для проверки

Возвращает

bool

isWindowsPath() public static 

isWindowsPath(string $path): bool

Возвращает true, если заданный $path является путем Windows.

Параметры

string $path

Путь для проверки

Возвращает

bool

messages() public 

messages(bool $reset = true): array

Получить сообщения из последнего метода

Параметры

bool $reset необязательный

Сбросить стек сообщений после чтения

Возвращает

array

move() public 

move(string $to, array $options = []): bool

Рекурсивное перемещение директорий.

Опции

  • from Директория для копирования, это вызовет cd(), изменяя результаты pwd().
  • mode Режим копирования файлов/директорий как целое число, например, 0775.
  • skip Файлы/директории для пропуска.
  • scheme Folder::MERGE, Folder::OVERWRITE, Folder::SKIP
  • recursive Копировать рекурсивно или нет (по умолчанию: true - рекурсивно)

Параметры

string $to

Директория для перемещения.

array $options необязательный

Массив опций (см. выше).

Возвращает

bool

normalizeFullPath() public static 

normalizeFullPath(string $path): string

Возвращает правильный набор слешей для заданного $path. (\ для путей Windows и / для других путей.)

Параметры

string $path

Путь для преобразования

Возвращает

string

pwd() public 

pwd(): string|null

Возвращает текущий путь.

Возвращает

string|null

read() public 

read(string|bool $sort = self::SORT_NAME, array|bool $exceptions = false, bool $fullPath = false): array

Возвращает массив содержимого текущей директории. Возвращаемый массив содержит два массива: один для директорий и один для файлов.

Параметры

string|bool $sort необязательный

Требуется ли сортировка результатов, установите это и свойство sort в false, чтобы получить несортированные результаты.

array|bool $exceptions необязательный

Массив или boolean true, чтобы не брать файлы с точкой

bool $fullPath необязательный

True возвращает полный путь

Возвращает

array

realpath() public 

realpath(string $path): string|false

Получить реальный путь (учитывая "..", и т.д.)

Параметры

string $path

Путь для разрешения

Возвращает

string|false

slashTerm() public static 

slashTerm(string $path): string

Возвращает $path с добавленным заключительным слэшем (исправленным для Windows или другой ОС).

Параметры

string $path

Путь для проверки

Возвращает

string

subdirectories() public 

subdirectories(string|null $path = null, bool $fullPath = true): array

Возвращает массив поддиректорий для предоставленного или текущего пути.

Параметры

string|null $path необязательный

Путь к директории для получения поддиректорий.

bool $fullPath необязательный

Возвращать полный путь или только имя директории.

Возвращает

array

tree() public 

tree(string|null $path = null, array|bool $exceptions = false, string|null $type = null): array

Возвращает массив вложенных директорий и файлов в каждой директории

Параметры

string|null $path необязательный

путь к директории для построения дерева

array|bool $exceptions необязательный

Массив файлов/папок для исключения или boolean true, чтобы не брать файлы/папки с точкой

string|null $type необязательный

либо 'file', либо 'dir'. Null возвращает и файлы, и директории

Возвращает

array

Подробное описание свойств

$_directories protected

Хранит массив полных путей к директориям.

Тип

array

$_errors protected

Хранит ошибки из последнего метода.

Тип

array

$_files protected

Хранит массив полных путей к файлам.

Тип

array

$_fsorts protected

Массив функций, которые вызываются в зависимости от выбранного типа сортировки.

Тип

string[]

$_messages protected

Хранит сообщения из последнего метода.

Тип

array

$mode public

Режим, используемый при создании. Не делает ничего в платформах Windows.

Тип

int

$path public

Путь к папке.

Тип

string

$sort public

Сортировка. Указывается, сортировать ли результаты списка по имени.

Тип

bool

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.2/class-Cake.Filesystem.Folder.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API