HTTPFileStreamer Class Reference

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

Public Member Functions
	__construct ( $path, array $params=[])
	stream ( $headers=[], $sendErrors=true, $optHeaders=[], $flags=0)
	Stream a file to the browser, adding all the headings and fun stuff. More...

Static Public Member Functions
static	parseRange ( $range, $size)
	Convert a Range header value to an absolute (start, end) range tuple. More...
static	preprocessHeaders ( $headers)
	Takes HTTP headers in a name => value format and converts them to the weird format expected by stream(). More...
static	send404Message ( $fname, $flags=0)
	Send out a standard 404 message for a file. More...

Public Attributes
const	STREAM_ALLOW_OB = 2
const	STREAM_HEADLESS = 1

Static Protected Member Functions
static	contentTypeFromPath ( $filename)
	Determine the file type of a file based on the path. More...
static	resetOutputBuffers ()

Protected Attributes
callable	$obResetFunc
string	$path
callable	$streamMimeFunc

Detailed Description

Functions related to the output of file content.

Since

1.28

Definition at line 31 of file HTTPFileStreamer.php.

Constructor & Destructor Documentation

__construct()

HTTPFileStreamer::__construct	(		$path,
		array	$params = []
	)

Parameters

string	$path	Local filesystem path to a file
array	$params	Options map, which includes: obResetFunc : alternative callback to clear the output buffer streamMimeFunc : alternative method to determine the content type from the path

Definition at line 71 of file HTTPFileStreamer.php.

References $path.

Member Function Documentation

contentTypeFromPath()

static HTTPFileStreamer::contentTypeFromPath (   $filename )

staticprotected

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

Parameters

string

$filename

Storage path or file system path

Returns

null|string

Definition at line 270 of file HTTPFileStreamer.php.

References $ext.

parseRange()

static HTTPFileStreamer::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

Definition at line 227 of file HTTPFileStreamer.php.

Referenced by StreamFile\parseRange(), and stream().

preprocessHeaders()

static HTTPFileStreamer::preprocessHeaders (   $headers )

static

Takes HTTP headers in a name => value format and converts them to the weird format expected by stream().

Parameters

string[]

$headers

Returns

array[] [ $headers, $optHeaders ]

Since

1.34

Definition at line 51 of file HTTPFileStreamer.php.

References $header.

resetOutputBuffers()

static HTTPFileStreamer::resetOutputBuffers ( )

staticprotected

Definition at line 254 of file HTTPFileStreamer.php.

send404Message()

static HTTPFileStreamer::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

Definition at line 203 of file HTTPFileStreamer.php.

References HttpStatus\header().

Referenced by FileBackendStore\doStreamFile(), SwiftFileBackend\doStreamFile(), StreamFile\send404Message(), and stream().

stream()

HTTPFileStreamer::stream	(		$headers = [],
			$sendErrors = true,
			$optHeaders = [],
			$flags = 0
	)

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

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

Returns

bool Success

Definition at line 88 of file HTTPFileStreamer.php.

References $header, $type, HttpStatus\header(), parseRange(), print, send404Message(), and STREAM_HEADLESS.

Member Data Documentation

$obResetFunc

callable HTTPFileStreamer::$obResetFunc

protected

Definition at line 35 of file HTTPFileStreamer.php.

$path

string HTTPFileStreamer::$path

protected

Definition at line 33 of file HTTPFileStreamer.php.

Referenced by __construct().

$streamMimeFunc

callable HTTPFileStreamer::$streamMimeFunc

protected

Definition at line 37 of file HTTPFileStreamer.php.

STREAM_ALLOW_OB

const HTTPFileStreamer::STREAM_ALLOW_OB = 2

Definition at line 42 of file HTTPFileStreamer.php.

Referenced by FileBackendStore\doStreamFile().

STREAM_HEADLESS

const HTTPFileStreamer::STREAM_HEADLESS = 1

Definition at line 40 of file HTTPFileStreamer.php.

Referenced by FileBackendStore\doStreamFile(), SwiftFileBackend\doStreamFile(), and stream().

---

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

• includes/libs/filebackend/HTTPFileStreamer.php