New debugger system that outputs a toolbar on page view. More...

Static Public Member Functions
static	addModules (OutputPage $out)
	Add ResourceLoader modules to the OutputPage object if debugging is enabled.
static	appendDebugInfoToApiResult (IContextSource $context, ApiResult $result)
	Append the debug info to given ApiResult.
static	clearLog ()
	Clears internal log array and deprecation tracking.
static	debugMsg ($str)
	This is a method to pass messages from wfDebug to the pretty debugger.
static	deprecated ($function, $version=false, $component=false, $callerOffset=2)
	Show a warning that $function is deprecated.
static	getDebugHTML (IContextSource $context)
	Returns the HTML to add to the page for the toolbar.
static	getDebugInfo (IContextSource $context)
	Returns the HTML to add to the page for the toolbar.
static	getHTMLDebugLog ()
	Generate debug log in HTML for displaying at the bottom of the main content area.
static	getLog ()
	Returns internal log array.
static	init ()
	Enabled the debugger and load resource module.
static	log ($str)
	Adds a line to the log.
static	query ($sql, $function, $isMaster)
	Begins profiling on a database query.
static	queryTime ($id)
	Calculates how long a query took.
static	warning ($msg, $callerOffset=1, $level=E_USER_NOTICE, $log= 'auto')
	Adds a warning entry to the log.
Static Protected Member Functions
static	getFilesIncluded (IContextSource $context)
	Returns a list of files included, along with their size.
Static Protected Attributes
static	$debug = array()
	Debug messages from wfDebug().
static	$deprecationWarnings = array()
	Array of functions that have already been warned, formatted function-caller to prevent a buttload of warnings.
static	$enabled = false
	Is the debugger enabled?
static	$log = array()
	Log lines.
static	$query = array()
	SQL statements of the databses queries.
Static Private Member Functions
static	getCallerDescription ($callerOffset)
	Get an array describing the calling function at a specified offset.
static	sendWarning ($msg, $caller, $level)
	Send a warning to the debug log and optionally also trigger a PHP error, depending on the $level argument.

Detailed Description

New debugger system that outputs a toolbar on page view.

By default, most methods do nothing ( self::$enabled = false ). You have to explicitly call MWDebug::init() to enabled them.

Todo:: Profiler support

Since:: 1.19

Definition at line 33 of file Debug.php.

Member Function Documentation

static MWDebug::addModules ( OutputPage $ out ) [static]

Add ResourceLoader modules to the OutputPage object if debugging is enabled.

Since:: 1.19

Parameters:

$out	OutputPage

Definition at line 88 of file Debug.php.

References OutputPage\addModules().

static MWDebug::appendDebugInfoToApiResult	(	IContextSource $	context,
		ApiResult $	result
	)		`[static]`

Append the debug info to given ApiResult.

Parameters:

$context	IContextSource
$result	ApiResult

Definition at line 479 of file Debug.php.

References ApiResult\addValue(), as, debugMsg(), getDebugInfo(), log(), ApiResult\setIndexedTagName(), and Sanitizer\stripAllTags().

static MWDebug::clearLog ( ) [static]

Clears internal log array and deprecation tracking.

Since:: 1.19

Definition at line 127 of file Debug.php.

References array().

Referenced by MWDebugTest\setUp().

static MWDebug::debugMsg ( $ str ) [static]

This is a method to pass messages from wfDebug to the pretty debugger.

Do NOT use this method, use MWDebug::log or wfDebug()

Since:: 1.19

Parameters:

$str string

Definition at line 309 of file Debug.php.

References $debug, UtfNormal\cleanUp(), and global.

Referenced by appendDebugInfoToApiResult(), and wfDebug().

static MWDebug::deprecated	(	$	function,
		$	version = `false`,
		$	component = `false`,
		$	callerOffset = `2`
	)		`[static]`

Show a warning that $function is deprecated.

This will send it to the following locations:

Debug toolbar, with one item per function and caller, if $wgDebugToolbar is set to true.
PHP's error log, with level E_USER_DEPRECATED, if $wgDevelopmentWarnings is set to true.
MediaWiki's debug log, if $wgDevelopmentWarnings is set to false.

Since:: 1.19

Parameters:

string	$function	Function that is deprecated.
string \| bool	$version	Version in which the function was deprecated.
string \| bool	$component	Component to which the function belongs. If false, it is assumbed the function is in MediaWiki core.
	$callerOffset	integer: How far up the callstack is the original caller. 2 = function that called the function that called MWDebug::deprecated() (Added in 1.20).

Returns:: mixed

Definition at line 188 of file Debug.php.

References array(), Html\element(), getCallerDescription(), global, Html\rawElement(), sendWarning(), and wfBacktrace().

Referenced by MWDebugTest\testAvoidDuplicateDeprecations(), MWDebugTest\testAvoidNonConsecutivesDuplicateDeprecations(), and wfDeprecated().

static MWDebug::getCallerDescription ( $ callerOffset ) [static, private]

Get an array describing the calling function at a specified offset.

Parameters:

$callerOffset integer: How far up the callstack is the original caller. 0 = function that called getCallerDescription()

Returns:: array with two keys: 'file' and 'func'

Definition at line 254 of file Debug.php.

References $file, array(), and wfDebugBacktrace().

Referenced by deprecated(), and warning().

static MWDebug::getDebugHTML ( IContextSource $ context ) [static]

Returns the HTML to add to the page for the toolbar.

