edujugon/laravel-log

为Laravel提供简单的日志记录API。

1.2.0 2018-04-11 21:12 UTC

This package is auto-updated.

Last update: 2024-09-19 10:26:00 UTC


README

为Laravel提供简单的日志记录API。

安装

在控制台输入
composer require edujugon/laravel-log

Laravel 5.5或更高版本?

那么您无需注册或添加别名,此包使用Package Auto-Discovery功能,并通过Composer安装后应立即可用。

(Laravel < 5.5) 通过将其添加到服务提供者数组中注册日志服务。

'providers' => array(
        ...
        Edujugon\Log\Providers\LogServiceProvider::class
    )
将包的配置文件发布到应用程序的配置目录。
php artisan vendor:publish --provider="Edujugon\Log\Providers\LogServiceProvider" --tag="config"

上述命令将在您的Laravel应用程序配置文件夹下生成一个名为log.php的新文件。

配置

使用您的数据更新log.php文件。

API列表

路径

path方法设置创建/存储日志文件的路径。

语法

Edujugon\Log\Log object path($path)

级别

level方法设置日志级别。

可用级别:紧急、警报、关键、错误、警告、通知、信息和调试。

语法

Edujugon\Log\Log object level($level)

标题

title方法设置要写入的标题或主要消息。

语法

Edujugon\Log\Log object title($title)

行号

line方法在标题下方设置一行。

注意,您可以多次调用此方法,以写入所需数量的行。

语法

Edujugon\Log\Log object line($line)

logname

name方法设置日志记录器名称。

默认名称为 "my-logger"

语法

Edujugon\Log\Log object name($loggerName)

文件名

fileName方法设置文件名。

请记住不要包含任何扩展名。

语法

Edujugon\Log\Log object fileName($name)

天数

days方法设置在服务器上保留的天数。

语法

Edujugon\Log\Log object days($days)

值 "0" 表示没有天数限制

不包含时间戳

withoutDateTime方法从日志行中排除时间戳。

语法

Edujugon\Log\Log object withoutDateTime()

不包含日志器详情

withoutLoggerDetails方法从日志行中排除日志器详情。

语法

Edujugon\Log\Log object withoutLoggerDetails()

排除日志器名称和级别

写入

write方法写入日志文件。

语法

boolean write()

使用示例

$log = new Log();
$log->fileName('my-personal-log')
    ->title('Stored new record')
    ->line('the record id is 3')
    ->line('Stored by John')
    ->line('This is antoher line')
    ->days(3)
    ->write();

也可以通过其外观(Facade)来实现

Log::fileName('my-personal-log')
    ->title('Stored new record')
    ->line('the record id is 3')
    ->line('Stored by John')
    ->line('This is antoher line')
    ->write();