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.

false|string
get(string $file)

Returns the contents of the file.

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

Writes the supplied data to a file.

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

Prepends the supplied data to a file.

static false|int
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 44
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 55
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 66
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 77
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 93
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 104
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 115
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 126
int size(string $file)

Returns the fize of the file in bytes.

Parameters

string $file Path to file

Return Value

int

at line 137
string extension(string $file)

Returns the extension of the file.

Parameters

string $file Path to file

Return Value

string

at line 149
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 160
bool remove(string $file)

Deletes the file from disk.

Parameters

string $file Path to file

Return Value

bool

at line 171
bool removeDirectory(string $path)

Deletes a directory and its contents from disk.

Parameters

string $path Path to directory

Return Value

bool

at line 195
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 206
false|string get(string $file)

Returns the contents of the file.

Parameters

string $file File path

Return Value

false|string

at line 219
static false|int 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

false|int

at line 232
static false|int 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

false|int

at line 245
static false|int 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

false|int

at line 257
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 270
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 281
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 292
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 303
mixed include(string $file)

Includes a file.

Parameters

string $file Path to file

Return Value

mixed

at line 314
mixed includeOnce(string $file)

Includes a file it hasn't already been included.

Parameters

string $file Path to file

Return Value

mixed

at line 325
mixed require(string $file)

Requires a file.

Parameters

string $file Path to file

Return Value

mixed

at line 336
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 347
FileInfo info(string $file)

Returns a FileInfo object.

Parameters

string $file Path to file

Return Value

FileInfo

at line 360
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