Documentation

LogEntriesHandler extends SocketHandler
in package

Application

Stores to any socket - uses fsockopen() or pfsockopen().

Properties

$bubble : bool
$formatter : FormatterInterface|null
$level : Level
$logToken : string
$processors : array<string|int, callable>

Methods

__construct() : mixed
__destruct() : mixed
__sleep() : mixed
close() : void: We will not close a PersistentSocket instance so it can be reused in other requests.
closeSocket() : void: Close socket, if open
getBubble() : bool: Gets the bubbling behavior.
getChunkSize() : int|null: Get current chunk size
getConnectionString() : string: Get current connection string
getConnectionTimeout() : float: Get current connection timeout setting
getFormatter() : FormatterInterface
getLevel() : Level: Gets minimum logging level at which this handler will be triggered.
getTimeout() : float: Get current in-transfer timeout
getWritingTimeout() : float: Get current local writing timeout
handle() : bool: Handles a record.
handleBatch() : void: Handles a set of records at once.
isConnected() : bool: Check to see if the socket is currently available.
isHandling() : bool: Checks whether the given record will be handled by this handler.
isPersistent() : bool: Get persistent setting
popProcessor() : callable
pushProcessor() : HandlerInterface
reset() : void
setBubble() : $this: Sets the bubbling behavior.
setChunkSize() : $this: Set chunk size. Only has effect during connection in the writing cycle.
setConnectionTimeout() : $this: Set connection timeout. Only has effect before we connect.
setFormatter() : HandlerInterface
setLevel() : $this: Sets minimum logging level at which this handler will be triggered.
setPersistent() : $this: Set socket connection to be persistent. It only has effect before the connection is initiated.
setTimeout() : $this: Set write timeout. Only has effect before we connect.
setWritingTimeout() : $this: Set writing timeout. Only has effect during connection in the writing cycle.
fsockopen() : resource|false: Wrapper to allow mocking
fwrite() : int|false: Wrapper to allow mocking
generateDataStream() : string
getDefaultFormatter() : FormatterInterface: Gets the default formatter.
getResource() : resource|null
pfsockopen() : resource|false: Wrapper to allow mocking
processRecord() : LogRecord
resetProcessors() : void
streamGetMetadata() : array<string|int, mixed>|bool: Wrapper to allow mocking
streamSetChunkSize() : int|false: Wrapper to allow mocking
streamSetTimeout() : bool: Wrapper to allow mocking
write() : void: Connect (if necessary) and write to the socket

$bubble


        protected
            bool
    $bubble
     = true

$formatter


        protected
            FormatterInterface|null
    $formatter
     = null

$level


        protected
            Level
    $level
     = \Monolog\Level::Debug

$logToken


        protected
            string
    $logToken

$processors


        protected
            array<string|int, callable>
    $processors
     = []

__construct()


    public
                    __construct(string $token[, bool $useSSL = true ][, mixed $level = Level::Debug ][, bool $bubble = true ][, string $host = 'data.logentries.com' ][, bool $persistent = false ][, float $timeout = 0.0 ][, float $writingTimeout = 10.0 ][, float|null $connectionTimeout = null ][, int|null $chunkSize = null ]) : mixed

Parameters

$token : string: Log token supplied by LogEntries
$useSSL : bool = true: Whether or not SSL encryption should be used.
$level : mixed = Level::Debug: The minimum logging level at which this handler will be triggered
$bubble : bool = true: Whether the messages that are handled can bubble up the stack or not
$host : string = 'data.logentries.com': Custom hostname to send the data to if needed
$persistent : bool = false: Flag to enable/disable persistent connections
$timeout : float = 0.0: Socket timeout to wait until the request is being aborted
$writingTimeout : float = 10.0: Socket timeout to wait until the request should've been sent/written
$connectionTimeout : float|null = null: Socket connect timeout to wait until the connection should've been established
$chunkSize : int|null = null: Sets the chunk size. Only has effect during connection in the writing cycle

__destruct()


    public
                    __destruct() : mixed

__sleep()


    public
                    __sleep() : mixed

close()

We will not close a PersistentSocket instance so it can be reused in other requests.


    public
                    close() : void

closeSocket()

Close socket, if open


    public
                    closeSocket() : void

getBubble()

Gets the bubbling behavior.


    public
                    getBubble() : bool

Return values

bool —

true means that this handler allows bubbling. false means that bubbling is not permitted.

getChunkSize()

Get current chunk size


    public
                    getChunkSize() : int|null

Return values

int|null

getConnectionString()

Get current connection string


    public
                    getConnectionString() : string

Return values

string

getConnectionTimeout()

Get current connection timeout setting


    public
                    getConnectionTimeout() : float

Return values

float

getFormatter()


    public
                    getFormatter() : FormatterInterface

Return values

FormatterInterface

getLevel()

Gets minimum logging level at which this handler will be triggered.


    public
                    getLevel() : Level

Return values

Level

getTimeout()

Get current in-transfer timeout


    public
                    getTimeout() : float

Return values

float

getWritingTimeout()

Get current local writing timeout


    public
                    getWritingTimeout() : float

Return values

float

handle()

Handles a record.


    public
                    handle(LogRecord $record) : bool

Parameters

$record : LogRecord: The record to handle

Return values

bool —

