LocalFileSeeker
in package
implements
SeekerInterface
Tags
Interfaces, Classes, Traits and Enums
- SeekerInterface
- Defines an interface for retrieving arbitrary data from within an object.
Table of Contents
- $path : string
- The path of the local file.
- $size : int
- The size of the file.
- $stream : false|resource
- The file pointer.
- __construct() : mixed
- Create a new LocalFileSeeker object.
- __destruct() : mixed
- Destructor function to ensure the file descriptor is closed.
- getStream() : resource
- Retrieve a file pointer that returns a decompressed copy of `$length` bytes starting from `$offset`.
- retrieveEnd() : string
- Retrieve data from the end of the object, with an optional offset.
- retrieveStart() : string
- Retrieve data from the start of the object, with an optional offset.
Properties
$path
The path of the local file.
protected
string
$path
Tags
$size
The size of the file.
protected
int
$size
Tags
$stream
The file pointer.
protected
false|resource
$stream
Tags
Methods
__construct()
Create a new LocalFileSeeker object.
public
__construct(string $path) : mixed
Parameters
- $path : string
-
The path to the local file.
Tags
Return values
mixed —__destruct()
Destructor function to ensure the file descriptor is closed.
public
__destruct() : mixed
Tags
Return values
mixed —getStream()
Retrieve a file pointer that returns a decompressed copy of `$length` bytes starting from `$offset`.
public
getStream(int $length[, int $offset = 0 ][, int $compression = 0 ]) : resource
Parameters
- $length : int
-
The number of bytes to be read.
- $offset : int = 0
-
The offset from the start of the object.
- $compression : int = 0
-
The value of the compression header for the file.
Tags
Return values
resource —A file pointer to retrieve the decompressed bytes.
retrieveEnd()
Retrieve data from the end of the object, with an optional offset.
public
retrieveEnd(int $length[, int $offset = 0 ]) : string
Parameters
- $length : int
-
The number of bytes to be returned.
- $offset : int = 0
-
The offset counting backwards from the end of the object.
Tags
Return values
string —The bytestring of the data.
retrieveStart()
Retrieve data from the start of the object, with an optional offset.
public
retrieveStart(int $length[, int $offset = 0 ]) : string
Parameters
- $length : int
-
The number of bytes to be returned.
- $offset : int = 0
-
The offset from the start of the object.
Tags
Return values
string —The bytestring of the data.