README

此包提供了一个 artisan 命令来跟踪应用程序日志。它支持在本地机器上的每日和单个日志。

要跟踪日志，可以使用此命令

php artisan tail

它还可以跟踪其他环境中的日志

php artisan tail production

支持我们

我们投入了大量资源来创建一流的开放源代码包。您可以通过购买我们的付费产品之一来支持我们。

我们非常感谢您从家乡寄来明信片，说明您正在使用我们的哪些包。您可以在我们的联系页面上找到我们的地址。我们将在我们的虚拟明信片墙上发布所有收到的明信片。

安装

您可以通过 composer 安装此包

composer require spatie/laravel-tail

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="Spatie\Tail\TailServiceProvider"

这是将在 config/tail.php 中发布的文件内容

return [
    'production' => [
        
        /*
         * The host that contains your logs.
         */
        'host' => env('TAIL_HOST_PRODUCTION', ''),

        /*
         * The user to be used to SSH to the server.
         */
        'user' => env('TAIL_USER_PRODUCTION', ''),

        /*
         * The path to the directory that contains your logs.
         */
        'log_directory' => env('TAIL_LOG_DIRECTORY_PRODUCTION', ''),

        /*
         * The filename of the log file that you want to tail.
         * Leave null to let the package automatically select the file.
         */
        'file' => env('TAIL_LOG_FILE_PRODUCTION', null),
        
    ],
];

用法

要跟踪本地日志，可以使用此命令

php artisan tail

您可以使用 lines 选项开始显示日志中的最后几行。

php artisan tail --lines=50

默认情况下，将使用目录中最新的修改文件。您可以使用 file 选项指定要跟踪的文件。

php artisan tail --file="other-file.log"

您还可以在每次日志条目后完全清除输出缓冲区。如果您只想在调试时查看最后一条日志条目，这可能很有用。

php artisan tail --clear

如果您想过滤日志以仅返回某些关键字，则还可以使用 grep 功能。

php artisan tail --grep="only display lines that contain this string"

跟踪远程日志

要跟踪远程日志，您必须首先在 tail 配置文件中为环境的 host、user、log_directory 和 file 键指定值。

然后您可以像这样跟踪该环境的日志

php artisan tail production

您还可以使用上面描述的 --clear、--file 和 --lines 选项。

更新日志

请参阅更新日志了解最近更改的详细信息。

贡献

请参阅贡献指南以获取详细信息。

安全

如果您发现与安全相关的错误，请通过security@spatie.be 发送电子邮件，而不是使用问题跟踪器。

鸣谢

• Freek Van der Herten
• 所有贡献者

创建此包是因为在 Laravel 4 中存在的出色的 tail 命令在 Laravel 5 中被删除。此包中的 tail 命令与 Laravel 旧版本相当，但不包括远程跟踪功能。

许可

MIT 许可证 (MIT)。有关更多信息，请参阅许可文件。