MediaWiki\Logger\Monolog\LineFormatter Class Reference

Formats incoming records into a one-line string. More...

Inheritance diagram for MediaWiki\Logger\Monolog\LineFormatter:

Collaboration diagram for MediaWiki\Logger\Monolog\LineFormatter:

Public Member Functions
	__construct ( $format=null, $dateFormat=null, $allowInlineLineBreaks=false, $ignoreEmptyContextAndExtra=false, $includeStacktraces=false)
	format (array $record)

Protected Member Functions
	exceptionAsArray ( $e)
	Convert a throwable to an array of structured data. More...
	normalizeException ( $e)
	Convert a Throwable to a string. More...
	normalizeExceptionArray (array $e)
	Convert an array of Throwable data to a string. More...

Detailed Description

Formats incoming records into a one-line string.

An 'exeception' in the log record's context will be treated specially. It will be output for an 'exception' placeholder in the format and excluded from 'context' output if the 'exception' placeholder is present.

Throwables that are logged with this formatter will optional have their stack traces appended. If that is done, MWExceptionHandler::redactedTrace() will be used to redact the trace information.

Since

1.26

Note

© 2015 Wikimedia Foundation and contributors

Definition at line 44 of file LineFormatter.php.

Constructor & Destructor Documentation

__construct()

MediaWiki\Logger\Monolog\LineFormatter::__construct	(		$format = null,
			$dateFormat = null,
			$allowInlineLineBreaks = false,
			$ignoreEmptyContextAndExtra = false,
			$includeStacktraces = false
	)

Parameters

string | null	$format	The format of the message
string | null	$dateFormat	The format of the timestamp: one supported by DateTime::format
bool	$allowInlineLineBreaks	Whether to allow inline line breaks in log entries
bool	$ignoreEmptyContextAndExtra
bool	$includeStacktraces

Definition at line 53 of file LineFormatter.php.

Member Function Documentation

exceptionAsArray()

MediaWiki\Logger\Monolog\LineFormatter::exceptionAsArray (   $e )

protected

Convert a throwable to an array of structured data.

Parameters

Exception | Throwable

$e

Returns

array

Definition at line 113 of file LineFormatter.php.

References MWExceptionHandler\redactTrace().

Referenced by MediaWiki\Logger\Monolog\LineFormatter\normalizeException().

format()

MediaWiki\Logger\Monolog\LineFormatter::format

(

array

$record

)

Definition at line 67 of file LineFormatter.php.

References $output, MediaWiki\Logger\Monolog\LineFormatter\normalizeException(), and MediaWiki\Logger\Monolog\LineFormatter\normalizeExceptionArray().

normalizeException()

MediaWiki\Logger\Monolog\LineFormatter::normalizeException (   $e )

protected

Convert a Throwable to a string.

Parameters

Exception | Throwable

$e

Returns

string

Definition at line 103 of file LineFormatter.php.

References MediaWiki\Logger\Monolog\LineFormatter\exceptionAsArray(), and MediaWiki\Logger\Monolog\LineFormatter\normalizeExceptionArray().

Referenced by MediaWiki\Logger\Monolog\LineFormatter\format().

normalizeExceptionArray()

MediaWiki\Logger\Monolog\LineFormatter::normalizeExceptionArray ( array  $e )

protected

Convert an array of Throwable data to a string.

Parameters

array

$e

Returns

string

Definition at line 137 of file LineFormatter.php.

References MWExceptionHandler\prettyPrintTrace().

Referenced by MediaWiki\Logger\Monolog\LineFormatter\format(), and MediaWiki\Logger\Monolog\LineFormatter\normalizeException().

---

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

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