Path
A Path handling class
| 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) :
| 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) :
| throws |
|
|---|---|
| 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) :
| throws |
|
|---|---|
| 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) :
| 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) :
| 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) :
| 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) :
| 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) :
| 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') :
| 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].