Monolog Formatter完全清单20格式化器逐一拆解JSON、HTML、Logstash一网打尽【免费下载链接】monologSends your logs to files, sockets, inboxes, databases and various web services项目地址: https://gitcode.com/gh_mirrors/mo/monologMonolog 是 PHP 生态里最主流的日志库而Formatter日志格式化器就是它把一条日志变成「你想要的样子」的幕后功臣。本文带你逐一拆解 Monolog Formatter 的全部 20 个格式化器从最常用的 LineFormatter、JsonFormatter、HtmlFormatter到对接 Logstash、Elasticsearch、Syslog 的专属格式外加日志脱敏神器 RedactingFormatter——一文一网打尽帮你快速选对、用好每一个 Formatter。 先搞懂Formatter 到底在干什么日志在 Monolog 里是一个 LogRecord 对象它自带message、level、context、channel、datetime、extra等字段结构细节可看 doc/message-structure.md。Formatter 的职责就是把这个对象「翻译」成最终写入目标文件、邮箱、数据库、远程服务的格式——一行文本、一段 HTML、一条 JSON、一个 syslog 报文…… 一句话理解Handler 决定「日志去哪儿」Formatter 决定「日志长什么样」。两者是黄金搭档。所有格式化器都遵循同一套接口 FormatterInterface.php其中能包装别的格式化器的还实现了 WrappingFormatterInterface.php。下面按「使用场景」把它们分门别类拆开讲。 第一梯队日常最常用配任何 Handler 都行这是 90% 场景下你会打交道的几位源码都在 src/Monolog/Formatter/ 下。格式化器输出形态典型搭档LineFormatter单行文本StreamHandler写文件HtmlFormatter彩色 HTML 表格NativeMailerHandler发邮件JsonFormatter一行 JSON文件 / 消息队列SyslogFormatterRFC 5424 标准报文SyslogHandlerFluentdFormatterFluentd 协议数据SocketHandlerLineFormatter 写日志文件的事实标准。它把整条记录压成一行字符串内置默认模板[%datetime%] %channel%.%level_name%: %message% %context% %extra%见 LineFormatter.php#L26-L28。想换时间格式、想保留空 context都可在构造时调节。HtmlFormatter✉️ 把日志渲染成人类可读的 HTML 表格专为「把错误发到邮件里」设计异常堆栈也会排版清晰。JsonFormatter 一条记录 → 一行 JSON方便被脚本、ELK 等工具解析是「机器可读」的首选。SyslogFormatter 输出符合RFC 5424 / syslog规范的文件能被lnav等工具直接消费。FluentdFormatter 生成 Fluentd 日志格式常搭配 SocketHandler 使用。 第二梯队数据清洗与安全脱敏这一组不直接产出「最终格式」而是负责把对象「压平」、把敏感信息「打码」。NormalizerFormatter 把对象、资源、流等复杂类型递归归一化成字符串让记录能顺利被序列化。它是 LineFormatter、LogstashFormatter 等许多格式器的「地基」。ScalarFormatter 进一步把记录规整成纯标量string/number/bool的数组适合要求字段必须简单类型的场景。RedactingFormatter日志脱敏神器重点推荐它「包」住另一个 Formatter做三重保险按配置名如password、token、authorization打码 context/extra从输出中抹掉被#[SensitiveParameter]标记的构造参数对最终输出跑可配置的正则如内置TOKEN_PATTERN见 RedactingFormatter.php#L48-L55。 因为它是 Formatter 而非 Processor保证在所有 Processor 之后运行看到的永远是最终记录——密码、Token 很难从它眼皮底下溜走。️ 把用户密码、API Key 写进日志是常见事故。只要把它包一层new RedactingFormatter(new LineFormatter())敏感值立刻变成***。 第三梯队日志聚合 / 搜索平台专属要接入集中式日志平台这一组帮你「按平台方言」输出。格式化器对接平台特点LogstashFormatterLogstash / ELK标准 Logstash Event JSON带timestamp、host、typeElasticsearchFormatterElasticsearch为记录追加index/type键ElasticaFormatterElastica 客户端产出Elastica\Document对象GelfMessageFormatterGraylog2 (GELF)生成 GELF 消息对象MongoDBFormatterMongoDB日期转\MongoDate对象递归转数组LogstashFormatter 输出标准 Logstash 事件 JSON时间强制 ISO 8601并自动填好timestamp、version、host、type等字段见 LogstashFormatter.php#L66-L74是搭建 ELK 栈的标配。ElasticsearchFormatter / ElasticaFormatter⚙️ 分别面向原生 ES Handler 与 Elastica 客户端前者补索引/类型键后者直接产出文档对象。GelfMessageFormatter 输出 GELF 消息供 GelfHandler 发往 Graylog。MongoDBFormatter 把\DateTime转成 Mongo 能识别的\MongoDate对象递归转数组专配 MongoDBHandler。☁️ 第四梯队云服务与消息通道专属这类格式化器「只服务一位 Handler」输出对应服务商的报文格式。GoogleCloudLoggingFormatter 为 Google Cloud Logging 定制相当于「带微调的 JsonFormatter」。LogglyFormatter/LogmaticFormatter 分别生成 Loggly、Logmatic 服务的消息格式。FlowdockFormatter 把记录转成带#logs、#level、#channel标签的 Flowdock 消息注Flowdock 已停运新版本中已标记废弃新项目不建议再选它。WildfireFormatter/ChromePHPFormatter️ 生成 FirePHP / ChromePHP 调试协议报文让你在浏览器控制台里直接看到 PHP 日志。 一张表到底该选哪个 Formatter你的诉求推荐 Formatter写本地日志文件最好读LineFormatter错误发到邮箱排版美观HtmlFormatter让脚本 / 监控解析日志JsonFormatter接入 ELK / LogstashLogstashFormatter写入 ElasticsearchElasticsearchFormatter输出到 GraylogGelfMessageFormatter写 MongoDBMongoDBFormatter用浏览器控制台调试ChromePHPFormatter 日志里含密码 / TokenRedactingFormatter包一层字段必须纯标量ScalarFormatter 选型口诀先定「去哪」Handler再配「长相」Formatter只要涉及敏感数据最后再套一层 RedactingFormatter。️ 自定义 Formatter 快速上手现有 20 个都不合心意只需继承 NormalizerFormatter.php 并实现format()几十行就能造出属于自己团队的私有日志格式。完整的扩展步骤、Processor 与自定义 Handler 编写方法都收录在 doc/04-extending.md。全部格式化器的官方说明与搭配对照doc/02-handlers-formatters-processors.md日志字段结构详解doc/message-structure.md源码总目录src/Monolog/Formatter/✅ 小结Monolog 的 Formatter 家族其实非常好记——19 个开箱即用的格式化器 2 个基础接口覆盖了从「写文件、发邮件」到「上 ELK、上云、上浏览器」再到「脱敏」的全部场景。记住这条主线就不会错通用款Line / Html / Json / Syslog解决日常 90% 需求平台款Logstash / Elasticsearch / GELF / MongoDB对接集中式日志脱敏款RedactingFormatter守住安全最后一道关。选对 Formatter你的日志才真正「既看得懂又用得上」。【免费下载链接】monologSends your logs to files, sockets, inboxes, databases and various web services项目地址: https://gitcode.com/gh_mirrors/mo/monolog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考