告别手动日志管理：如何使用Composer和PEARLog框架构建高效日志系统

<code class="bash">composer require pear/log</code>

<code class="php">require 'vendor/autoload.php';</code>

<pre class="brush:php;toolbar:false;">use Log; // 引入Log类

// 使用单例模式创建一个文件日志处理器
// 第一个参数 'file' 指定处理器类型
// 第二个参数 'app.log' 指定日志文件名
// 第三个参数 'MyApp' 是日志标识符
// 第四个参数是配置数组，这里设置了日志文件的权限和时间格式
$conf = ['mode' => 0644, 'timeFormat' => '%X %x'];
$logger = Log::singleton('file', 'app.log', 'MyApp', $conf, PEAR_LOG_DEBUG);

// 记录不同级别的日志
$logger->debug('这是一个调试信息，只在开发环境有用。');
$logger->info('用户 "Alice" 成功登录。');
$logger->notice('数据库连接池即将耗尽。');
$logger->warning('API 请求返回了非预期数据。');
$logger->err('无法连接到第三方服务。');
$logger->crit('系统关键组件故障！');
$logger->alert('服务器内存使用率超过90%！');
$logger->emerg('系统崩溃，立即停止！');

// 也可以使用通用的 log 方法，并手动指定优先级
$logger->log('另一个信息日志', PEAR_LOG_INFO);

<pre class="brush:php;toolbar:false;">// ... 假设 $logger 已经存在
$mailConf = ['subject' => '重要系统错误警报'];
$mailLogger = Log::singleton('mail', 'admin@example.com', 'MyAppAlerts', $mailConf, PEAR_LOG_CRIT);

// 记录一个关键错误，它将通过邮件发送
$mailLogger->crit('数据库连接失败，请立即检查！');

<pre class="brush:php;toolbar:false;">// 在开发环境，记录所有信息
$devLogger = Log::singleton('file', 'dev.log', 'DevApp', [], PEAR_LOG_DEBUG);
$devLogger->debug('调试信息'); // 会被记录

// 在生产环境，只记录警告及以上级别
$prodLogger = Log::singleton('file', 'prod.log', 'ProdApp', [], PEAR_LOG_WARNING);
$prodLogger->debug('调试信息'); // 不会被记录
$prodLogger->warning('这是一个警告'); // 会被记录

// 也可以通过 setMask 动态调整
$prodLogger->setMask(Log::MAX(PEAR_LOG_ERR)); // 只记录错误及以上级别
$prodLogger->info('普通信息'); // 不会被记录
$prodLogger->err('致命错误'); // 会被记录

<pre class="brush:php;toolbar:false;">// 创建两个独立的日志处理器
$fileLogger = Log::factory('file', 'composite.log', 'CompositeApp');
$consoleLogger = Log::factory('console', '', 'CompositeApp');

// 创建一个复合处理器
$compositeLogger = Log::singleton('composite');
$compositeLogger->addChild($fileLogger);
$compositeLogger->addChild($consoleLogger);

// 使用复合处理器记录日志，它会同时输出到文件和控制台
$compositeLogger->info('这条日志会同时出现在文件和控制台。');
$compositeLogger->err('一个严重错误，同时记录到多处。');

<pre class="brush:php;toolbar:false;">// 假设 $logger 已经是一个配置好的 Log 实例
set_error_handler(function ($code, $message, $file, $line) use ($logger) {
    // 将 PHP 错误映射到 Log 优先级
    $priority = PEAR_LOG_INFO;
    switch ($code) {
        case E_WARNING:
        case E_USER_WARNING: $priority = PEAR_LOG_WARNING; break;
        case E_NOTICE:
        case E_USER_NOTICE: $priority = PEAR_LOG_NOTICE; break;
        case E_ERROR:
        case E_USER_ERROR: $priority = PEAR_LOG_ERR; break;
    }
    $logger->log("PHP Error: {$message} in {$file} at line {$line}", $priority);
});

set_exception_handler(function ($exception) use ($logger) {
    $logger->log("Uncaught Exception: {$exception->getMessage()} in {$exception->getFile()} at line {$exception->getLine()}", PEAR_LOG_ALERT);
});

// 触发一个 PHP 警告
trigger_error('这是一个自定义的PHP警告', E_USER_WARNING);

// 触发一个未捕获的异常
// throw new Exception('一个未捕获的致命异常！');