Monolog日志需通过通道、处理器、级别和格式器四层控制实现清晰、分离与安全；选用StreamHandler、RotatingFileHandler等适配场景；分通道隔离模块日志；设合理级别并用LineFormatter或JsonFormatter规范输出；生产环境须检查权限、脱敏、限频、轮转及容器日志输出。

用 Monolog 记录系统日志，关键不是“能不能写”，而是“写得清楚、分得明白、留得安全”。它不是简单地把错误塞进一个文件，而是通过通道（channel）、处理器（handler）、级别（level）和格式化器（formatter）四层控制，让日志真正可查、可控、可运维。

选对处理器，决定日志去哪

处理器是日志落地的执行者。不同场景用不同处理器：

• StreamHandler：最基础，直接写入指定文件（如 app.log），适合开发或轻量部署；
• RotatingFileHandler：按天或按大小自动轮转，保留最近 N 天/个文件，防止磁盘打满（生产环境必备）；
• SocketHandler：发往远程日志服务（如自建 syslog 或 ELK 的 Logstash），适用于多服务器统一收集；
• NativeMailerHandler：对 CRITICAL 或 EMERGENCY 级别自动发邮件告警；
• SyslogHandler：对接系统级 syslog，便于与 OS 日志体系整合。

分通道记录，避免日志混杂

一个系统有支付、用户、API、定时任务等不同模块，混在同一个日志里排查效率极低。Monolog 支持多通道隔离：

• 定义独立通道名，如 payment、api；
• 为每个通道配置专属处理器和日志路径（如 payment.log）；
• 在代码中调用 Log::channel('payment')->info('Order #123 succeeded')（Laravel）或 $this->get('monolog.logger.payment')（Symfony），日志自动分流。

设好级别和格式，兼顾可读与解析

日志不是越多越好，要靠级别过滤 + 格式统一：

• 默认最低记录 INFO，调试时可临时调至 DEBUG，生产环境建议从 WARNING 起；
• 用 LineFormatter 输出易读文本（含时间、通道、级别、消息、上下文）；
• 用 JsonFormatter 输出结构化 JSON，方便日志平台（如 Grafana Loki、ELK）自动提取字段；
• 在记录时传入上下文数组，比如 ['user_id' => 1001, 'ip' => $request->ip()]，比拼接字符串更安全、更易检索。

生产环境必须注意的几件事

上线前这几项不检查，日志可能白记：

• 确保日志目录存在且 Web 进程有写权限（常见问题：Permission denied）；
• 敏感信息如密码、token、银行卡号、密钥，禁止写入日志（可借助 Processor 自动脱敏）；
• 避免在循环中高频打日志（如每秒数百次 info()），可用 BufferHandler 缓冲后批量写入；
• 设置 max_files 和 filename_format，防止日志无限增长；
• 若用容器部署，日志应输出到 stdout/stderr，由容器平台统一采集，而非写宿主机文件。