
1、簡(jiǎn)介
Laravel Debugbar在 Laravel 5 中集成了PHP Debug Bar用于顯示調(diào)試及錯(cuò)誤信息以方便開發(fā)。該擴(kuò)展包包含了一個(gè) ServiceProvider 用于注冊(cè)調(diào)試條及開發(fā)過(guò)程中數(shù)據(jù)集合顯示,你可以發(fā)布其前端資源和配置,還可以配置顯示重定向及 Ajax 請(qǐng)求。
2、安裝
使用 Composer 安裝該擴(kuò)展包:
composer require barryvdh/laravel-debugbar
這個(gè)下載的是最新版本,支持Laravel5.5,Laravel5.5以下版本可使用2.4以下版本:
composer require barryvdh/laravel-debugbar:~2.4
安裝完成后,在 config/app.php 中注冊(cè)服務(wù)提供者到 providers 數(shù)組。
注冊(cè)如下服務(wù)提供者:
Barryvdh\Debugbar\ServiceProvider::class,
如果你想使用門面,在配置文件 config/app.php 中添加如下門面別名到 aliases 數(shù)組:
'Debugbar' => Barryvdh\Debugbar\Facade::class,
將debugbar配置文件提取到 config 目錄下:
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"
如果配置文件中 debug 設(shè)置為 true 的話,Debugbar 分析器默認(rèn)是啟用的,如果你想要關(guān)閉該分析器,在配置文件 config/debugbar.php 中設(shè)置 enabled 為 false 即可。
3、使用
現(xiàn)在你可以使用 Debugbar 門面添加 PSR-3 級(jí)別消息:
Debugbar::info($object);
Debugbar::error('Error!');
Debugbar::warning('Watch out…');
Debugbar::addMessage('Another message', 'mylabel');
還可以設(shè)置開始/中止時(shí)間:
Debugbar::startMeasure('render','Time for rendering');
Debugbar::stopMeasure('render');
Debugbar::addMeasure('now', LARAVEL_START, microtime(true));
Debugbar::measure('My long operation', function() {
// Do something…
});
或者記錄異常:
try {
throw new Exception('foobar');
} catch (Exception $e) {
Debugbar::addException($e);
}
此外還有輔助函數(shù)實(shí)現(xiàn)上述調(diào)用:
// All arguments will be dumped as a debug message
debug($var1, $someString, $intValue, $object);
start_measure('render','Time for rendering');
stop_measure('render');
add_measure('now', LARAVEL_START, microtime(true));
measure('My long operation', function() {
// Do something…
});
如果你想要添加自己的數(shù)據(jù)收集器(DataCollector),可以通過(guò)容器或門面實(shí)現(xiàn):
Debugbar::addCollector(new DebugBar\DataCollector\MessagesCollector('my_messages'));
如果你想要在運(yùn)行時(shí)開啟/關(guān)閉 Debugbar,可以通過(guò)如下方式:
\Debugbar::enable();
\Debugbar::disable();