Since:: 1.19

Parameters:

$context IContextSource

Returns:: string

Definition at line 385 of file Debug.php.

References $debug, $html, array(), getDebugInfo(), global, Html\inlineScript(), log(), ResourceLoader\makeConfigSetScript(), and ResourceLoader\makeLoaderConditionalScript().

Referenced by BaseTemplate\printTrail().

static MWDebug::getDebugInfo ( IContextSource $ context ) [static]

Returns the HTML to add to the page for the toolbar.

Parameters:

$context IContextSource

Returns:: array

Definition at line 513 of file Debug.php.

References $debug, $query, $wgRequestTime, array(), GitInfo\currentBranch(), getFilesIncluded(), IContextSource\getLanguage(), IContextSource\getRequest(), global, GitInfo\headSHA1(), and GitInfo\headViewUrl().

Referenced by appendDebugInfoToApiResult(), and getDebugHTML().

static MWDebug::getFilesIncluded ( IContextSource $ context ) [static, protected]

Returns a list of files included, along with their size.

Parameters:

$context IContextSource

Returns:: array

Definition at line 364 of file Debug.php.

References $file, $files, $size, array(), as, and IContextSource\getLanguage().

Referenced by getDebugInfo().

static MWDebug::getHTMLDebugLog ( ) [static]

Generate debug log in HTML for displaying at the bottom of the main content area.

If $wgShowDebug is false, an empty string is always returned.

Since:: 1.20

Returns:: string HTML fragment

Definition at line 420 of file Debug.php.

References $debug, $matches, $pre, $ret, array(), as, and global.

Referenced by Skin\generateDebugHTML().

static MWDebug::getLog ( ) [static]

Returns internal log array.

Since:: 1.19

Returns:: array

Definition at line 119 of file Debug.php.

References $log.

Referenced by MWDebugTest\testAddLog(), MWDebugTest\testAddWarning(), MWDebugTest\testAvoidDuplicateDeprecations(), and MWDebugTest\testAvoidNonConsecutivesDuplicateDeprecations().

static MWDebug::init ( ) [static]

Enabled the debugger and load resource module.

This is called by Setup.php when $wgDebugToolbar is true.

Since:: 1.19

Definition at line 77 of file Debug.php.

Referenced by MWDebugTest\setUp().

static MWDebug::log ( $ str ) [static]

Adds a line to the log.

Todo:: Add support for passing objects

Since:: 1.19

Parameters:

$str string

Definition at line 102 of file Debug.php.

References array(), and wfGetCaller().

Referenced by appendDebugInfoToApiResult(), getDebugHTML(), MWDebugTest\testAddLog(), and MWDebugTest\testAvoidNonConsecutivesDuplicateDeprecations().

static MWDebug::query	(	$	sql,
		$	function,
		$	isMaster
	)		`[static]`

Begins profiling on a database query.

Since:: 1.19

Parameters:

$sql	string
$function	string
$isMaster	bool

Returns:: int ID number of the query to pass to queryTime or -1 if the debugger is disabled

Definition at line 327 of file Debug.php.

References $query, and array().

static MWDebug::queryTime ( $ id ) [static]

Calculates how long a query took.

Since:: 1.19

Parameters:

$id int

Definition at line 349 of file Debug.php.

References $query.

static MWDebug::sendWarning	(	$	msg,
		$	caller,
		$	level
	)		`[static, private]`

Send a warning to the debug log and optionally also trigger a PHP error, depending on the $level argument.

Parameters:

$msg	string Message to send
$caller	array caller description get from getCallerDescription()
$level	int\|bool error level to use; set to false to not trigger an error

Definition at line 292 of file Debug.php.

References wfDebug().

Referenced by deprecated(), and warning().

static MWDebug::warning	(	$	msg,
		$	callerOffset = `1`,
		$	level = `E_USER_NOTICE`,
		$	log = `'auto'`
	)		`[static]`

Adds a warning entry to the log.

Since:: 1.19

Parameters:

$msg	string
$callerOffset	int
$level	int A PHP error level. See sendWarning()
$log	string: 'production' will always trigger a php error, 'auto' will trigger an error if $wgDevelopmentWarnings is true, and 'debug' will only write to the debug log(s).

Returns:: mixed

Definition at line 145 of file Debug.php.

References $log, array(), getCallerDescription(), global, and sendWarning().

Referenced by MWDebugTest\testAddWarning(), MWDebugTest\testAvoidNonConsecutivesDuplicateDeprecations(), wfLogWarning(), and wfWarn().

Member Data Documentation

array MWDebug::$debug = array() [static, protected]

Debug messages from wfDebug().

Definition at line 47 of file Debug.php.

array MWDebug::$deprecationWarnings = array() [static, protected]

Array of functions that have already been warned, formatted function-caller to prevent a buttload of warnings.

Definition at line 69 of file Debug.php.

bool MWDebug::$enabled = false [static, protected]

Is the debugger enabled?

Definition at line 61 of file Debug.php.

array MWDebug::$log = array() [static, protected]

Log lines.

Definition at line 40 of file Debug.php.

Referenced by getLog(), and warning().

array MWDebug::$query = array() [static, protected]

SQL statements of the databses queries.

Definition at line 54 of file Debug.php.

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

includes/debug/Debug.php

Static Public Member Functions

Static Protected Member Functions

Static Protected Attributes

Static Private Member Functions

Detailed Description

Member Function Documentation

Member Data Documentation