FrankenPHP日志脱敏必须在PHP应用层完成，因Caddy和FrankenPHP自身不提供字段级过滤能力；所有业务日志需经sanitize_log_context()等函数预处理敏感字段后，再通过error_log(json_encode(...), 0)输出单行JSON至stdout。
FrankenPHP 日志脱敏必须在 PHP 应用层做，不能依赖 Caddy 或 FrankenPHP 自身
FrankenPHP 本身不处理日志内容，它的 access.log 和 error.log 由底层 Caddy 直接写入文件，Caddy 不提供字段级过滤或脱敏能力。你看到的任何“日志里有手机号/身份证”现象，99% 来自 PHP 应用调用 error_log()、var_dump()、print_r() 或框架 logger（如 Monolog）输出的调试信息——这些才是脱敏主战场。
常见错误现象：在 Caddyfile 的 log 指令里加正则替换、用 nginx-style 的 map 模块过滤、甚至试图 patch FrankenPHP 二进制——全无效，因为这些路径根本接触不到 PHP 输出的业务日志内容。
- 所有业务相关日志（订单创建、用户登录、支付回调）必须走 PHP 层输出，例如
error_log(json_encode($logData), 0) - 禁止在控制器或服务中直接
Log::info('order paid', $order->toArray())—— 这等于把未清洗的原始数据塞进日志流 - 如果用了 SeasLog，确保调用
SeasLog::info()前已对$content参数做过脱敏，而不是指望SeasLog::setDatetimeFormat()之类配置项
用 error_log() + 自定义脱敏函数输出单行 JSON 是最可靠路径
FrankenPHP 容器或 systemd 模式下，stdout 是结构化日志采集的唯一可信通道。要让 Logstash、SLS 或 CLS 正确提取字段，每条日志必须是单行合法 JSON，且敏感字段已在序列化前被处理。
关键点不是“怎么打日志”，而是“打什么进去”。脱敏动作必须发生在 json_encode() 之前，而非之后用正则扫字符串——后者会破坏 JSON 结构，导致解析失败。
立即学习“PHP免费学习笔记（深入）”；
- 封装一个
sanitize_log_context()函数，接收array $context，只对白名单 key（如"phone"、"id_card"、"bank_card"）做掩码，其他字段原样透传 - 调用时确保：
error_log(json_encode([ 'timestamp' => (new DateTime())->format('c'), 'level' => 'info', 'message' => 'order created', 'context' => sanitize_log_context($rawOrderData) ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES), 0) - 绝对避免在
context中传入$_POST全量、资源句柄或未克隆的对象——json_encode()会报错或卡死
worker 模式下注意时间戳和上下文隔离问题
FrankenPHP 的 worker 模式基于协程，date() 在高并发下可能返回错误时间戳（因协程共享进程时间缓存），且 $_SERVER 等超全局变量在 worker 生命周期内不会自动刷新。
这意味着如果你在日志里直接写 $_SERVER['REMOTE_ADDR'] 或 date('c')，可能拿到上一个请求的 IP 或过期时间。这不是脱敏问题，但会让脱敏后的日志失去可追溯性。
- 一律改用
(new DateTime())->format('c')获取当前 ISO8601 时间戳 - 从请求上下文显式提取必要字段，例如在中间件中把
$_SERVER['REMOTE_ADDR']提前存入$requestContext['client_ip']，再传给日志函数 - 不要在
sanitize_log_context()内部访问$_POST或$_GET——这些应由上层统一解包并传入，保证脱敏逻辑无副作用
Logstash / SLS 必须开启 JSON 解析且禁用换行拼接
即使 PHP 输出了完美 JSON，采集端配置错误仍会导致字段丢失或解析失败。典型表现是 Kibana 里只有 message 字段，level、timestamp 全为空。
根本原因是采集器把整行当作文本切分，没触发 JSON 解析逻辑。这和日志内容无关，纯属配置疏漏。
- Logstash：filter 段必须有
json { source => "message" }，且 input 插件（如file或beats）不能启用multiline或codec => multiline - 阿里云 SLS：日志主题需选择“JSON 格式”，并勾选“自动提取字段”，不可选“分隔符”或“正则”模式
- 腾讯云 CLS：接入配置里“日志格式”选“JSON”，关闭“合并多行日志”开关
最容易被忽略的是：worker 模式下多个协程可能并发写 stdout，若没加锁或缓冲，偶尔会出现两行 JSON 被粘连成一行（如 {"a":1}{"b":2}），这种非法 JSON 会被采集器静默丢弃。上线前务必用 stdbuf -oL php your_script.php | head -n 100 抽样验证输出是否严格单行。
