还记得那些年我们手动写日志的经历吗？echo、var_dump、error_log 散落在代码各处，它们或许能解决一时之需，但随着项目规模的扩大，这些“临时方案”很快就会变成一场噩梦。日志格式不统一、级别不明确、输出目的地固定，当生产环境出现问题时，你可能需要花费数小时甚至数天才能从海量的、无序的日志中找出蛛丝马迹。更糟糕的是，如果需要将日志从文件切换到数据库，或者同时输出到控制台和邮件，你可能不得不修改大量代码。这种混乱和低效，严重阻碍了开发效率和问题解决的速度。
为了解决这一痛点，我们需要一个标准化、可配置且易于扩展的日志解决方案。幸运的是，PHP 社区为我们提供了强大的工具——Composer 和 PEAR Log 框架。
引入 Composer：告别手动依赖管理
Composer 是 PHP 的一个依赖管理工具，它让项目依赖的安装、更新和管理变得轻而易举。要使用 PEAR Log 框架，我们首先需要通过 Composer 将其引入到项目中。
打开你的终端，进入项目根目录，然后执行以下命令：
composer require pear/log
Composer 会自动下载 PEAR Log 及其所有依赖，并生成 vendor/autoload.php 文件。你只需要在项目的入口文件（或任何需要使用日志的地方）引入这个文件，就可以开始使用 PEAR Log 了：
require 'vendor/autoload.php';
现在，我们已经准备好使用 PEAR Log 来革新我们的日志管理方式了！
PEAR Log 框架：构建你的日志利器
PEAR Log 是一个成熟且功能丰富的日志框架，它提供了多种日志处理器（Handler），能够将日志输出到不同的目的地，并且支持灵活的日志级别和过滤机制。
1. 统一的日志接口
PEAR Log 的核心优势在于它提供了一个统一的日志接口。无论你将日志输出到文件、数据库还是控制台，代码都保持一致。
让我们通过一个简单的例子来看看如何使用它：
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);运行这段代码后，你会在项目目录下看到一个名为 app.log 的文件，里面包含了所有记录的日志信息，并且格式统一。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
2. 多样化的日志处理器 (Handlers)
PEAR Log 提供了丰富的内置处理器，可以满足绝大多数日志需求：
-
File Handler (
file): 将日志写入到指定文件。这是最常用的一种。 -
Console Handler (
console): 将日志输出到命令行控制台，非常适合 CLI 应用或开发调试。 -
Mail Handler (
mail): 将聚合的日志事件通过邮件发送，非常适合发送关键错误或警告通知。 -
SQL Handler (
sql) / Sqlite Handler (sqlite): 将日志写入到关系型数据库，方便进行日志分析和查询。 -
Syslog Handler (
syslog): 将日志发送到系统日志服务（如 Linux 上的 Syslog），便于与操作系统级别的日志管理工具集成。 -
Error_Log Handler (
error_log): 将日志发送到 PHP 的error_log()函数。 -
Display Handler (
display): 直接将日志输出到浏览器，用于Web应用调试。
例如，如果你想将关键错误通过邮件发送给管理员：
// ... 假设 $logger 已经存在
$mailConf = ['subject' => '重要系统错误警报'];
$mailLogger = Log::singleton('mail', 'admin@example.com', 'MyAppAlerts', $mailConf, PEAR_LOG_CRIT);
// 记录一个关键错误，它将通过邮件发送
$mailLogger->crit('数据库连接失败，请立即检查！');3. 日志级别与掩码：精准控制输出
PEAR Log 定义了一套标准的日志级别（从 PEAR_LOG_EMERG 到 PEAR_LOG_DEBUG），让你能够根据事件的重要性进行分类。更强大的是，你可以使用日志级别掩码（Log Level Masks）来精确控制哪些级别的日志会被记录。
例如，在开发环境中你可能需要看到所有调试信息，但在生产环境中，你只希望记录警告（WARNING）及以上级别的日志，以减少日志量并突出重要事件。
// 在开发环境，记录所有信息
$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('致命错误'); // 会被记录4. 复合处理器：日志多路输出
PEAR Log 的复合处理器（Composite Handler）允许你同时将日志发送到多个目的地。这对于需要在多个系统（如文件、数据库和监控平台）中保留日志的场景非常有用。
// 创建两个独立的日志处理器
$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('一个严重错误，同时记录到多处。');5. 整合 PHP 错误与异常处理
PEAR Log 还能与 PHP 内置的错误和异常处理机制无缝集成，将所有 PHP 错误、警告和未捕获的异常都统一记录到你的日志系统中。
// 假设 $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('一个未捕获的致命异常！');通过这种方式，你的应用将拥有一个统一的日志入口，无论事件源自何处，都能被有效捕获和记录。
总结与实际应用效果
使用 Composer 和 PEAR Log 框架，你的日志管理将获得质的飞跃：
- 标准化与一致性：所有日志都通过统一的 API 和格式输出，告别杂乱无章的日志。
- 高度灵活性：轻松切换日志目的地（文件、数据库、邮件、控制台等），无需修改业务逻辑代码。
- 精细化控制：通过日志级别和掩码，精确控制在不同环境下记录哪些日志，有效管理日志量。
- 易于扩展：如果内置处理器不满足需求，可以轻松编写自定义处理器。
- 提升调试效率：清晰、有序的日志能让你在最短时间内定位问题，大大缩短调试周期。
- 增强系统可观测性：关键事件的日志可以实时发送邮件通知，帮助你及时发现并解决生产环境问题。
在实际项目中，我曾遇到一个复杂的异步任务系统，日志分散在多个服务和文件中，排查问题异常困难。引入 PEAR Log 后，我们将所有日志统一输出到 Elasticsearch，并通过 Kibana 进行可视化，问题定位时间从数小时缩短到数分钟，极大提升了运维效率和系统稳定性。
告别手动日志管理的低效与混乱，拥抱 Composer 和 PEAR Log 带来的便捷与强大吧！它将成为你 PHP 项目中不可或缺的利器，让你的应用更加健壮、易于维护。
