Fonctions membres publiques statiques
static	copy ($src, $dest, $path='', $force=false, $useStreams=false)

static	create ($path='', $mode=0755)

static	delete ($path)

static	move ($src, $dest, $path='', $useStreams=false)

static	exists ($path)

static	files ( $path, $filter='.', $recurse=false, $full=false, $exclude=array('.svn', 'CVS', '.DS_Store', '__MACOSX'), $excludeFilter=array('^\..', '.~'), $naturalSort=false)

static	folders ( $path, $filter='.', $recurse=false, $full=false, $exclude=array('.svn', 'CVS', '.DS_Store', '__MACOSX'), $excludeFilter=array('^\..*'))

static	listFolderTree ($path, $filter, $maxLevel=3, $level=0, $parent=0)

static	makeSafe ($path)

Fonctions membres protégées statiques
static	_items ($path, $filter, $recurse, $full, $exclude, $excludeFilterString, $findFiles)

Description détaillée

A Folder handling class

Depuis: 1.7.0

Documentation des fonctions membres

◆ _items()

static _items	(	$path,
		$filter,
		$recurse,
		$full,
		$exclude,
		$excludeFilterString,
		$findFiles
	)

staticprotected

Function to read the files/folders in a folder.

Paramètres

string	$path	The path of the folder to read.
string	$filter	A filter for file names.
mixed	$recurse	True to recursively search into sub-folders, or an integer to specify the maximum depth.
boolean	$full	True to return the full path to the file.
array	$exclude	Array with names of files which should not be shown in the result.
string	$excludeFilterString	Regexp of files to exclude
boolean	$findFiles	True to read the files, false to read the folders

Renvoie: array Files.

Depuis: 1.7.0

Références $path.

◆ copy()

static copy	(	$src,
		$dest,
		$path = `''`,
		$force = `false`,
		$useStreams = `false`
	)

static

Copy a folder.

Paramètres

string	$src	The path to the source folder.
string	$dest	The path to the destination folder.
string	$path	An optional base path to prefix to the file names.
boolean	$force	Force copy.
boolean	$useStreams	Optionally force folder/file overwrites.

Renvoie: boolean True on success.

Depuis: 1.7.0

Exceptions

Références $path, Laminas\Diactoros\$stream, Path\clean(), ClientHelper\getCredentials(), FtpClient\getInstance(), Factory\getStream(), JPATH_ROOT, null, et Path\removeRoot().

Référencé par TemplateModel\copy(), Installer\copyFiles(), UpdateCoreCommand\copyFileTo(), LocalAdapter\copyFolder(), et LocalAdapter\moveFolder().

◆ create()

static create	(	$path = `''`,
		$mode = `0755`
	)

static

Create a folder – and all necessary parent folders.

Paramètres

string	$path	A path to create from the base path.
integer	$mode	Directory permissions to set for folders created. 0755 by default.

Renvoie: boolean True if successful.

Depuis: 1.7.0

Références $mode, $path, Text\_(), Log\add(), Path\clean(), ClientHelper\getCredentials(), FtpClient\getInstance(), JPATH_ROOT, null, et Log\WARNING.

Référencé par TemplateModel\child(), File\copy(), TemplateModel\copy(), FileAdapter\copyBaseFiles(), ComponentAdapter\createExtensionRoot(), InstallerAdapter\createExtensionRoot(), LocalAdapter\createFolder(), TemplateModel\createFolder(), TemplateModel\createOverride(), TemplateModel\createTemplateOverride(), FileAdapter\finaliseInstall(), Installer\parseFiles(), Installer\parseLanguages(), Installer\parseMedia(), FileStorage\save(), ApplicationModel\save(), File\upload(), File\write(), et DaemonApplication\writeProcessIdFile().

◆ delete()

static delete ( $path )

static

Delete a folder.

Paramètres

string $path The path to the folder to delete.

Renvoie: boolean True on success.

Depuis: 1.7.0

Références $folder, $path, Text\_(), Log\add(), Path\clean(), File\delete(), elseif, ClientHelper\getCredentials(), FtpClient\getInstance(), JPATH_ROOT, Text\sprintf(), et Log\WARNING.

Référencé par Installer\abort(), TemplateModel\child(), TemplateModel\cleanup(), InstallerHelper\cleanupInstall(), TemplateModel\copy(), LocalAdapter\delete(), TemplateModel\deleteFolder(), CleanupModel\deleteInstallationFolder(), PluginAdapter\finaliseUninstall(), PackageAdapter\finaliseUninstall(), ComponentAdapter\finaliseUninstall(), LocalAdapter\moveFolder(), Installer\parseFiles(), LanguageAdapter\removeExtensionFiles(), FileAdapter\removeExtensionFiles(), LibraryAdapter\removeExtensionFiles(), TemplateAdapter\removeExtensionFiles(), InstallerScript\removeFiles(), Installer\removeFiles(), TemplateAdapter\setupUninstall(), et ComponentAdapter\setupUninstall().

◆ exists()

static exists ( $path )

static

Wrapper for the standard file_exists function

Paramètres

string $path Folder name relative to installation dir

Renvoie: boolean True if path is a folder

Depuis: 1.7.0

Références $path, et Path\clean().

