Filesystem

class Filesystem

Provides basic utility to manipulate the file system.

Methods

copy(string $originFile, string $targetFile, bool $overwriteNewerFiles = false)

Copies a file.

mkdir(string|array|Traversable $dirs, int $mode = 511)

Creates a directory recursively.

bool exists(string|array|Traversable $files)

Checks the existence of files or directories.

touch(string|array|Traversable $files, int $time = null, int $atime = null)

Sets access and modification time of file.

remove(string|array|Traversable $files)

Removes files or directories.

chmod(string|array|Traversable $files, int $mode, int $umask, bool $recursive = false)

Change mode for an array of files or directories.

chown(string|array|Traversable $files, string $user, bool $recursive = false)

Change the owner of an array of files or directories.

chgrp(string|array|Traversable $files, string $group, bool $recursive = false)

Change the group of an array of files or directories.

rename(string $origin, string $target, bool $overwrite = false)

Renames a file or a directory.

symlink(string $originDir, string $targetDir, bool $copyOnWindows = false)

Creates a symbolic link or copy a directory.

string makePathRelative(string $endPath, string $startPath)

Given an existing path, convert it to a path relative to a given starting path.

mirror(string $originDir, string $targetDir, Traversable $iterator = null, array $options = array())

Mirrors a directory to another.

bool isAbsolutePath(string $file)

Returns whether the file path is an absolute path.

string tempnam(string $dir, string $prefix)

Creates a temporary file with support for custom stream wrappers.

dumpFile(string $filename, string $content)

Atomically dumps content into a file.

Details

copy(string $originFile, string $targetFile, bool $overwriteNewerFiles = false)

Copies a file.

If the target file is older than the origin file, it's always overwritten. If the target file is newer, it is overwritten only when the $overwriteNewerFiles option is set to true.

Parameters

string $originFile The original filename
string $targetFile The target filename
bool $overwriteNewerFiles If true, target files newer than origin files are overwritten

Exceptions

FileNotFoundException When originFile doesn't exist
IOException When copy fails

mkdir(string|array|Traversable $dirs, int $mode = 511)

Creates a directory recursively.

Parameters

string|array|Traversable $dirs The directory path
int $mode The directory mode

Exceptions

IOException On any directory creation failure

bool exists(string|array|Traversable $files)

Checks the existence of files or directories.

Parameters

string|array|Traversable $files A filename, an array of files, or a \Traversable instance to check

Return Value

bool true if the file exists, false otherwise

touch(string|array|Traversable $files, int $time = null, int $atime = null)

Sets access and modification time of file.

Parameters

string|array|Traversable $files A filename, an array of files, or a \Traversable instance to create
int $time The touch time as a Unix timestamp
int $atime The access time as a Unix timestamp

Exceptions

IOException When touch fails

remove(string|array|Traversable $files)

Removes files or directories.

Parameters

string|array|Traversable $files A filename, an array of files, or a \Traversable instance to remove

Exceptions

IOException When removal fails

chmod(string|array|Traversable $files, int $mode, int $umask, bool $recursive = false)

Change mode for an array of files or directories.

Parameters

string|array|Traversable $files A filename, an array of files, or a \Traversable instance to change mode
int $mode The new mode (octal)
int $umask The mode mask (octal)
bool $recursive Whether change the mod recursively or not

Exceptions

IOException When the change fail

chown(string|array|Traversable $files, string $user, bool $recursive = false)

Change the owner of an array of files or directories.

Parameters

string|array|Traversable $files A filename, an array of files, or a \Traversable instance to change owner
string $user The new owner user name
bool $recursive Whether change the owner recursively or not

Exceptions

IOException When the change fail

chgrp(string|array|Traversable $files, string $group, bool $recursive = false)

Change the group of an array of files or directories.

Parameters

string|array|Traversable $files A filename, an array of files, or a \Traversable instance to change group
string $group The group name
bool $recursive Whether change the group recursively or not

Exceptions

IOException When the change fail

rename(string $origin, string $target, bool $overwrite = false)

Renames a file or a directory.

Parameters

string $origin The origin filename or directory
string $target The new filename or directory
bool $overwrite Whether to overwrite the target if it already exists

Exceptions

IOException When target file or directory already exists
IOException When origin cannot be renamed

symlink(string $originDir, string $targetDir, bool $copyOnWindows = false)

Creates a symbolic link or copy a directory.

Parameters

string $originDir The origin directory path
string $targetDir The symbolic link name
bool $copyOnWindows Whether to copy files if on Windows

Exceptions

IOException When symlink fails

string makePathRelative(string $endPath, string $startPath)

Given an existing path, convert it to a path relative to a given starting path.

Parameters

string $endPath Absolute path of target
string $startPath Absolute path where traversal begins

Return Value

string Path of target relative to starting path

mirror(string $originDir, string $targetDir, Traversable $iterator = null, array $options = array())

Mirrors a directory to another.

Parameters

string $originDir The origin directory
string $targetDir The target directory
Traversable $iterator A Traversable instance
array $options An array of boolean options Valid options are: - $options['override'] Whether to override an existing file on copy or not (see copy()) - $options['copyonwindows'] Whether to copy files instead of links on Windows (see symlink()) - $options['delete'] Whether to delete files that are not in the source directory (defaults to false)

Exceptions

IOException When file type is unknown

bool isAbsolutePath(string $file)

Returns whether the file path is an absolute path.

Parameters

string $file A file path

Return Value

bool

string tempnam(string $dir, string $prefix)

Creates a temporary file with support for custom stream wrappers.

Parameters

string $dir The directory where the temporary filename will be created
string $prefix The prefix of the generated temporary filename Note: Windows uses only the first three characters of prefix

Return Value

string The new temporary filename (with path), or throw an exception on failure

dumpFile(string $filename, string $content)

Atomically dumps content into a file.

Parameters

string $filename The file to be written to
string $content The data to write into the file

Exceptions

IOException If the file cannot be written to.
doc_Symfony
2016-10-28 06:16:37
Comments
Leave a Comment

Please login to continue.