Class Folder

Folder structure browser, lists folders and files. Provides an Object interface for Common directory related tasks.

Namespace: Cake\Filesystem
Link: https://book.cakephp.org/3/en/core-libraries/file-folder.html#folder-api

Constants

string

MERGE ¶
```
'merge'
```
Default scheme for Folder::copy Recursively merges subfolders with the same name
string

OVERWRITE ¶
```
'overwrite'
```
Overwrite scheme for Folder::copy subfolders with the same name will be replaced
string

SKIP ¶
```
'skip'
```
Skip scheme for Folder::copy if a subfolder with the same name exists it will be skipped
string

SORT_NAME ¶
```
'name'
```
Sort mode by name
string

SORT_TIME ¶
```
'time'
```
Sort mode by time

Property Summary

$_directories protected

array

Holds array of complete directory paths.
$_errors protected

array

Holds errors from last method.
$_files protected

array

Holds array of complete file paths.
$_fsorts protected

string[]

Functions array to be called depending on the sort type chosen.
$_messages protected

array

Holds messages from last method.
$mode public

int

Mode to be used on create. Does nothing on windows platforms.
$path public

string

Path to Folder.
$sort public

bool

Sortedness. Whether or not list results should be sorted by name.

Method Summary

__construct() public

Constructor.
_findRecursive() protected

Private helper function for findRecursive.
addPathElement() public static

Returns $path with $element added, with correct slash in-between.
cd() public

Change directory to $path.
chmod() public

Change the mode on a directory structure recursively. This includes changing the mode on files as well.
copy() public

Recursive directory copy.
correctSlashFor() public static

Returns a correct set of slashes for given $path. (\ for Windows paths and / for other paths.)
create() public

Create a directory structure recursively.
delete() public

Recursively Remove directories if the system allows.
dirsize() public

Returns the size in bytes of this Folder and its contents.
errors() public

get error from latest method
find() public

Returns an array of all matching files in current directory.
findRecursive() public

Returns an array of all matching files in and below current directory.
inCakePath() public deprecated

Returns true if the Folder is in the given Cake path.
inPath() public

Returns true if the Folder is in the given path.
isAbsolute() public static

Returns true if given $path is an absolute path.
isRegisteredStreamWrapper() public static

Returns true if given $path is a registered stream wrapper.
isSlashTerm() public static

Returns true if given $path ends in a slash (i.e. is slash-terminated).
isWindowsPath() public static

Returns true if given $path is a Windows path.
messages() public

get messages from latest method
move() public

Recursive directory move.
normalizeFullPath() public static

Returns a correct set of slashes for given $path. (\ for Windows paths and / for other paths.)
normalizePath() public static deprecated

Returns a correct set of slashes for given $path. (\ for Windows paths and / for other paths.)
pwd() public

Return current path.
read() public

Returns an array of the contents of the current directory. The returned array holds two arrays: One of directories and one of files.
realpath() public

Get the real path (taking ".." and such into account)
slashTerm() public static

Returns $path with added terminating slash (corrected for Windows or other OS).
subdirectories() public

Returns an array of subdirectories for the provided or current path.
tree() public

Returns an array of nested directories and files in each directory

Method Detail

__construct() ¶ public

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

Constructor.

Parameters

string|null $path optional: Path to folder
bool $create optional: Create folder if not found
int|false $mode optional: Mode (CHMOD) to apply to created folder, false to ignore

_findRecursive() ¶ protected

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

Private helper function for findRecursive.

Parameters

string $pattern: Pattern to match against
bool $sort optional: Whether results should be sorted.

Returns

array

Files matching pattern

addPathElement() ¶ public static

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

Returns $path with $element added, with correct slash in-between.

Parameters

string $path: Path
string|array $element: Element to add at end of path

Returns

string

Combined path

cd() ¶ public

cd(string $path): string|false

Change directory to $path.

Parameters

string $path: Path to the directory to change to

Returns

string|false

The new path. Returns false on failure

chmod() ¶ public

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

Change the mode on a directory structure recursively. This includes changing the mode on files as well.

