\Monolog\HandlerBufferHandler

Buffers all records until closing the handler and then pass them as batch.

This is useful for a MailHandler to send only one mail per request instead of sending one per log message.

Summary

Methods
Properties
Constants
__construct()
isHandling()
handleBatch()
close()
pushProcessor()
popProcessor()
setFormatter()
getFormatter()
setLevel()
getLevel()
setBubble()
getBubble()
__destruct()
handle()
flush()
clear()
No public properties found
No constants found
getDefaultFormatter()
$level
$bubble
$formatter
$processors
$handler
$bufferSize
$bufferLimit
$flushOnOverflow
$buffer
$initialized
N/A
No private methods found
No private properties found
N/A

Properties

$level

$level : 

Type

$bubble

$bubble : 

Type

$processors

$processors : 

Type

$handler

$handler : 

Type

$bufferSize

$bufferSize : 

Type

$bufferLimit

$bufferLimit : 

Type

$flushOnOverflow

$flushOnOverflow : 

Type

$buffer

$buffer : 

Type

$initialized

$initialized : 

Type

Methods

__construct()

__construct(\Monolog\Handler\HandlerInterface  $handler, integer  $bufferLimit, integer  $level = \Monolog\Logger::DEBUG, Boolean  $bubble = true, Boolean  $flushOnOverflow = false) 

Parameters

\Monolog\Handler\HandlerInterface $handler

Handler.

integer $bufferLimit

How many entries should be buffered at most, beyond that the oldest items are removed from the buffer.

integer $level

The minimum logging level at which this handler will be triggered

Boolean $bubble

Whether the messages that are handled can bubble up the stack or not

Boolean $flushOnOverflow

If true, the buffer is flushed when the max size has been reached, by default oldest entries are discarded

isHandling()

isHandling(array  $record) : Boolean

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

This is mostly done for performance reasons, to avoid calling processors for nothing.

Handlers should still check the record levels within handle(), returning false in isHandling() is no guarantee that handle() will not be called, and isHandling() might not be called for a given record.

Parameters

array $record

Partial log record containing only a level key

Returns

Boolean

handleBatch()

handleBatch(array  $records) 

Handles a set of records at once.

Parameters

array $records

The records to handle (an array of record arrays)

close()

close() 

Closes the handler.

This will be called automatically when the object is destroyed

pushProcessor()

pushProcessor(callable  $callback) : self

Adds a processor in the stack.

Parameters

callable $callback

Returns

self

popProcessor()

popProcessor() : callable

Removes the processor on top of the stack and returns it.

Returns

callable

setLevel()

setLevel(integer|string  $level) : self

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

Parameters

integer|string $level

Level or level name

Returns

self

getLevel()

getLevel() : integer

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

Returns

integer

setBubble()

setBubble(Boolean  $bubble) : self

Sets the bubbling behavior.

Parameters

Boolean $bubble

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

Returns

self

getBubble()

getBubble() : Boolean

Gets the bubbling behavior.

Returns

Boolean —

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

__destruct()

__destruct() 

handle()

handle(array  $record) 

{@inheritdoc}

Parameters

array $record

flush()

flush() 

clear()

clear() 

Clears the buffer without flushing any messages down to the wrapped handler.