使用 Monolog 可统一 php 日志管理：一、通过 composer 安装并引入自动加载；二、用 streamHandler 将日志写入文件；三、配置多个 处理器 按级别分离日志；四、集成 NativeMailerHandler 实现错误邮件通知；五、通过 LineFormatter 自定义日志输出格式。
如果您在开发 PHP 应用时需要统一管理和存储日志信息，可能会遇到不同环境下的日志格式不一致或难以扩展的问题。使用专业的日志库可以有效解决这些痛点。以下是几种通过 Monolog 实现日志管理的具体方法：
一、安装与引入 Monolog
Monolog 是 PHP 社区广泛使用的日志处理库，遵循 PSR- 3 日志 接口 标准，支持多种日志 处理器 和格式化器。通过 Composer 可轻松集成到项目中。
1、打开终端并进入项目根目录，执行以下命令安装 Monolog：composer require monolog/monolog。
2、在 PHP 文件中使用 require_once 'vendor/autoload.php'; 引入自动加载文件，即可开始使用 Monolog 类。
立即学习“PHP 免费学习笔记（深入）”；
二、配置基础文件日志记录
将日志输出到本地文件是最常见的需求之一，适用于调试和生产环境的错误追踪。通过 StreamHandler 可将日志写入指定文件。
1、创建 Logger 实例并命名，例如：$logger = new MonologLogger('my_app');。
2、添加 StreamHandler 处理器，指向目标日志文件路径：$logger->pushHandler(new MonologHandlerStreamHandler('logs/app.log', MonologLogger::DEBUG));。
3、调用日志方法记录信息，如：$logger->info('用户登录成功', ['user_id' => 123]);，该条目将被写入app.log 文件。
三、使用多个处理器处理不同级别日志
为了更高效地管理日志，可以根据日志严重程度（如Error、warning）将其发送到不同的目的地，比如错误日志单独保存以便快速排查问题。
1、为错误级别日志创建专用处理器：$errorHandler = new MonologHandlerStreamHandler('logs/error.log', MonologLogger::ERROR);。
2、为调试级别日志创建另一处理器：$debugHandler = new MonologHandlerStreamHandler('logs/debug.log', MonologLogger::DEBUG);。
3、将两个处理器分别加入 Logger 实例：$logger->pushHandler($errorHandler); $logger->pushHandler($debugHandler);。
4、分别记录不同级别的日志，系统会自动按级别 路由 到对应文件。
四、集成邮件通知处理器
当发生严重错误时，及时通知开发者至关重要。NativeMailerHandler 可以在触发错误日志时自动发送电子邮件提醒。
1、创建邮件处理器实例，设置收件人和发件人信息：$mailer = new MonologHandlerNativeMailerHandler('admin@example.com', '紧急错误告警', 'errors@example.com');。
2、限定仅在 ERROR 及以上级别触发邮件：$logger->pushHandler($mailer);。
3、测试发送一封错误日志：$logger->error('数据库 连接失败', ['exception' => $e]);，确认邮件是否收到。
五、自定义日志 格式化输出
默认的日志格式可能不符合审计或分析 工具 的要求，可通过设置 Formatter 来自定义每条日志的结构。
1、选择合适的格式化器，例如 LineFormatter：$formatter = new MonologFormatterLineFormatter("%datetime% %level_name%: %message% %context%n");。
2、将格式化器绑定到某个处理器：$streamHandler->setFormatter($formatter);。
3、重新记录一条日志，观察输出格式是否已按设定变更。
