TempFSFile Class Reference

This class is used to hold the location and do limited manipulation of files stored temporarily (this will be whatever wfTempDir() returns) More...

Inheritance diagram for TempFSFile:

Collaboration diagram for TempFSFile:

Public Member Functions
	__construct ( $path)
	Do not call directly.
	__destruct ()
	Cleans up after the temporary file by deleting it.
	autocollect ()
	Set flag clean up after the temporary file.
	bind ( $object)
	Clean up the temporary file only after an object goes out of scope.
	preserve ()
	Set flag to not clean up after the temporary file.
	purge ()
	Purge this file off the file system.
Public Member Functions inherited from FSFile
	exists ()
	Checks if the file exists.
	getPath ()
	Returns the file system path.
	getProps ( $ext=true)
	Get an associative array containing information about a file with the given storage path.
	getSha1Base36 ( $recache=false)
	Get a SHA-1 hash of a file in the local filesystem, in base-36 lower case encoding, zero padded to 31 digits.
	getSize ()
	Get the file size in bytes.
	getTimestamp ()
	Get the file's last-modified timestamp.

Static Public Member Functions
static	factory ( $prefix, $extension='', $tmpDirectory=null)
	Make a new temporary file on the file system.
static	getUsableTempDirectory ()
static	purgeAllOnShutdown ()
	Try to make sure that all files are purged on error.
Static Public Member Functions inherited from FSFile
static	extensionFromPath ( $path)
	Get the final file extension from a file system path.
static	getPropsFromPath ( $path, $ext=true)
	Get an associative array containing information about a file in the local filesystem.
static	getSha1Base36FromPath ( $path)
	Get a SHA-1 hash of a file in the local filesystem, in base-36 lower case encoding, zero padded to 31 digits.
static	placeholderProps ()
	Placeholder file properties to use for files that don't exist.

Protected Attributes
bool	$canDelete = false
	Garbage collect the temp file.
Protected Attributes inherited from FSFile
string	$path
	Path to file.
string	$sha1Base36
	File SHA-1 in base 36.

Static Protected Attributes
static array	$pathsCollect = null
	Map of (path => 1) for paths to delete on shutdown.

Detailed Description

This class is used to hold the location and do limited manipulation of files stored temporarily (this will be whatever wfTempDir() returns)

Definition at line 35 of file TempFSFile.php.

Constructor & Destructor Documentation

__construct()

TempFSFile::__construct

(

$path

)

Do not call directly.

Use TempFSFileFactory

Parameters

string

$path

Reimplemented from FSFile.

Definition at line 47 of file TempFSFile.php.

References $path.

__destruct()

TempFSFile::__destruct

(

)

Cleans up after the temporary file by deleting it.

Definition at line 188 of file TempFSFile.php.

References purge().

Member Function Documentation

autocollect()

TempFSFile::autocollect

(

)

Set flag clean up after the temporary file.

Returns

TempFSFile This object

Definition at line 162 of file TempFSFile.php.

References $path.

bind()

TempFSFile::bind

(

$object

)

Clean up the temporary file only after an object goes out of scope.

Parameters

object

$object

Returns

TempFSFile This object

Definition at line 132 of file TempFSFile.php.

factory()

static TempFSFile::factory (   $prefix,   $extension = '',   $tmpDirectory = null  )

static

Make a new temporary file on the file system.

Temporary files may be purged when the file object falls out of scope.

Deprecated:

since 1.34, use TempFSFileFactory directly

Parameters

string	$prefix
string	$extension	Optional file extension
string | null	$tmpDirectory	Optional parent directory

Returns

TempFSFile|null

Definition at line 69 of file TempFSFile.php.

getUsableTempDirectory()

static TempFSFile::getUsableTempDirectory ( )

static

Todo:

Is there any useful way to test this? Would it be useful to make this non-static on TempFSFileFactory?

Returns

string Filesystem path to a temporary directory

Exceptions

RuntimeException

if no writable temporary directory can be found

Definition at line 80 of file TempFSFile.php.

Referenced by MediaWiki\FileBackend\FSFile\TempFSFileFactory\newTempFSFile().

preserve()

TempFSFile::preserve

(

)

Set flag to not clean up after the temporary file.

Returns

TempFSFile This object

Definition at line 149 of file TempFSFile.php.

purge()

TempFSFile::purge

(

)

Purge this file off the file system.

Returns

bool Success

Definition at line 115 of file TempFSFile.php.

Referenced by __destruct().

purgeAllOnShutdown()

static TempFSFile::purgeAllOnShutdown ( )

static

Try to make sure that all files are purged on error.

This method should only be called internally

Definition at line 177 of file TempFSFile.php.

References $path.

Member Data Documentation

$canDelete

bool TempFSFile::$canDelete = false

protected

Garbage collect the temp file.

Definition at line 37 of file TempFSFile.php.

$pathsCollect

array TempFSFile::$pathsCollect = null

staticprotected

Map of (path => 1) for paths to delete on shutdown.

Definition at line 40 of file TempFSFile.php.

---

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

• includes/libs/filebackend/fsfile/TempFSFile.php