Monolog是PHP中基于PSR-3标准的主流日志库，通过Composer安装后可轻松实现日志记录。使用Logger类创建实例并添加Handler（如StreamHandler写入文件、NativeMailerHandler邮件报警）来管理不同级别（debug、info、error等）日志输出，支持多处理器同时处理。可通过Formatter自定义日志格式，并结合上下文传入额外数据。建议在项目中封装为单例或使用依赖注入，合理配置日志轮转与报警机制以提升系统可观测性。
在PHP开发中，良好的日志记录机制对调试、监控和排查问题至关重要。直接使用echo或var_dump不利于生产环境管理。Monolog 是 PHP 社区中最流行的日志库之一，它基于 PSR-3 日志接口标准，提供灵活且强大的日志处理能力。
安装 Monolog
通过 Composer 安装 Monolog 非常简单：
composer require monolog/monolog安装完成后，Composer 会自动加载类文件，你可以在项目中直接使用。
基本使用：创建日志记录器
Monolog 的核心是 Logger 类。你需要先创建一个 Logger 实例，并为其添加处理器（Handler）来决定日志的输出方式。
立即学习“PHP免费学习笔记（深入）”；
示例：将日志写入文件
use Monolog\Logger;use Monolog\Handler\StreamHandler;
// 创建日志实例
$log = new Logger('name');
// 添加处理器：将日志写入文件
$log->pushHandler(new StreamHandler(__DIR__ . '/logs/app.log', Logger::DEBUG));
// 记录不同级别的日志
$log->info('用户登录成功', ['user_id' => 123]);
$log->error('数据库连接失败', ['exception' => $e]);
$log->debug('调试信息：变量值', ['data' => $data]);
上述代码中，Logger::DEBUG 表示处理器会记录 DEBUG 及以上级别的日志（如 info、error）。Monolog 支持多种日志级别：debug、info、notice、warning、error、critical、alert、emergency。
使用多种处理器实现灵活输出
Monolog 的强大之处在于支持多个处理器，可以同时将日志输出到不同位置。
常见处理器包括：
- StreamHandler：写入文件或 PHP 流
- RotatingFileHandler：按日期轮转日志文件
- NativeMailerHandler：通过邮件发送错误日志
- RedisHandler：写入 Redis 队列
- SlackWebhookHandler：发送消息到 Slack
- SyslogHandler：写入系统日志
示例：同时记录文件并邮件报警严重错误
use Monolog\Handler\RotatingFileHandler;use Monolog\Handler\NativeMailerHandler;
$log = new Logger('app');
// 按天轮转日志文件，保留7天
$log->pushHandler(new RotatingFileHandler(__DIR__ . '/logs/app.log', 7, Logger::DEBUG));
// 仅 error 级别以上发送邮件
$log->pushHandler(new NativeMailerHandler(
'admin@example.com',
'【系统警报】发生严重错误',
'dev@example.com',
Logger::ERROR
));
自定义日志格式与上下文
你可以通过 Formatter 自定义日志输出格式。默认情况下，Monolog 使用 LineFormatter 输出可读性良好的文本。
示例：自定义格式
use Monolog\Formatter\LineFormatter;use Monolog\Handler\StreamHandler;
$handler = new StreamHandler(__DIR__ . '/logs/custom.log', Logger::INFO);
$formatter = new LineFormatter("[%datetime%] %level_name%: %message% %context% %extra%\n");
$handler->setFormatter($formatter);
$log = new Logger('custom');
$log->pushHandler($handler);
$log->warning('资源不足', ['memory_usage' => '85%']);
上下文（context）参数允许你传入数组数据，在记录异常时尤其有用。
集成到项目中的建议
在实际项目中，建议将 Logger 封装为单例或通过依赖注入容器管理。例如在 Laravel 中已内置 Monolog，可通过 Log 门面直接使用。
自定义封装示例：
class LogManager {private static $instance = null;
public static function getInstance() {
if (null === self::$instance) {
self::$instance = new Logger('app');
self::$instance->pushHandler(new StreamHandler(__DIR__ . '/logs/app.log', Logger::INFO));
}
return self::$instance;
}
}
// 使用
LogManager::getInstance()->error('出错了');
基本上就这些。Monolog 的设计简洁而扩展性强，合理配置后能有效提升应用的可观测性。不复杂但容易忽略的是处理器的级别控制和日志轮转策略，建议根据项目规模设置合适的保留周期和报警机制。
