Path

A Path handling class

deprecated
since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path instead.

package

Joomla CMS

Methods

canChmod

Checks if a path's permissions can be changed.

canChmod( path) : 
static deprecated
since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::canChmod() instead.

Arguments

path

stringPath to check.

Response

boolTrue if path can have mode changed.

check

Checks for snooping outside of the file system root.

check( path) : 
static deprecated
throws

Exception

since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::check() instead.

Arguments

path

stringA file system path to check.

Response

stringA cleaned version of the path or exit on error.

clean

Function to strip additional / or \ in a path name.

clean( path,  ds = DIRECTORY_SEPARATOR) : 
static deprecated
throws

UnexpectedValueException

since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::clean() instead.

Arguments

path

stringThe path to clean.

ds

stringDirectory separator (optional).

Response

stringThe cleaned path.

find

Searches the directory paths for a given file.

find( paths,  file) : 
static deprecated
since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::find() instead.

Arguments

paths

mixedA path string or array of path strings to search in

file

stringThe file name to look for.

Response

mixedThe full path and file name for the target file, or boolean false if the file is not found in any of the paths.

getPermissions

Get the permissions of the file/folder at a given path.

getPermissions( path) : 
static deprecated
since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::getPermissions() instead. The framework class throws Exceptions in case of error which you have to catch.

Arguments

path

stringThe path of a file/folder.

Response

stringFilesystem permissions.

isOwner

Method to determine if script owns the path.

isOwner( path) : 
static deprecated
since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::isOwner() instead.

Arguments

path

stringPath to check ownership.

Response

boolTrue if the php script owns the path passed.

removeRoot

Remove all references to root directory path and the system tmp path from a message

removeRoot( message,  rootDirectory = null) : 
static deprecated
since

3.10.7

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::removeRoot() instead.

Arguments

message

stringThe message to be cleaned

rootDirectory

stringOptional root directory, defaults to JPATH_ROOT

Response

string

resolve

Resolves /./, /../ and multiple / in a string and returns the resulting absolute path, inspired by Flysystem Removes trailing slashes

resolve( path) : 
static deprecated
since

3.9.25

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::resolve() instead.

Arguments

path

stringA path to resolve

Response

stringThe resolved path

setPermissions

Chmods files and directories recursively to given permissions.

setPermissions( path,  filemode = '0644',  foldermode = '0755') : 
static deprecated
since

1.7.0

deprecated

4.4 will be removed in 6.0 Use Joomla\Filesystem\Path::setPermissions() instead.

Arguments

path

stringRoot path to begin changing mode [without trailing slash].

filemode

stringOctal representation of the value to change file mode to [null = no change].

foldermode

stringOctal representation of the value to change folder mode to [null = no change].

Response

boolTrue if successful [one fail means the whole operation failed].