MediaWiki\Logger\Monolog\LegacyHandler Class Reference

Log handler that replicates the behavior of MediaWiki's former wfErrorLog() logging service. More...

Inherits AbstractProcessingHandler.

Collaboration diagram for MediaWiki\Logger\Monolog\LegacyHandler:

Public Member Functions
	__construct ( $stream, $useLegacyFilter=false, $level=Logger::DEBUG, $bubble=true)
	close ()

Protected Member Functions
	errorTrap ( $code, $msg)
	Custom error handler.
	openSink ()
	Open the log sink described by our stream URI.
	useUdp ()
	Should we use UDP to send messages to the sink?
	write (array $record)

Protected Attributes
string null	$error
string	$host
int	$port
string	$prefix
Socket resource null	$sink
	Log sink.
string	$uri
	Log sink descriptor.
bool	$useLegacyFilter
	Filter log events using legacy rules.

Detailed Description

Log handler that replicates the behavior of MediaWiki's former wfErrorLog() logging service.

Log output can be directed to a local file, a PHP stream, or a udp2log server.

For udp2log output, the stream specification must have the form: "udp://HOST:PORT[/PREFIX]" where:

• HOST: IPv4, IPv6 or hostname
• PORT: server port
• PREFIX: optional (but recommended) prefix telling udp2log how to route the log event. The special prefix "{channel}" will use the log event's channel as the prefix value.

When not targeting a udp2log stream this class will act as a drop-in replacement for \Monolog\Handler\StreamHandler.

Since

1.25

Note

© 2013 Wikimedia Foundation and contributors

Definition at line 50 of file LegacyHandler.php.

Constructor & Destructor Documentation

__construct()

MediaWiki\Logger\Monolog\LegacyHandler::__construct	(		$stream,
			$useLegacyFilter = false,
			$level = Logger::DEBUG,
			$bubble = true )

Parameters

string	$stream	Stream URI
bool	$useLegacyFilter	Filter log events using legacy rules
int	$level	Minimum logging level that will trigger handler
bool	$bubble	Can handled messages bubble up the handler stack?

Definition at line 96 of file LegacyHandler.php.

References MediaWiki\Logger\Monolog\LegacyHandler\$useLegacyFilter.

Member Function Documentation

close()

MediaWiki\Logger\Monolog\LegacyHandler::close

(

)

Definition at line 232 of file LegacyHandler.php.

errorTrap()

MediaWiki\Logger\Monolog\LegacyHandler::errorTrap ( $code, $msg )

protected

Custom error handler.

Parameters

int	$code	Error number
string	$msg	Error message

Definition at line 168 of file LegacyHandler.php.

openSink()

MediaWiki\Logger\Monolog\LegacyHandler::openSink ( )

protected

Open the log sink described by our stream URI.

Definition at line 110 of file LegacyHandler.php.

useUdp()

MediaWiki\Logger\Monolog\LegacyHandler::useUdp ( )

protected

Should we use UDP to send messages to the sink?

Returns

bool

Definition at line 176 of file LegacyHandler.php.

write()

MediaWiki\Logger\Monolog\LegacyHandler::write ( array $record )

protected

Definition at line 180 of file LegacyHandler.php.

Member Data Documentation

$error

string null MediaWiki\Logger\Monolog\LegacyHandler::$error

protected

Definition at line 73 of file LegacyHandler.php.

$host

string MediaWiki\Logger\Monolog\LegacyHandler::$host

protected

Definition at line 78 of file LegacyHandler.php.

$port

int MediaWiki\Logger\Monolog\LegacyHandler::$port

protected

Definition at line 83 of file LegacyHandler.php.

$prefix

string MediaWiki\Logger\Monolog\LegacyHandler::$prefix

protected

Definition at line 88 of file LegacyHandler.php.

$sink

Socket resource null MediaWiki\Logger\Monolog\LegacyHandler::$sink

protected

Log sink.

Definition at line 68 of file LegacyHandler.php.

$uri

string MediaWiki\Logger\Monolog\LegacyHandler::$uri

protected

Log sink descriptor.

Definition at line 56 of file LegacyHandler.php.

$useLegacyFilter

bool MediaWiki\Logger\Monolog\LegacyHandler::$useLegacyFilter

protected

Filter log events using legacy rules.

Definition at line 62 of file LegacyHandler.php.

Referenced by MediaWiki\Logger\Monolog\LegacyHandler\__construct().

---

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

• includes/debug/logger/monolog/LegacyHandler.php