Class for a file system (FS) based file backend. More...

Inheritance diagram for FSFileBackend:

Collaboration diagram for FSFileBackend:

Public Member Functions
	__construct (array $config)
	getDirectoryListInternal ($fullCont, $dirRel, array $params)
	getFileListInternal ($fullCont, $dirRel, array $params)
	handleWarning ($errno, $errstr)
	isPathUsableInternal ($storagePath)
	Check if a file can be created or changed at a given storage path.
Protected Member Functions
	_getResponseCopy ($errors, Status $status, array $params, $cmd)
	_getResponseCreate ($errors, Status $status, array $params, $cmd)
	_getResponseDelete ($errors, Status $status, array $params, $cmd)
	_getResponseMove ($errors, Status $status, array $params, $cmd)
	_getResponseStore ($errors, Status $status, array $params, $cmd)
	chmod ($path)
	Chmod a file, suppressing the warnings.
	cleanPathSlashes ($path)
	Clean up directory separators for the given OS.
	containerFSRoot ($shortCont, $fullCont)
	Given the short (unresolved) and full (resolved) name of a container, return the file system path of the container.
	directoriesAreVirtual ()
	Is this a key/value store where directories are just virtual? Virtual directories exists in so much as files exists that are prefixed with the directory path followed by a forward slash.
	doCleanInternal ($fullCont, $dirRel, array $params)
	doClearCache (array $paths=null)
	doCopyInternal (array $params)
	doCreateInternal (array $params)
	doDeleteInternal (array $params)
	doDirectoryExists ($fullCont, $dirRel, array $params)
	doExecuteOpHandlesInternal (array $fileOpHandles)
	doGetFileStat (array $params)
	doGetLocalCopyMulti (array $params)
	doGetLocalReferenceMulti (array $params)
	doMoveInternal (array $params)
	doPrepareInternal ($fullCont, $dirRel, array $params)
	doPublishInternal ($fullCont, $dirRel, array $params)
	doSecureInternal ($fullCont, $dirRel, array $params)
	doStoreInternal (array $params)
	htaccessPrivate ()
	Return the text of a .htaccess file to make a directory private.
	indexHtmlPrivate ()
	Return the text of an index.html file to hide directory listings.
	isLegalRelPath ($path)
	Sanity check a relative file system path for validity.
	resolveContainerPath ($container, $relStoragePath)
	Resolve a relative storage path, checking if it's allowed by the backend.
	resolveToFSPath ($storagePath)
	Get the absolute file system path for a storage path.
	trapWarnings ()
	Listen for E_WARNING errors and track whether any happen.
	untrapWarnings ()
	Stop listening for E_WARNING errors and return true if any happened.
Protected Attributes
	$basePath
Array	$containerPaths = array()
	Map of container names to root paths *.
	$currentUser
	$fileMode
	$fileOwner
Array	$hadWarningErrors = array()
	*

Detailed Description

Class for a file system (FS) based file backend.

All "containers" each map to a directory under the backend's base directory. For backwards-compatibility, some container paths can be set to custom paths. The wiki ID will not be used in any custom paths, so this should be avoided.

Having directories with thousands of files will diminish performance. Sharding can be accomplished by using FileRepo-style hash paths.

Status messages should avoid mentioning the internal FS paths. PHP warnings are assumed to be logged rather than output.

Since:: 1.19

Definition at line 41 of file FSFileBackend.php.

Constructor & Destructor Documentation

FSFileBackend::__construct ( array $ config )

See also:

FileBackendStore::__construct() Additional $config params include:

basePath : File system directory that holds containers.
containerPaths : Map of container names to custom file system directories. This should only be used for backwards-compatibility.
fileMode : Octal UNIX file permissions to use on files stored.

Reimplemented from FileBackendStore.

Definition at line 58 of file FSFileBackend.php.

Member Function Documentation

FSFileBackend::_getResponseCopy	(	$	errors,
		Status $	status,
		array $	params,
		$	cmd
	)		`[protected]`

See also:: FSFileBackend::doExecuteOpHandlesInternal()

Definition at line 320 of file FSFileBackend.php.

FSFileBackend::_getResponseCreate	(	$	errors,
		Status $	status,
		array $	params,
		$	cmd
	)		`[protected]`

See also:: FSFileBackend::doExecuteOpHandlesInternal()

Definition at line 215 of file FSFileBackend.php.

FSFileBackend::_getResponseDelete	(	$	errors,
		Status $	status,
		array $	params,
		$	cmd
	)		`[protected]`

