Laravel中实现自定义Logger类分文件记录日志的方法咨询

最优实现思路：配置专属日志通道 + 封装静态调用类 #

Laravel的日志系统本身支持多通道配置，直接利用官方规范实现，比每次手动构建Logger实例更高效、更贴合框架设计。

步骤1：在日志配置文件中添加自定义通道

打开config/logging.php，在channels数组里添加对应业务的日志通道：

'channels' => [
    // 保留原有的stack、single等默认通道...

    'user' => [
        'driver' => 'single',
        'path' => storage_path('logs/user_log.php'),
        'level' => env('LOG_LEVEL', 'debug'),
        'replace_placeholders' => true,
    ],

    'car' => [
        'driver' => 'single',
        'path' => storage_path('logs/car_log.php'),
        'level' => env('LOG_LEVEL', 'debug'),
        'replace_placeholders' => true,
    ],
],

步骤2：封装业务专属日志类

创建对应业务的日志类，直接复用Laravel日志门面指定通道，避免重复代码：

UserLogger类（app/Logging/UserLogger.php）：

namespace App\Logging;

use Illuminate\Support\Facades\Log;

class UserLogger
{
    public static function info(string $message, array $context = [])
    {
        Log::channel('user')->info($message, $context);
    }

    public static function error(string $message, array $context = [])
    {
        Log::channel('user')->error($message, $context);
    }

    // 按需添加其他日志级别方法：debug、warning、notice等
    public static function debug(string $message, array $context = [])
    {
        Log::channel('user')->debug($message, $context);
    }
}

CarLogger类（app/Logging/CarLogger.php）：

namespace App\Logging;

use Illuminate\Support\Facades\Log;

class CarLogger
{
    public static function info(string $message, array $context = [])
    {
        Log::channel('car')->info($message, $context);
    }

    public static function error(string $message, array $context = [])
    {
        Log::channel('car')->error($message, $context);
    }
}

步骤3：业务代码中直接调用

在UserService或CarService里直接调用对应日志类：

// UserService.php
use App\Logging\UserLogger;

class UserService
{
    public function someMethod()
    {
        UserLogger::info('用户执行了XX操作', ['user_id' => 123]);
    }
}

用抽象基类简化重复代码 #

如果业务日志类较多，不想重复编写日志级别方法，可以用抽象基类封装通用逻辑：

抽象基类（app/Logging/AbstractLogger.php）：

namespace App\Logging;

use Illuminate\Support\Facades\Log;

abstract class AbstractLogger
{
    // 子类必须实现该方法，返回对应的日志通道名
    protected abstract static function getChannel(): string;

    public static function info(string $message, array $context = [])
    {
        Log::channel(static::getChannel())->info($message, $context);
    }

    public static function error(string $message, array $context = [])
    {
        Log::channel(static::getChannel())->error($message, $context);
    }

    public static function debug(string $message, array $context = [])
    {
        Log::channel(static::getChannel())->debug($message, $context);
    }
}

子类实现：

// UserLogger.php
namespace App\Logging;

class UserLogger extends AbstractLogger
{
    protected static function getChannel(): string
    {
        return 'user';
    }
}

// CarLogger.php
namespace App\Logging;

class CarLogger extends AbstractLogger
{
    protected static function getChannel(): string
    {
        return 'car';
    }
}

为什么原实现不够理想 #

你之前每次调用都用Log::build()创建新Logger实例的方式，会重复初始化文件句柄等资源，而Laravel的日志门面会自动管理通道的单例实例，复用已有的Logger对象，性能更优，也更符合框架的最佳实践。

内容的提问来源于stack exchange，提问作者GrayhoundButPurple