Base collectors

Collectors provided in the DebugBar\DataCollector namespace.

Messages

Provides a way to log messages (compatible with PSR-3 logger). You can call the useHtmlVarDumper() function to use VarDumper's interactive HTML dumper for interactively rendering complex variables. If you do that, you must properly render inline assets when rendering the debug bar in addition to the normal js/css static assets.

$c = new DebugBar\DataCollector\MessagesCollector();
$c->useHtmlVarDumper(); // Enables prettier dumps of objects; requires inline assets
$debugbar->addCollector($c);

$debugbar['messages']->info('hello world');
$complicated_variable = array(1, 2, array(3, 4));
$debugbar['messages']->info($complicated_variable); // interactive HTML variable dumping

You can have multiple messages collector by naming them:

$debugbar->addCollector(new MessagesCollector('io_ops'));
$debugbar['io_ops']->info('opening files');

You can aggregate messages collector into other to have a unified view:

$debugbar['messages']->aggregate($debugbar['io_ops']);

If you don't want to create a standalone tab in the debug bar but still be able to log messages from a different collector, you don't have to add the collector to the debug bar:

$debugbar['messages']->aggregate(new MessagesCollector('io_ops'));

TimeData

Provides a way to log total execution time as well as taking "measures" (ie. measure the execution time of a particular operation).

$debugbar->addCollector(new DebugBar\DataCollector\TimeDataCollector());

$debugbar['time']->startMeasure('longop', 'My long operation');
sleep(2);
$debugbar['time']->stopMeasure('longop');

$debugbar['time']->measure('My long operation', function() {
    sleep(2);
});

Displays the measures on a timeline

Exceptions

Display exceptions

$debugbar->addCollector(new DebugBar\DataCollector\ExceptionsCollector());

try {
    throw new Exception('foobar');
} catch (Exception $e) {
    $debugbar['exceptions']->addThrowable($e);
}

PDO

Logs SQL queries.

$debugbar->addCollector(new DebugBar\DataCollector\PDO\PDOCollector($pdo));

You can even log queries from multiple PDO connections:

$pdoCollector = new DebugBar\DataCollector\PDO\PDOCollector();
$pdoCollector->addConnection($pdoRead, 'read-db');
$pdoCollector->addConnection($pdoWrite, 'write-db');

$debugbar->addCollector($pdoCollector);

If you want to see your PDO requests in the TimeDataCollector, you must add the PDOConnector to the $debugbar first

$timeDataCollector = new DebugBar\DataCollector\TimeDataCollector();
$pdoCollector = new DebugBar\DataCollector\PDO\PDOCollector($pdo, $timeDataCollector);

$debugBar->addCollector($pdoCollector);
$debugBar->addCollector($timeDataCollector);

RequestData

Collects the data of PHP's global variables. You can call the useHtmlVarDumper() function to use VarDumper's interactive HTML dumper for rendering the variables. If you do that, you must properly render inline assets when rendering the debug bar in addition to the normal js/css static assets.

$requestDataCollector = new DebugBar\DataCollector\RequestDataCollector();
$requestDataCollector->useHtmlVarDumper();
$debugbar->addCollector($requestDataCollector);

Config

Used to display any key/value pairs array. You can call the useHtmlVarDumper() function to use VarDumper's interactive HTML dumper for rendering the variables. If you do that, you must properly render inline assets when rendering the debug bar in addition to the normal js/css static assets.

$data = array('foo' => 'bar');
$configCollector = new DebugBar\DataCollector\ConfigCollector($data);
$configCollector->useHtmlVarDumper();
$debugbar->addCollector($configCollector);

You can provide a different name for this collector in the second argument of the constructor.

AggregatedCollector

Aggregates multiple collectors. Do not provide any widgets, you have to add your own controls.

$debugbar->addCollector(new DebugBar\DataCollector\AggregatedCollector('all_messages', 'messages', 'time'));
$debugbar['all_messages']->addCollector($debugbar['messages']);
$debugbar['all_messages']->addCollector(new DebugBar\DataCollector\MessagesCollector('mails'));
$debugbar['all_messages']['mails']->addMessage('sending mail');

$renderer = $debugbar->getJavascriptRenderer();
$renderer->addControl('all_messages', array(
    'widget' => 'PhpDebugBar.Widgets.MessagesWidget',
    'map' => 'all_messages',
    'default' => '[]',
));

Others

Misc collectors which you can just register:

MemoryCollector (memory): Display memory usage
PhpInfoCollector (php): PHP version number

4.9 KiB Raw Blame History