Jump to content

Debugging toolbar/zh

From mediawiki.org
This page is a translated version of the page Debugging toolbar and the translation is 4% complete.

The debugging toolbar is a utility for developers that displays debug information about a MediaWiki page at the bottom of the browser window. You can enable it with the $wgDebugToolbar variable in LocalSettings.php:

$wgDebugToolbar = true;

The toolbar

The toolbar consists of multiple sections that you click to expand or collapse:

The sections are:

Console
An area where MediaWiki code can write messages. Superior to echoing text to the browser.
Queries
A list of SQL queries executed on that page, with timing (requires $wgDebugDumpSql ).
Debug log
A list of the debug messages printed during the page execution.
Request
HTTP请求信息。
PHP includes
A list of included PHP files during the page execution.
The rest
Statistics about the software versions, execution time, and memory used.

Click any section to expand it and see the data. Click it again to close. Use your browser's Find feature to search the data.

The MediaWiki and PHP links lead to their respective websites (https://www.mediawiki.org and https://php.net).

Logging messages to the console

See the file includes/debug/MWDebug.php for available functions. Here are a few useful examples:

use MWDebug
Load the module at the top of your file before calling any functions.
MWDebug::init()
Must be called first to enable most other functions
MWDebug::log('your message here')
Send an arbitrary message to the Console
MWDebug::warning('Never do that again')
Send a warning message to the Console
MWDebug::deprecated('Function Foobar() is dead')
Send a message to the Console about deprecated functionality, including a backtrace
MWDebug::queryTime(MWDebug::query('select foo from bar'));
Execute the given SQL and report its time in the Queries section.