StreamFile Class Reference

Functions related to the output of file content. More...

Static Public Member Functions
static	contentTypeFromPath ( $filename, $safe=true)
	Determine the file type of a file based on the path.
static	parseRange ( $range, $size)
	Convert a Range header value to an absolute (start, end) range tuple.
static	send404Message ( $fname, $flags=0)
	Send out a standard 404 message for a file.
static	stream ( $fname, $headers=[], $sendErrors=true, $optHeaders=[], $flags=0)
	Stream a file to the browser, adding all the headings and fun stuff.

Public Attributes
const	STREAM_ALLOW_OB = HTTPFileStreamer::STREAM_ALLOW_OB
const	STREAM_HEADLESS = HTTPFileStreamer::STREAM_HEADLESS

Detailed Description

Functions related to the output of file content.

Definition at line 26 of file StreamFile.php.

Member Function Documentation

contentTypeFromPath()

static StreamFile::contentTypeFromPath (   $filename,   $safe = true  )

static

Determine the file type of a file based on the path.

Parameters

string	$filename	Storage path or file system path
bool	$safe	Whether to do retroactive upload blacklist checks

Returns

null|string

Definition at line 99 of file StreamFile.php.

References $ext, $type, $wgCheckFileExtensions, $wgFileBlacklist, $wgFileExtensions, $wgMimeTypeBlacklist, $wgStrictFileExtensions, $wgTrivialMimeDetection, $wgVerifyMimeType, UploadBase\checkFileExtensionList(), and UploadBase\splitExtensions().

Referenced by FileBackendDBRepoWrapper\streamFile().

parseRange()

static StreamFile::parseRange (   $range,   $size  )

static

Convert a Range header value to an absolute (start, end) range tuple.

Parameters

string	$range	Range header value
int	$size	File size

Returns

array|string Returns error string on failure (start, end, length)

Since

1.24

Deprecated:

since 1.34, use HTTPFileStreamer::parseRange() instead

Definition at line 87 of file StreamFile.php.

References HTTPFileStreamer\parseRange(), and wfDeprecated().

send404Message()

static StreamFile::send404Message (   $fname,   $flags = 0  )

static

Send out a standard 404 message for a file.

Parameters

string	$fname	Full name and path of the file to stream
int	$flags	Bitfield of STREAM_* constants

Since

1.24

Deprecated:

since 1.34, use HTTPFileStreamer::send404Message() instead

Definition at line 73 of file StreamFile.php.

References HTTPFileStreamer\send404Message(), and wfDeprecated().

stream()

static StreamFile::stream (   $fname,   $headers = [],   $sendErrors = true,   $optHeaders = [],   $flags = 0  )

static

Stream a file to the browser, adding all the headings and fun stuff.

Headers sent include: Content-type, Content-Length, Last-Modified, and Content-Disposition.

Parameters

string	$fname	Full name and path of the file to stream
array	$headers	Any additional headers to send if the file exists
bool	$sendErrors	Send error messages if errors occur (like 404)
array	$optHeaders	HTTP request header map (e.g. "range") (use lowercase keys)
int	$flags	Bitfield of STREAM_* constants

Exceptions

MWException

Returns

bool Success

Definition at line 47 of file StreamFile.php.

References FileBackend\isStoragePath().

Referenced by MediaTransformOutput\streamFileWithStatus().

Member Data Documentation

STREAM_ALLOW_OB

const StreamFile::STREAM_ALLOW_OB = HTTPFileStreamer::STREAM_ALLOW_OB

Deprecated:

since 1.34

Definition at line 32 of file StreamFile.php.

STREAM_HEADLESS

const StreamFile::STREAM_HEADLESS = HTTPFileStreamer::STREAM_HEADLESS

Deprecated:

since 1.34

Definition at line 29 of file StreamFile.php.

---

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

• includes/StreamFile.php