Parameters

string $path: The path to chmod.
int|bool $mode optional: Octal value, e.g. 0755.
bool $recursive optional: Chmod recursively, set to false to only change the current directory.
array $exceptions optional: Array of files, directories to skip.

Returns

bool

Success.

copy() ¶ public

copy(array|string $options): bool

Recursive directory copy.

Options

to The directory to copy to.
from The directory to copy from, this will cause a cd() to occur, changing the results of pwd().
mode The mode to copy the files/directories with as integer, e.g. 0775.
skip Files/directories to skip.
scheme Folder::MERGE, Folder::OVERWRITE, Folder::SKIP
recursive Whether to copy recursively or not (default: true - recursive)

Parameters

array|string $options: Either an array of options (see above) or a string of the destination directory.

Returns

bool

Success.

correctSlashFor() ¶ public static

correctSlashFor(string $path): string

Returns a correct set of slashes for given $path. (\ for Windows paths and / for other paths.)

Parameters

string $path: Path to check

Returns

string

Set of slashes ("\" or "/")

create() ¶ public

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

Create a directory structure recursively.

Can be used to create deep path structures like /foo/bar/baz/shoe/horn

Parameters

string $pathname: The directory structure to create. Either an absolute or relative path. If the path is relative and exists in the process' cwd it will not be created. Otherwise relative paths will be prefixed with the current pwd().
int|bool $mode optional: octal value 0755

Returns

bool

Returns TRUE on success, FALSE on failure

delete() ¶ public

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

Recursively Remove directories if the system allows.

Parameters

string|null $path optional: Path of directory to delete

Returns

bool

Success

dirsize() ¶ public

dirsize(): int

Returns the size in bytes of this Folder and its contents.

Returns

int

size in bytes of current folder

errors() ¶ public

errors(bool $reset = true): array

get error from latest method

Parameters

bool $reset optional: Reset error stack after reading

Returns

array

find() ¶ public

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

Returns an array of all matching files in current directory.

Parameters

string $regexpPattern optional: Preg_match pattern (Defaults to: .*)
bool $sort optional: Whether results should be sorted.

Returns

array

Files that match given pattern

findRecursive() ¶ public

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

Returns an array of all matching files in and below current directory.

Parameters

string $pattern optional: Preg_match pattern (Defaults to: .*)
bool $sort optional: Whether results should be sorted.

Returns

array

Files matching $pattern

inCakePath() ¶ public

inCakePath(string $path = ''): bool

Returns true if the Folder is in the given Cake path.

Parameters

string $path optional: The path to check.

Returns

bool

inPath() ¶ public

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

Returns true if the Folder is in the given path.

Parameters

string $path: The absolute path to check that the current pwd() resides within.
bool $reverse optional: Reverse the search, check if the given $path resides within the current pwd().

Returns

bool

Throws

InvalidArgumentException
When the given `$path` argument is not an absolute path.

isAbsolute() ¶ public static

isAbsolute(string $path): bool

Returns true if given $path is an absolute path.

Parameters

string $path: Path to check

Returns

bool

true if path is absolute.

isRegisteredStreamWrapper() ¶ public static

isRegisteredStreamWrapper(string $path): bool

Returns true if given $path is a registered stream wrapper.

Parameters

string $path: Path to check

Returns

bool

True if path is registered stream wrapper.

isSlashTerm() ¶ public static

isSlashTerm(string $path): bool

Returns true if given $path ends in a slash (i.e. is slash-terminated).

Parameters

string $path: Path to check

Returns

bool

true if path ends with slash, false otherwise

isWindowsPath() ¶ public static

isWindowsPath(string $path): bool

Returns true if given $path is a Windows path.

Parameters

string $path: Path to check

Returns

bool

true if windows path, false otherwise

messages() ¶ public

messages(bool $reset = true): array

get messages from latest method

Parameters

bool $reset optional: Reset message stack after reading

Returns

array

move() ¶ public

move(array|string $options): bool

Recursive directory move.

Options

to The directory to copy to.
from The directory to copy from, this will cause a cd() to occur, changing the results of pwd().
chmod The mode to copy the files/directories with.
skip Files/directories to skip.
scheme Folder::MERGE, Folder::OVERWRITE, Folder::SKIP
recursive Whether to copy recursively or not (default: true - recursive)

Parameters

array|string $options: (to, from, chmod, skip, scheme)

Returns

bool

Success

normalizeFullPath() ¶ public static

normalizeFullPath(string $path): string

Returns a correct set of slashes for given $path. (\ for Windows paths and / for other paths.)

Parameters

string $path: Path to transform

Returns

string

Path with the correct set of slashes ("\" or "/")

normalizePath() ¶ public static

normalizePath(string $path): string

Returns a correct set of slashes for given $path. (\ for Windows paths and / for other paths.)

Parameters

string $path: Path to check

Returns

string

Set of slashes ("\" or "/")

pwd() ¶ public

pwd(): string

Return current path.

Returns

string

Current path

read() ¶ public

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

Returns an array of the contents of the current directory. The returned array holds two arrays: One of directories and one of files.

Parameters

string|bool $sort optional: Whether you want the results sorted, set this and the sort property to false to get unsorted results.
array|bool $exceptions optional: Either an array or boolean true will not grab dot files
bool $fullPath optional: True returns the full path

Returns

array

Contents of current directory as an array, an empty array on failure

realpath() ¶ public

realpath(string $path): string|false

Get the real path (taking ".." and such into account)

Parameters

string $path: Path to resolve

Returns

string|false

The resolved path

slashTerm() ¶ public static

slashTerm(string $path): string

Returns $path with added terminating slash (corrected for Windows or other OS).

Parameters

string $path: Path to check

Returns

string

Path with ending slash

subdirectories() ¶ public

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

Returns an array of subdirectories for the provided or current path.

Parameters

string|null $path optional: The directory path to get subdirectories for.
bool $fullPath optional: Whether to return the full path or only the directory name.

Returns

array

Array of subdirectories for the provided or current path.

tree() ¶ public

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

Returns an array of nested directories and files in each directory

Parameters

string|null $path optional: the directory path to build the tree from
array|bool $exceptions optional: Either an array of files/folder to exclude or boolean true to not grab dot files/folders
string|null $type optional: either 'file' or 'dir'. Null returns both files and directories

Returns

array

Array of nested directories and files in each directory

Sortedness. Whether or not list results should be sorted by name.

Type

bool

Namespaces

Class Folder

Constants

Property Summary

Method Summary

__construct() public

_findRecursive() protected

addPathElement() public static

cd() public

chmod() public

copy() public

correctSlashFor() public static

create() public

delete() public

dirsize() public

errors() public

find() public

findRecursive() public

inCakePath() public deprecated

inPath() public

isAbsolute() public static

isRegisteredStreamWrapper() public static

isSlashTerm() public static

isWindowsPath() public static

messages() public

move() public

normalizeFullPath() public static

normalizePath() public static deprecated

pwd() public

read() public

realpath() public

slashTerm() public static

subdirectories() public

tree() public

Method Detail

__construct() ¶ public

Parameters

_findRecursive() ¶ protected

Parameters

Returns

addPathElement() ¶ public static

Parameters

Returns

cd() ¶ public

Parameters

Returns

chmod() ¶ public

Parameters

Returns

copy() ¶ public

Options

Parameters

Returns

correctSlashFor() ¶ public static

Parameters

Returns

create() ¶ public

Parameters

Returns

delete() ¶ public

Parameters

Returns

dirsize() ¶ public

Returns

errors() ¶ public

Parameters

Returns

find() ¶ public

Parameters

Returns

findRecursive() ¶ public

Parameters

Returns

inCakePath() ¶ public

Parameters

Returns

inPath() ¶ public

Parameters

Returns

Throws

`$_directories` ¶ protected

`$_errors` ¶ protected

`$_files` ¶ protected

`$_fsorts` ¶ protected

`$_messages` ¶ protected

`$mode` ¶ public

`$path` ¶ public

`$sort` ¶ public