README

关于

Laravel的日志请求与调试

安装

使用composer安装此包

composer require songshenzong/log

Laravel

发布配置文件。如果不这样做，当你执行config:cache Artisan命令时，它们可能无法正确序列化。

php artisan vendor:publish --provider="Songshenzong\Log\ServiceProvider"

中间件

如果你使用dingo/api路由，确保你在config/api.php中加载中间件。

'middleware' => [
    'Songshenzong\Log\Middleware',
],

默认情况下，所有环境都启用了分析器，你可以在配置中覆盖它（songshenzong-log.env）。

使用发布命令将包配置复制到你的本地配置

php artisan vendor:publish --provider="Songshenzong\Log\ServiceProvider"

让我们开始

http://your.domain/songshenzong

使用

你现在可以使用外观（当添加时）通过PSR-3级别（调试、信息、注意、警告、错误、关键、警报、紧急）添加消息

Songshenzong::info($object);
Songshenzong::error('Error!');
Songshenzong::warning('Watch out…');
Songshenzong::addMessage('Another message', 'myLabel');

并开始/停止计时

Songshenzong::startMeasure('render','Time for rendering');
Songshenzong::stopMeasure('render');
Songshenzong::addMeasure('now', LARAVEL_START, microtime(true));
Songshenzong::measure('My long operation', function() {
    // Do something…
});

或记录异常

try {
    throw new Exception('foobar');
} catch (Exception $e) {
    songshenzongLog() -> addThrowable($e);
}

还有针对最常见调用的辅助函数

// 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…
});

如果你愿意，你可以通过容器或外观添加自己的数据收集器

songshenzongLog() -> addCollector(new Songshenzong\Log\DataCollector\MessagesCollector('my_messages'));
//Or via the App container:
$songshenzong_log = App::make('SongshenzongLog');
$songshenzong_log->addCollector(new Songshenzong\Log\DataCollector\MessagesCollector('my_messages'));

注意：如果不使用自动注入，将禁用请求信息，因为那是添加在响应之后的。你可以在配置中将默认_request数据收集器作为替代方案添加。

运行时启用/禁用

你可以在运行时启用或禁用Songshenzong。

songshenzongLog() -> enable();
songshenzongLog() -> disable();

注意。一旦启用，收集器将被添加（可能会产生额外的开销），所以如果你想在生产中使用Songshenzong，请在配置中禁用，只在需要时启用。

文档

请参阅我们的详细Wiki文档获取更多信息。

支持

对于你可能在Wiki中找不到的答案，请避免提交问题。请在Songshenzong.com上自由寻求支持。

许可证

此包根据BSD 3-Clause许可证授权。