Documentation

CubeHandler extends AbstractProcessingHandler
in package

Logs to Cube.

Tags
link
https://github.com/square/cube/wiki
author

Wan Chen kami@kamisama.me

deprecated

Since 2.8.0 and 3.2.0, Cube appears abandoned and thus we will drop this handler in Monolog 4

Table of Contents

$bubble  : bool
$formatter  : FormatterInterface|null
$level  : int
$processors  : array<string|int, callable>
$acceptedSchemes  : array<string|int, string>
$host  : string
$httpConnection  : resource|CurlHandle|null
$port  : int
$scheme  : string
$udpConnection  : resource|Socket|null
__construct()  : mixed
Create a Cube handler
__destruct()  : mixed
__sleep()  : mixed
close()  : void
Closes the handler.
getBubble()  : bool
Gets the bubbling behavior.
getFormatter()  : FormatterInterface
{@inheritDoc}
getLevel()  : int
Gets minimum logging level at which this handler will be triggered.
handle()  : bool
{@inheritDoc}
handleBatch()  : void
Handles a set of records at once.
isHandling()  : bool
{@inheritDoc}
popProcessor()  : callable
{@inheritDoc}
pushProcessor()  : HandlerInterface
{@inheritDoc}
reset()  : void
setBubble()  : self
Sets the bubbling behavior.
setFormatter()  : HandlerInterface
{@inheritDoc}
setLevel()  : self
Sets minimum logging level at which this handler will be triggered.
connectHttp()  : void
Establish a connection to an http server
connectUdp()  : void
Establish a connection to an UDP socket
getDefaultFormatter()  : FormatterInterface
Gets the default formatter.
processRecord()  : array<string|int, mixed>
Processes a record.
resetProcessors()  : void
write()  : void
Writes the record down to the log of the implementing handler
writeHttp()  : void
writeUdp()  : void

Properties

$level

protected int $level = MonologLogger::DEBUG
Tags
phpstan-var

Level

$processors

protected array<string|int, callable> $processors = []
Tags
phpstan-var

array<ProcessorInterface|callable(Record): Record>

$acceptedSchemes

private array<string|int, string> $acceptedSchemes = ['http', 'udp']

$httpConnection

private resource|CurlHandle|null $httpConnection = null

$udpConnection

private resource|Socket|null $udpConnection = null

Methods

__construct()

Create a Cube handler

public __construct(string $url[, mixed $level = Logger::DEBUG ][, bool $bubble = true ]) : mixed
Parameters
$url : string
$level : mixed = Logger::DEBUG
$bubble : bool = true
Tags
throws
UnexpectedValueException

when given url is not a valid url. A valid url must consist of three parts : protocol://host:port Only valid protocols used by Cube are http and udp

Return values
mixed

__destruct()

public __destruct() : mixed
Return values
mixed

__sleep()

public __sleep() : mixed
Return values
mixed

close()

Closes the handler.

public close() : void
Return values
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.

getLevel()

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

public getLevel() : int
Tags
phpstan-return

Level

Return values
int

handle()

{@inheritDoc}

public handle(array<string|int, mixed> $record) : bool
Parameters
$record : array<string|int, mixed>
Return values
bool

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 (an array of record arrays)

Return values
void

isHandling()

{@inheritDoc}

public isHandling(array<string|int, mixed> $record) : bool
Parameters
$record : array<string|int, mixed>
Return values
bool

setBubble()

Sets the bubbling behavior.

public setBubble(bool $bubble) : self
Parameters
$bubble : bool

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

Return values
self

setLevel()

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

public setLevel(Level|LevelName|\Psr\Log\LogLevel::* $level) : self
Parameters
$level : Level|LevelName|\Psr\Log\LogLevel::*

Level or level name

Return values
self

connectHttp()

Establish a connection to an http server

protected connectHttp() : void
Tags
throws
LogicException

when unable to connect to the socket

throws
MissingExtensionException

when no curl extension

Return values
void

connectUdp()

Establish a connection to an UDP socket

protected connectUdp() : void
Tags
throws
LogicException

when unable to connect to the socket

throws
MissingExtensionException

when there is no socket extension

Return values
void

processRecord()

Processes a record.

protected processRecord(array<string|int, mixed> $record) : array<string|int, mixed>
Parameters
$record : array<string|int, mixed>
Tags
phpstan-param

Record $record

phpstan-return

Record

Return values
array<string|int, mixed>

write()

Writes the record down to the log of the implementing handler

protected write(array<string|int, mixed> $record) : void
Parameters
$record : array<string|int, mixed>
Return values
void

writeHttp()

private writeHttp(string $data) : void
Parameters
$data : string
Return values
void

writeUdp()

private writeUdp(string $data) : void
Parameters
$data : string
Return values
void

Search results