true means that this handler handled the record, and that bubbling is not permitted. false means the record was either not processed or that this handler allows bubbling.

handleBatch()

Handles a set of records at once.


    public
                    handleBatch(array<string|int, mixed> $records) : void

Parameters

$records : array<string|int, mixed>: The records to handle

isConnected()

Check to see if the socket is currently available.


    public
                    isConnected() : bool

UDP might appear to be connected but might fail when writing. See http://php.net/fsockopen for details.

Return values

bool

isHandling()

Checks whether the given record will be handled by this handler.


    public
                    isHandling(LogRecord $record) : bool

Parameters

$record : LogRecord: Partial log record having only a level initialized

Return values

bool

isPersistent()

Get persistent setting


    public
                    isPersistent() : bool

Return values

bool

popProcessor()


    public
                    popProcessor() : callable

Return values

callable

pushProcessor()


    public
                    pushProcessor(callable $callback) : HandlerInterface

Parameters

$callback : callable

Return values

HandlerInterface

reset()


    public
                    reset() : void

setBubble()

Sets the bubbling behavior.


    public
                    setBubble(bool $bubble) : $this

Parameters

$bubble : bool: true means that this handler allows bubbling. false means that bubbling is not permitted.

Return values

$this

setChunkSize()

Set chunk size. Only has effect during connection in the writing cycle.


    public
                    setChunkSize(int $bytes) : $this

Parameters

$bytes : int

Return values

$this

setConnectionTimeout()

Set connection timeout. Only has effect before we connect.


    public
                    setConnectionTimeout(float $seconds) : $this

Parameters

$seconds : float

Return values

$this

setFormatter()


    public
                    setFormatter(FormatterInterface $formatter) : HandlerInterface

Parameters

$formatter : FormatterInterface

Return values

HandlerInterface

setLevel()

Sets minimum logging level at which this handler will be triggered.


    public
                    setLevel(Level|LogLevel::* $level) : $this

Parameters

$level : Level|LogLevel::*: Level or level name

Return values

$this

setPersistent()

Set socket connection to be persistent. It only has effect before the connection is initiated.


    public
                    setPersistent(bool $persistent) : $this

Parameters

$persistent : bool

Return values

$this

setTimeout()

Set write timeout. Only has effect before we connect.


    public
                    setTimeout(float $seconds) : $this

Parameters

$seconds : float

Return values

$this

setWritingTimeout()

Set writing timeout. Only has effect during connection in the writing cycle.


    public
                    setWritingTimeout(float $seconds) : $this

Parameters

$seconds : float: 0 for no timeout

Return values

$this

fsockopen()

Wrapper to allow mocking


    protected
                    fsockopen() : resource|false

Return values

resource|false

fwrite()

Wrapper to allow mocking


    protected
                    fwrite(string $data) : int|false

Parameters

$data : string

Return values

int|false

generateDataStream()


    protected
                    generateDataStream(LogRecord $record) : string

Parameters

$record : LogRecord

Return values

string

getDefaultFormatter()

Gets the default formatter.


    protected
                    getDefaultFormatter() : FormatterInterface

Overwrite this if the LineFormatter is not a good default for your handler.

Return values

FormatterInterface

getResource()


    protected
                    getResource() : resource|null

Return values

resource|null

pfsockopen()

Wrapper to allow mocking


    protected
                    pfsockopen() : resource|false

Return values

resource|false

processRecord()


    protected
                    processRecord(LogRecord $record) : LogRecord

Parameters

$record : LogRecord

Return values

LogRecord

resetProcessors()


    protected
                    resetProcessors() : void

streamGetMetadata()

Wrapper to allow mocking


    protected
                    streamGetMetadata() : array<string|int, mixed>|bool

Return values

array<string|int, mixed>|bool

streamSetChunkSize()

Wrapper to allow mocking


    protected
                    streamSetChunkSize() : int|false

Return values

int|false

streamSetTimeout()

Wrapper to allow mocking


    protected
                    streamSetTimeout() : bool

Return values

bool

write()

Connect (if necessary) and write to the socket


    protected
                    write(LogRecord $record) : void

Parameters

$record : LogRecord

LogEntriesHandler extends SocketHandler in package Application

Tags

Table of Contents

Properties

Methods

Properties

$bubble

$formatter

$level

$logToken

$processors

Tags

Methods

__construct()

Parameters

Tags

__destruct()

__sleep()

close()

closeSocket()

getBubble()

Return values

getChunkSize()

Return values

getConnectionString()

Return values

getConnectionTimeout()

Return values

getFormatter()

Tags

Return values

getLevel()

Return values

getTimeout()

Return values

getWritingTimeout()

Return values

handle()

Parameters

Tags

Return values

handleBatch()

Parameters

Tags

isConnected()

Return values

isHandling()

Parameters

Tags

Return values

isPersistent()

Return values

popProcessor()

Tags

Return values

pushProcessor()

Parameters

Tags

Return values

reset()

setBubble()

Parameters

Return values

setChunkSize()

Parameters

Return values

setConnectionTimeout()

Parameters

Tags

Return values

setFormatter()

Parameters

Tags

Return values

setLevel()

Parameters

Tags

Return values

setPersistent()

Parameters

LogEntriesHandler extends SocketHandler
in package

Application