See also:: FSFileBackend::doExecuteOpHandlesInternal()

Definition at line 418 of file FSFileBackend.php.

FSFileBackend::_getResponseMove	(	$	errors,
		Status $	status,
		array $	params,
		$	cmd
	)		`[protected]`

See also:: FSFileBackend::doExecuteOpHandlesInternal()

Definition at line 373 of file FSFileBackend.php.

FSFileBackend::_getResponseStore	(	$	errors,
		Status $	status,
		array $	params,
		$	cmd
	)		`[protected]`

See also:: FSFileBackend::doExecuteOpHandlesInternal()

Definition at line 260 of file FSFileBackend.php.

FSFileBackend::chmod ( $ path ) [protected]

Chmod a file, suppressing the warnings.

Parameters:

string $path Absolute file system path

Returns:: bool Success

Definition at line 681 of file FSFileBackend.php.

FSFileBackend::cleanPathSlashes ( $ path ) [protected]

Clean up directory separators for the given OS.

Parameters:

string $path FS path

Returns:: string

Definition at line 713 of file FSFileBackend.php.

FSFileBackend::containerFSRoot	(	$	shortCont,
		$	fullCont
	)		`[protected]`

Given the short (unresolved) and full (resolved) name of a container, return the file system path of the container.

Parameters:

string	$shortCont
string	$fullCont

Returns:: string|null

Definition at line 120 of file FSFileBackend.php.

FSFileBackend::directoriesAreVirtual ( ) [protected]

Is this a key/value store where directories are just virtual? Virtual directories exists in so much as files exists that are prefixed with the directory path followed by a forward slash.

Returns:: bool

Reimplemented from FileBackendStore.

Definition at line 641 of file FSFileBackend.php.

FSFileBackend::doCleanInternal	(	$	container,
		$	dir,
		array $	params
	)		`[protected]`

See also:: FileBackendStore::doClean()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 502 of file FSFileBackend.php.

FSFileBackend::doClearCache ( array $ paths = null ) [protected]

See also:: FileBackendStore::doClearCache()

Reimplemented from FileBackendStore.

Definition at line 540 of file FSFileBackend.php.

FSFileBackend::doCopyInternal ( array $ params ) [protected]

See also:: FileBackendStore::copyInternal()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 267 of file FSFileBackend.php.

FSFileBackend::doCreateInternal ( array $ params ) [protected]

See also:: FileBackendStore::createInternal()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 169 of file FSFileBackend.php.

FSFileBackend::doDeleteInternal ( array $ params ) [protected]

See also:: FileBackendStore::deleteInternal()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 380 of file FSFileBackend.php.

FSFileBackend::doDirectoryExists	(	$	container,
		$	dir,
		array $	params
	)		`[protected]`

See also:: FileBackendStore::directoryExists()

Parameters:

string	$container	Resolved container name
string	$dir	Resolved path relative to container
array	$params

Returns:: bool|null

Reimplemented from FileBackendStore.

Definition at line 544 of file FSFileBackend.php.

FSFileBackend::doExecuteOpHandlesInternal ( array $ fileOpHandles ) [protected]

See also:: FileBackendStore::executeOpHandlesInternal()

Parameters:

array $fileOpHandles

Exceptions:

MWException

Returns:: Array List of corresponding Status objects

Reimplemented from FileBackendStore.

Definition at line 645 of file FSFileBackend.php.

FSFileBackend::doGetFileStat ( array $ params ) [protected]

See also:: FileBackendStore::getFileStat()

Reimplemented from FileBackendStore.

Definition at line 515 of file FSFileBackend.php.

FSFileBackend::doGetLocalCopyMulti ( array $ params ) [protected]

See also:: FileBackendStore::getLocalCopyMulti()

Returns:: Array

Reimplemented from FileBackendStore.

Definition at line 609 of file FSFileBackend.php.

FSFileBackend::doGetLocalReferenceMulti ( array $ params ) [protected]

See also:: FileBackendStore::getLocalReferenceMulti()

Returns:: Array

Reimplemented from FileBackendStore.

Definition at line 594 of file FSFileBackend.php.

FSFileBackend::doMoveInternal ( array $ params ) [protected]

See also:: FileBackendStore::moveInternal()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 327 of file FSFileBackend.php.

FSFileBackend::doPrepareInternal	(	$	container,
		$	dir,
		array $	params
	)		`[protected]`

