Class Folder

Folder structure browser, lists folders and files.

Long description for class

Object

Folder

Package: cake\cake\libs
Copyright: Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
License: The MIT License
Location: folder.php

Properties summary

$__directories public

array

holds array of complete directory paths.
$__errors public

array

holds errors from last method.
$__files public

array

holds array of complete file paths.
$__messages public

array

holds messages from last method.
$mode public

boolean

mode to be used on create.
$path public

string

Path to Folder.
$sort public

boolean

Sortedness.

Inherited Properties

_log

Method Summary

__construct() public

Constructor.
__tree() public

Private method to list directories and files in each directory
_findRecursive() public

Private helper function for findRecursive.
addPathElement() public

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

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

nix flavored alias
create() public

Create a directory structure recursively.
delete() public

Recursively Remove directories if system allow.
dirsize() public

Returns the size in bytes of this Folder.
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

Returns true if the File is in a given CakePath.
inPath() public

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

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

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

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

nix flavored alias
messages() public

get messages from latest method
mkdir() public

nix flavored alias
move() public

Recursive directory move.
mv() public

nix flavored alias
normalizePath() public

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)
rm() public

nix flavored alias
slashTerm() public

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

Returns an array of nested directories and files in each directory

Method Detail

__construct() public ¶

__construct( string $path = false , boolean $create = false , mixed $mode = false )

Constructor.

Parameters

string $path optional false: Path to folder
boolean $create optional false: Create folder if not found
mixed $mode optional false: Mode (CHMOD) to apply to created folder, false to ignore

Overrides

Object::__construct()

__tree() public ¶

__tree( string $path , = $exceptions )

Private method to list directories and files in each directory

Parameters

string $path
= $exceptions: $hidden

_findRecursive() public ¶

_findRecursive( string $pattern , $sort = false )

Private helper function for findRecursive.

Parameters

string $pattern: Pattern to match against
$sort optional false

Returns

array
Files matching pattern

addPathElement() public ¶

addPathElement( string $path , string $element )

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

Parameters

string $path: Path
string $element: Element to and at end of path

Returns

string
Combined path

cd() public ¶

cd( string $path )

Change directory to $path.

Parameters

string $path: Path to the directory to change to

Returns

string
The new path. Returns false on failure

chmod() public ¶

chmod( string $path , integer $mode = false , boolean $recursive = true , array $exceptions = array() )

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

Parameters

string $path: The path to chmod
integer $mode optional false: octal value 0755
boolean $recursive optional true: chmod recursively
array $exceptions optional array(): array of files, directories to skip

Returns

boolean
Returns TRUE on success, FALSE on failure

copy() public ¶

copy( array $options = array() )

Recursive directory copy.

Parameters

array $options optional array(): (to, from, chmod, skip)

Returns

boolean

correctSlashFor() public ¶

correctSlashFor( string $path )

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 "/")

cp() public ¶

cp( $options )

nix flavored alias

See

Folder::copy()

create() public ¶

create( string $pathname , integer $mode = false )

Create a directory structure recursively.

Parameters

string $pathname: The directory structure to create
integer $mode optional false: octal value 0755

Returns

boolean
Returns TRUE on success, FALSE on failure

delete() public ¶

delete( string $path = null )

Recursively Remove directories if system allow.

Parameters

string $path optional null: Path of directory to delete

Returns

boolean
Success

dirsize() public ¶

dirsize( string $directory ,… )

Returns the size in bytes of this Folder.

Parameters

string $directory ,…: Path to directory

Returns

integer
size in bytes of current folder

errors() public ¶

errors( )

get error from latest method

Returns

array

find() public ¶

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

Returns an array of all matching files in current directory.

Parameters

string $regexpPattern optional '.*': $pattern Preg_match pattern (Defaults to: .*)
$sort optional false

Returns

array
Files that match given pattern

findRecursive() public ¶

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

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

Parameters

string $pattern optional '.*': Preg_match pattern (Defaults to: .*)
$sort optional false

Returns

array
Files matching $pattern

inCakePath() public ¶

inCakePath( $path = '' )

Returns true if the File is in a given CakePath.

Returns

boolean

inPath() public ¶

inPath( $path = '' , $reverse = false )

Returns true if the File is in given path.

Returns

boolean

isAbsolute() public ¶

isAbsolute( string $path )

Returns true if given $path is an absolute path.

Parameters

string $path: Path to check

Returns

boolean

isSlashTerm() public ¶

isSlashTerm( string $path )

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

Parameters

string $path: Path to check

Returns

boolean
true if path ends with slash, false otherwise

isWindowsPath() public ¶

isWindowsPath( string $path )

Returns true if given $path is a Windows path.

Parameters

string $path: Path to check

Returns

boolean
true if windows path, false otherwise

ls() public ¶

ls( $sort = true , $exceptions = false )

nix flavored alias

See

Folder::read()

messages() public ¶

messages( )

get messages from latest method

Returns

array

mkdir() public ¶

mkdir( $pathname , $mode = 0755 )

nix flavored alias

See

Folder::create()

move() public ¶

move( array $options )

Recursive directory move.

Parameters

array $options: (to, from, chmod, skip)

Returns

boolean
Success

mv() public ¶

mv( $options )

nix flavored alias

See

Folder::move()

normalizePath() public ¶

normalizePath( string $path )

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( )

Return current path.

Returns

string
Current path

read() public ¶

read( boolean $sort = true , mixed $exceptions = false , boolean $fullPath = false )

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

