README

Laravel 的官方驱动程序，将您的应用程序日志发送到 Logio.dev。

安装

要开始将日志发送到 Logio，请按照以下简单的安装过程操作，或阅读我们博客上发布的指南： https://logio.dev/blog/use-logio-with-laravel。

使用 Composer 安装

composer require logio-dev/laravel-driver

添加驱动程序

前往您的 config/logging.php 文件，并添加如下所示的 logio。

return [

    'channels' => [
        'logio' => [
            'driver' => 'monolog',
            'level' => env('LOG_LEVEL', 'debug'),
            'handler' => Logio\LogioHandler::class,
            'handler_with' => [
                'key' => env('LOGIO_API_KEY'),
                'maxBuffer' => env('LOGIO_MAX_BUFFER', 0),
                'endpoint' => env('LOGIO_API_ENDPOINT', 'https://api.logio.dev'),
            ],
        ],  
    ],

];

API 密钥和设置

您需要在 .env 文件中设置您的 API 密钥，您可以从 https://logio.dev 获取每个应用的 API 密钥。

LOG_CHANNEL=logio
LOGIO_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

确保您已将 LOG_CHANNEL 设置为 "logio"，如上所示。

启用异步发送

默认情况下，Logio 将同步记录日志事件，当您需要发送大量日志时，这可能会很慢。

为了解决这个问题，您可以在应用程序的 app/Http/Kernel.php 中启用 Logio\Http\Middleware\FlushBufferMiddleware，如下所示，在全局中间件组中。

<?php

namespace App\Http;

use Illuminate\Foundation\Http\Kernel as HttpKernel;

class Kernel extends HttpKernel
{
    /**
     * The application's global HTTP middleware stack.
     *
     * These middleware are run during every request to your application.
     *
     * @var array
     */
    protected $middleware = [
        // \App\Http\Middleware\TrustHosts::class,
        \App\Http\Middleware\TrustProxies::class,
        \Fruitcake\Cors\HandleCors::class,
        \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
        \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
        \App\Http\Middleware\TrimStrings::class,
        \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
        
        \Logio\Http\Middleware\FlushBufferMiddleware::class,
    ];

在内部，FlushBufferMiddleware 使用 Laravel 提供的可终止中间件，在您的应用程序响应发送后，Logio 将将所有日志以 LOGIO_MAX_BUFFER 批次异步发送。

确保您已在 .env 文件中设置 LOGIO_MAX_BUFFER，默认值为 0，这意味着一次发送一个，以下将异步发送 10 个日志批次。

LOGIO_MAX_BUFFER=10

就这样

您可以开始使用 Log 门面进行日志记录，并查看您的日志出现在 Logio.dev 中。