See also:: FileBackendStore::doPrepare()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 425 of file FSFileBackend.php.

FSFileBackend::doPublishInternal	(	$	container,
		$	dir,
		array $	params
	)		`[protected]`

See also:: FileBackendStore::doPublish()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 475 of file FSFileBackend.php.

FSFileBackend::doSecureInternal	(	$	container,
		$	dir,
		array $	params
	)		`[protected]`

See also:: FileBackendStore::doSecure()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 448 of file FSFileBackend.php.

FSFileBackend::doStoreInternal ( array $ params ) [protected]

See also:: FileBackendStore::storeInternal()

Returns:: Status

Reimplemented from FileBackendStore.

Definition at line 222 of file FSFileBackend.php.

FSFileBackend::getDirectoryListInternal	(	$	fullCont,
		$	dirRel,
		array $	params
	)

See also:: FileBackendStore::getDirectoryListInternal()

Returns:: Array|null

Reimplemented from FileBackendStore.

Definition at line 560 of file FSFileBackend.php.

FSFileBackend::getFileListInternal	(	$	fullCont,
		$	dirRel,
		array $	params
	)

See also:: FileBackendStore::getFileListInternal()

Returns:: Array|FSFileBackendFileList|null

Reimplemented from FileBackendStore.

Definition at line 579 of file FSFileBackend.php.

FSFileBackend::handleWarning	(	$	errno,
		$	errstr
	)

Parameters:

integer	$errno
string	$errstr

Returns:: bool

Access:: private

Definition at line 743 of file FSFileBackend.php.

FSFileBackend::htaccessPrivate ( ) [protected]

Return the text of a .htaccess file to make a directory private.

Returns:: string

Definition at line 703 of file FSFileBackend.php.

FSFileBackend::indexHtmlPrivate ( ) [protected]

Return the text of an index.html file to hide directory listings.

Returns:: string

Definition at line 694 of file FSFileBackend.php.

FSFileBackend::isLegalRelPath ( $ path ) [protected]

Sanity check a relative file system path for validity.

Parameters:

string $path Normalized relative path

Returns:: bool

Definition at line 100 of file FSFileBackend.php.

FSFileBackend::isPathUsableInternal ( $ storagePath )

Check if a file can be created or changed at a given storage path.

FS backends should check if the parent directory exists, files can be written under it, and that any file already there is writable. Backends using key/value stores should check if the container exists.

Parameters:

string $storagePath

Returns:: bool

Reimplemented from FileBackendStore.

Definition at line 148 of file FSFileBackend.php.

FSFileBackend::resolveContainerPath	(	$	container,
		$	relStoragePath
	)		`[protected]`

Resolve a relative storage path, checking if it's allowed by the backend.

This is intended for internal use, such as encoding illegal chars or perhaps getting absolute paths (e.g. FS based backends). Note that the relative path may be the empty string (e.g. the path is simply to the container).

Parameters:

string	$container	Container name
string	$relStoragePath	Storage path relative to the container

Returns:: string|null Path or null if not valid

Reimplemented from FileBackendStore.

Definition at line 83 of file FSFileBackend.php.

FSFileBackend::resolveToFSPath ( $ storagePath ) [protected]

Get the absolute file system path for a storage path.

Parameters:

string $storagePath Storage path

Returns:: string|null

Definition at line 135 of file FSFileBackend.php.

FSFileBackend::trapWarnings ( ) [protected]

Listen for E_WARNING errors and track whether any happen.

Returns:: void

Definition at line 722 of file FSFileBackend.php.

FSFileBackend::untrapWarnings ( ) [protected]

Stop listening for E_WARNING errors and return true if any happened.

Returns:: bool

Definition at line 732 of file FSFileBackend.php.

Member Data Documentation

FSFileBackend::$basePath [protected]

Definition at line 42 of file FSFileBackend.php.

Array FSFileBackend::$containerPaths = array() [protected]

Map of container names to root paths *.

Definition at line 43 of file FSFileBackend.php.

FSFileBackend::$currentUser [protected]

Definition at line 46 of file FSFileBackend.php.

FSFileBackend::$fileMode [protected]

Definition at line 44 of file FSFileBackend.php.

FSFileBackend::$fileOwner [protected]

Definition at line 45 of file FSFileBackend.php.

Array FSFileBackend::$hadWarningErrors = array() [protected]

*

Definition at line 48 of file FSFileBackend.php.

The documentation for this class was generated from the following file:

includes/filebackend/FSFileBackend.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation