Debugging toolbar/zh

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.