如何在PHP日志类中无需多条件判断调用对应Handler处理日志事件

我正在学习编写自定义PHP日志类，该类包含可将日志写入数据库、文件或输出到屏幕的Handler。我的文件夹结构如下：

Logging
- Handlers
  - File.php
  - Database.php
  - Screen.php
- Logger.php

我的Logger.php类代码如下：

class Logger {
    private $handler = null;

    public function error(string $message, array $context = [])
    {
        return $this->logEvent($message, $context, 'Error');
    }

    public function handler($handler)
    {
         if (! $handler) {
              $handler = 'Screen';
         }

         $this->handler = $handler;
         return $this;
    }

    public function logEvent($message, $context, $level)
    {
        // Build the log entry into an array
        $entry = [
            'level' => $level,
            'message' => $message,
            'context' => $context
        ];

        // Call the correct handler and provide the $entry
        

    }

}

文件Handler File.php的代码如下：

class File
{
    public function init()
    {
        $fp = fopen();
        ....
        fclose($fp);
    }
}

我的try/catch代码块如下：

try {
    ....
} catch (Exception $exception) {
    $logger = new Logger();
    $logger->handler('File');
    $logger->error('Something bad happened.');
}

请问如何在Logger.php中触发File.php处理日志，且无需通过多个if/else语句判断每个Handler？

要避免用冗余的if/else判断Handler类型，推荐采用面向接口编程+动态类实例化的方案，具体步骤如下：

1. 定义统一的Handler接口 #

在Handlers目录下创建HandlerInterface.php，规范所有Handler必须实现的方法：

<?php
interface HandlerInterface {
    // 定义处理日志条目的统一方法
    public function handle(array $entry);
}

2. 改造现有Handler类 #

让每个Handler都实现上述接口，以File.php为例：

<?php
class File implements HandlerInterface {
    public function handle(array $entry) {
        // 实现日志写入文件的逻辑，示例：
        $logContent = sprintf("[%s] [%s] %s\n", 
            date('Y-m-d H:i:s'), 
            $entry['level'], 
            $entry['message']
        );
        // 这里可以补充文件路径配置、权限检查等逻辑
        file_put_contents('./app.log', $logContent, FILE_APPEND);
    }
}

同理，Database.php和Screen.php也需要实现HandlerInterface的handle方法，各自完成对应的日志输出逻辑。

3. 修改Logger类实现动态调用 #

调整Logger.php的代码，实现动态实例化Handler并调用统一方法：

<?php
// 先引入接口文件（如果用自动加载则无需手动引入）
require_once './Handlers/HandlerInterface.php';

class Logger {
    private $handler;

    public function error(string $message, array $context = [])
    {
        return $this->logEvent($message, $context, 'Error');
    }

    public function handler($handlerName)
    {
        // 默认使用Screen Handler
        $handlerName = $handlerName ?: 'Screen';
        // 拼接完整类名（如果有命名空间，需补充命名空间前缀）
        $className = $handlerName;
        
        // 验证Handler的合法性
        if (!class_exists($className)) {
            throw new InvalidArgumentException("Handler {$handlerName} does not exist");
        }
        if (!is_subclass_of($className, HandlerInterface::class)) {
            throw new InvalidArgumentException("Handler {$handlerName} must implement HandlerInterface");
        }

        // 动态实例化Handler
        $this->handler = new $className();
        return $this;
    }

    public function logEvent($message, $context, $level)
    {
        $entry = [
            'level' => $level,
            'message' => $message,
            'context' => $context
        ];

        // 调用Handler的统一处理方法
        if ($this->handler instanceof HandlerInterface) {
            $this->handler->handle($entry);
        }
    }
}

4. 原有调用逻辑无需修改 #

你的try/catch代码可以保持不变，依然正常使用：

try {
    // 业务逻辑代码
} catch (Exception $exception) {
    $logger = new Logger();
    $logger->handler('File')->error('Something bad happened.');
}

方案优势 #

• 彻底摆脱if/else判断：通过动态类实例化直接创建Handler对象
• 扩展性强：新增Handler只需实现HandlerInterface接口，无需修改Logger核心代码
• 职责清晰：Logger负责构建日志条目，Handler负责具体输出逻辑，符合单一职责原则

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