1. class
  2. mako
  3. \
  4. file
  5. \
  6. FileSystem

FileSystem

class FileSystem

File system.

Methods

bool
has(string $file)

Returns TRUE if a file exists and FALSE if not.

bool
isFile(string $file)

Returns TRUE if the provided path is a file and FALSE if not.

bool
isDirectory(string $directory)

Returns TRUE if the provided path is a directory and FALSE if not.

bool
isEmpty(string $path)

Returns TRUE if a file or directory is empty and FALSE if not.

bool
isReadable(string $file)

Returns TRUE if the file is readable and FALSE if not.

bool
isWritable(string $file)

Returns TRUE if the file or directory is writable and FALSE if not.

int
lastModified(string $file)

Returns the time (unix timestamp) the file was last modified.

int
size(string $file)

Returns the fize of the file in bytes.

string
extension(string $file)

Returns the extension of the file.

bool
rename(string $oldName, string $newName)

Renames a file or directory.

bool
remove(string $file)

Deletes the file from disk.

bool
removeDirectory(string $path)

Deletes a directory and its contents from disk.

array|false
glob(string $pattern, int $flags = 0)

Returns an array of pathnames matching the provided pattern.

string|false
get(string $file)

Returns the contents of the file.

static int|false
put(string $file, mixed $data, bool $lock = false)

Writes the supplied data to a file.

static int|false
prepend(string $file, mixed $data, bool $lock = false)

Prepends the supplied data to a file.

static int|false
append(string $file, mixed $data, bool $lock = false)

Appends the supplied data to a file.

static bool
truncate(string $file, bool $lock = false)

Truncates a file.

bool
createDirectory(string $path, int $mode = 0777, bool $recursive = false)

Creates a directory.

float
getDiskSize(string|null $directory = null)

Returns the total size of a filesystem or disk partition in bytes.

float
getFreeSpaceOnDisk(string|null $directory = null)

Returns the total number of available bytes on the filesystem or disk partition.

mixed
include(string $file)

Includes a file.

mixed
includeOnce(string $file)

Includes a file it hasn't already been included.

mixed
require(string $file)

Requires a file.

mixed
requireOnce(string $file)

Requires a file if it hasn't already been required.

FileInfo
info(string $file)

Returns a FileInfo object.

SplFileObject
file(string $file, string $openMode = 'r', bool $useIncludePath = false)

Returns a SplFileObject.

Details

at line 46
bool has(string $file)

Returns TRUE if a file exists and FALSE if not.

Parameters

string $file Path to file

Return Value

bool

at line 57
bool isFile(string $file)

Returns TRUE if the provided path is a file and FALSE if not.

Parameters

string $file Path to file

Return Value

bool

at line 68
bool isDirectory(string $directory)

Returns TRUE if the provided path is a directory and FALSE if not.

Parameters

string $directory Path to directory

Return Value

bool

at line 79
bool isEmpty(string $path)

Returns TRUE if a file or directory is empty and FALSE if not.

Parameters

string $path Path to directory

Return Value

bool

at line 95
bool isReadable(string $file)

Returns TRUE if the file is readable and FALSE if not.

Parameters

string $file Path to file

Return Value

bool

at line 106
bool isWritable(string $file)

Returns TRUE if the file or directory is writable and FALSE if not.

Parameters

string $file Path to file

Return Value

bool

at line 117
int lastModified(string $file)

Returns the time (unix timestamp) the file was last modified.

Parameters

string $file Path to file

Return Value

int

at line 128
int size(string $file)

Returns the fize of the file in bytes.

Parameters

string $file Path to file

Return Value

int

at line 139
string extension(string $file)

Returns the extension of the file.

Parameters

string $file Path to file

Return Value

string

at line 151
bool rename(string $oldName, string $newName)

Renames a file or directory.

Parameters

string $oldName Old name
string $newName New name

Return Value

bool

at line 162
bool remove(string $file)

Deletes the file from disk.

Parameters

string $file Path to file

Return Value

bool

at line 173
bool removeDirectory(string $path)

Deletes a directory and its contents from disk.

Parameters

string $path Path to directory

Return Value

bool

at line 197
array|false glob(string $pattern, int $flags = 0)

Returns an array of pathnames matching the provided pattern.

Parameters

string $pattern Patern
int $flags Flags

Return Value

array|false

at line 208
string|false get(string $file)

Returns the contents of the file.

Parameters

string $file File path

Return Value

string|false

at line 221
static int|false put(string $file, mixed $data, bool $lock = false)

Writes the supplied data to a file.

Parameters

string $file File path
mixed $data File data
bool $lock Acquire an exclusive write lock?

Return Value

int|false

at line 234
static int|false prepend(string $file, mixed $data, bool $lock = false)

Prepends the supplied data to a file.

Parameters

string $file File path
mixed $data File data
bool $lock Acquire an exclusive write lock?

Return Value

int|false

at line 247
static int|false append(string $file, mixed $data, bool $lock = false)

Appends the supplied data to a file.

Parameters

string $file File path
mixed $data File data
bool $lock Acquire an exclusive write lock?

Return Value

int|false

at line 259
static bool truncate(string $file, bool $lock = false)

Truncates a file.

Parameters

string $file File path
bool $lock Acquire an exclusive write lock?

Return Value

bool

at line 272
bool createDirectory(string $path, int $mode = 0777, bool $recursive = false)

Creates a directory.

Parameters

string $path Path to directory
int $mode Mode
bool $recursive Recursive

Return Value

bool

at line 283
float getDiskSize(string|null $directory = null)

Returns the total size of a filesystem or disk partition in bytes.

Parameters

string|null $directory A directory of the filesystem or disk partition

Return Value

float

at line 294
float getFreeSpaceOnDisk(string|null $directory = null)

Returns the total number of available bytes on the filesystem or disk partition.

Parameters

string|null $directory A directory of the filesystem or disk partition

Return Value

float

at line 305
mixed include(string $file)

Includes a file.

Parameters

string $file Path to file

Return Value

mixed

at line 316
mixed includeOnce(string $file)

Includes a file it hasn't already been included.

Parameters

string $file Path to file

Return Value

mixed

at line 327
mixed require(string $file)

Requires a file.

Parameters

string $file Path to file

Return Value

mixed

at line 338
mixed requireOnce(string $file)

Requires a file if it hasn't already been required.

Parameters

string $file Path to file

Return Value

mixed

at line 349
FileInfo info(string $file)

Returns a FileInfo object.

Parameters

string $file Path to file

Return Value

FileInfo

at line 362
SplFileObject file(string $file, string $openMode = 'r', bool $useIncludePath = false)

Returns a SplFileObject.

Parameters

string $file Path to file
string $openMode Open mode
bool $useIncludePath Use include path?

Return Value

SplFileObject