Référencé par TemplateModel\child(), TemplateModel\copy(), FileAdapter\copyBaseFiles(), TemplateModel\createOverride(), TemplateModel\createTemplateOverride(), LocalAdapter\delete(), PackageAdapter\finaliseUninstall(), Installer\findManifest(), MenusHelper\getPresets(), ChromestyleField\getTemplateModuleStyles(), Installer\install(), Joomla\Plugin\Editors\TinyMCE\PluginTraits\onDisplay(), Installer\parseLanguages(), FileAdapter\populateFilesAndFolderList(), FileAdapter\removeExtensionFiles(), LibraryAdapter\removeExtensionFiles(), TemplateAdapter\removeExtensionFiles(), InstallerScript\removeFiles(), Installer\removeFiles(), ApplicationModel\save(), LanguageAdapter\setupUninstall(), FolderPathExistsRule\test(), InstallerHelper\unpack(), et Installer\update().

◆ files()

static files	(	$path,
		$filter = `'.'`,
		$recurse = `false`,
		$full = `false`,
		$exclude = `array('.svn', 'CVS', '.DS_Store', '__MACOSX')`,
		$excludeFilter = `array('^\..', '.~')`,
		$naturalSort = `false`
	)

static

Utility function to read the files in a folder.

Paramètres

string	$path	The path of the folder to read.
string	$filter	A filter for file names.
mixed	$recurse	True to recursively search into sub-folders, or an integer to specify the maximum depth.
boolean	$full	True to return the full path to the file.
array	$exclude	Array with names of files which should not be shown in the result.
array	$excludeFilter	Array of filter to exclude
boolean	$naturalSort	False for asort, true for natsort

Renvoie: array|boolean Files in the given folder.

Depuis: 1.7.0

Références $path, Log\add(), Path\clean(), Text\sprintf(), et Log\WARNING.

Référencé par TemplateModel\createTemplateOverride(), InstallerHelper\detectType(), PluginAdapter\discover(), Installer\findManifest(), TemplateModel\fixTemplateName(), TracksModel\getContent(), LocalAdapter\getFiles(), FieldLayoutField\getInput(), ModulelayoutField\getInput(), ComponentlayoutField\getInput(), FilelistField\getOptions(), MenusHelper\getPresets(), ChromestyleField\getTemplateModuleStyles(), HelpModel\getToc(), MenutypesModel\getTypeOptionsFromLayouts(), ChangeSet\getUpdateFiles(), FieldsPlugin\onCustomFieldsGetTypes(), Joomla\Plugin\Editors\TinyMCE\PluginTraits\onDisplay(), Installer\parseSchemaUpdates(), FileAdapter\populateFilesAndFolderList(), ModuleModel\preprocessForm(), UpdatesitesModel\rebuild(), StringsModel\refresh(), FileAdapter\removeExtensionFiles(), LibraryAdapter\removeExtensionFiles(), Installer\setSchemaVersion(), ConfigurationModel\setup(), et InstallerHelper\unpack().

◆ folders()

static folders	(	$path,
		$filter = `'.'`,
		$recurse = `false`,
		$full = `false`,
		$exclude = `array('.svn', 'CVS', '.DS_Store', '__MACOSX')`,
		$excludeFilter = `array('^\..*')`
	)

static

Utility function to read the folders in a folder.

Paramètres

string	$path	The path of the folder to read.
string	$filter	A filter for folder names.
mixed	$recurse	True to recursively search into sub-folders, or an integer to specify the maximum depth.
boolean	$full	True to return the full path to the folders.
array	$exclude	Array with names of folders which should not be shown in the result.
array	$excludeFilter	Array with regular expressions matching folders which should not be shown in the result.

Renvoie: array Folders in the given folder.

Depuis: 1.7.0

Références $path, Log\add(), Path\clean(), Text\sprintf(), et Log\WARNING.

Référencé par TemplateModel\createTemplateOverride(), ModuleAdapter\discover(), PluginAdapter\discover(), TemplateAdapter\discover(), LanguageAdapter\discover(), ComponentAdapter\discover(), LocalAdapter\getFiles(), InstalledModel\getFolders(), MenutypesModel\getFolders(), InstallationApplication\getLocaliseAdmin(), FolderlistField\getOptions(), TemplateModel\getOverridesList(), MenutypesModel\getTypeOptionsFromLayouts(), MenutypesModel\getTypeOptionsFromMvc(), LibraryAdapter\removeExtensionFiles(), Menu\store(), et InstallerHelper\unpack().

◆ listFolderTree()

static listFolderTree	(	$path,
		$filter,
		$maxLevel = `3`,
		$level = `0`,
		$parent = `0`
	)

static

Lists folder in format suitable for tree display.

Paramètres

string	$path	The path of the folder to read.
string	$filter	A filter for folder names.
integer	$maxLevel	The maximum number of levels to recursively read, defaults to three.
integer	$level	The current level, optional.
integer	$parent	Unique identifier of the parent folder, if any.

Renvoie: array Folders in the given folder.

Depuis: 1.7.0

Références $id, $name, $path, Path\clean(), et JPATH_ROOT.

◆ makeSafe()

static makeSafe ( $path )

static

Makes path name safe to use.

Paramètres

string $path The full path to sanitise.

Renvoie: string The sanitised string.

Depuis: 1.7.0

Références $path.

Référencé par ContenthistoryHelper\getFormFile().

◆ move()

static move	(	$src,
		$dest,
		$path = `''`,
		$useStreams = `false`
	)

static

Moves a folder.

Paramètres

string	$src	The path to the source folder.
string	$dest	The path to the destination folder.
string	$path	An optional base path to prefix to the file names.
boolean	$useStreams	Optionally use streams.