Parameters

boolean $sort optional true
mixed $exceptions optional false: Either an array or boolean true will not grab dot files
boolean $fullPath optional false: True returns the full path

Returns

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

realpath() public ¶

realpath( string $path )

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

Parameters

string $path: Path to resolve

Returns

string
The resolved path

rm() public ¶

rm( $path )

nix flavored alias

See

Folder::delete()

slashTerm() public ¶

slashTerm( string $path )

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

Parameters

string $path: Path to check

Returns

string
Path with ending slash

tree() public ¶

tree( string $path , boolean $exceptions = true , string $type = null )

Returns an array of nested directories and files in each directory

Parameters

string $path: the directory path to build the tree from
boolean $exceptions optional true: $hidden return hidden files and directories
string $type optional null: either file or dir. null returns both files and directories

Returns

mixed
array of nested directories and files in each directory

Methods inherited from Object

A hack to support __construct() on PHP 4 Hint: descendant classes have no PHP4 class_name() constructors, so this constructor gets called first and calls the top-layer __construct() which (if present) should call parent::__construct()

Returns

Object

__openPersistent() public ¶

__openPersistent( string $name , string $type = null )

Open the persistent class file for reading Used by Object::_persist()

Parameters

string $name: Name of persisted class
string $type optional null: Type of persistance (e.g: registry)

_persist() public ¶

_persist( string $name , string $return , $object , $type = null )

Checks for a persistent class file, if found file is opened and true returned If file is not found a file is created and false returned If used in other locations of the model you should choose a unique name for the persistent file There are many uses for this method, see manual for examples

Parameters

string $name: name of the class to persist
string $return: $object the object to persist
$object
$type optional null

Returns

boolean
Success

_savePersistent() public ¶

_savePersistent( string $name , object $object )

You should choose a unique name for the persistent file

There are many uses for this method, see manual for examples

Parameters

string $name: name used for object to cache
object $object: the object to persist

Returns

boolean
true on save, throws error if file can not be created

_set() public ¶

_set( array $properties = array() )

Allows setting of multiple properties of the object in a single line of code.

Parameters

array $properties optional array(): An associative array containing properties and corresponding values.

_stop() public ¶

_stop( $status = 0 )

Stop execution of the current script

Parameters

$status optional 0: http://php.net/exit for values

cakeError() public ¶

cakeError( string $method , array $messages = array() )

Used to report user friendly errors. If there is a file app/error.php or app/app_error.php this file will be loaded error.php is the AppError class it should extend ErrorHandler class.

Parameters

string $method: Method to be called in the error class (AppError or ErrorHandler classes)
array $messages optional array(): Message that is to be displayed by the error class

Returns

error
message

dispatchMethod() public ¶

dispatchMethod( string $method , array $params = array() )

Calls a method on this object with the given parameters. Provides an OO wrapper for call_user_func_array, and improves performance by using straight method calls in most cases.

Parameters

string $method: Name of the method to call
array $params optional array(): Parameter list to use when calling $method

Returns

mixed
Returns the result of the method call

log() public ¶

log( string $msg , integer $type = LOG_ERROR )

API for logging events.

Parameters

string $msg: Log message
integer $type optional LOG_ERROR: Error type constant. Defined in app/config/core.php.

Returns

boolean
Success of log write

requestAction() public ¶

requestAction( mixed $url , array $extra = array() )

Calls a controller's method from any location.

Parameters

mixed $url: String or array-based url.
array $extra optional array(): if array includes the key "return" it sets the AutoRender to true.

Returns

mixed

Boolean true or false on success/failure, or contents of rendered action if 'return' is set in $extra.

toString() public ¶

toString( )

Object-to-string conversion. Each class can override this method as necessary.

Returns

string
The name of this class

Properties detail

`$__directories` ¶

public array

holds array of complete directory paths.

`$__errors` ¶

public array

holds errors from last method.

false

`$__files` ¶

public array

holds array of complete file paths.

`$__messages` ¶

public array

holds messages from last method.

array()

`$mode` ¶

public boolean

mode to be used on create.

`$path` ¶

public string

Path to Folder.

null

`$sort` ¶

public boolean

Sortedness.

false

Classes

Functions

Class Folder

Properties summary

Inherited Properties

Method Summary

__construct() public

__tree() public

_findRecursive() public

addPathElement() public

cd() public

chmod() public

copy() public

correctSlashFor() public

cp() public

create() public

delete() public

dirsize() public

errors() public

find() public

findRecursive() public

inCakePath() public

inPath() public

isAbsolute() public

isSlashTerm() public

isWindowsPath() public

ls() public

messages() public

mkdir() public

move() public

mv() public

normalizePath() public

pwd() public

read() public

realpath() public

rm() public

slashTerm() public

tree() public

Method Detail

__construct() public ¶

Parameters

Overrides

__tree() public ¶

Parameters

_findRecursive() public ¶

Parameters

Returns

addPathElement() public ¶

Parameters

Returns

cd() public ¶

Parameters

Returns

chmod() public ¶

Parameters

Returns

copy() public ¶

Parameters

Returns

correctSlashFor() public ¶

Parameters

Returns

cp() public ¶

See

create() public ¶

Parameters

Returns

delete() public ¶

Parameters

Returns

dirsize() public ¶

Parameters

Returns

errors() public ¶

Returns

find() public ¶

Parameters

Returns

findRecursive() public ¶

Parameters