frankenphp 不提供 frankenphp_log 函数，结构化日志须用 error_log() + json_encode() 输出单行 json 到 stdout/stderr；caddy 0.19+ 可通过 caddy_log_output=stdout 启用 json 访问日志，时间字段需统一为 date('c') 格式。
frankenphp_log 不是 FrankenPHP 提供的函数或内置日志接口——它根本不存在。
你搜到的 frankenphp_log 很可能是混淆了命名、误读文档，或是某第三方封装库的自定义函数。FrankenPHP 官方代码、Caddy 集成层、PHP SAPI 层均没有声明或导出名为 frankenphp_log 的函数。
所有结构化日志必须通过标准 PHP 机制主动输出，且需严格匹配采集工具的解析要求。
怎么让 FrankenPHP 应用输出结构化 JSON 日志（到 stdout/stderr）
FrankenPHP 不拦截或重写 PHP 的日志输出函数，所以你要用的是原生 error_log()，配合 json_encode() 构造单行 JSON。
- ✅ 正确做法：用
error_log()写 stderr（推荐）或 stdout - ❌ 错误做法：期待
frankenphp_log()自动格式化、自动发往采集器、或替代error_log()
error_log() 的第二个参数决定输出目标：
-
0→ stdout（Docker / systemd 下可被直接捕获） -
4→ stderr（更符合“错误/事件日志”语义，Filebeat 默认优先抓 stderr）
示例：
$log = [
'level' => 'info',
'message' => 'user logged in',
'timestamp' => (new DateTime())->format('c'),
'context' => ['uid' => 123, 'ip' => $_SERVER['REMOTE_ADDR'] ?? 'unknown']
];
error_log(json_encode($log, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES), 4);
注意：
- 每行必须是完整、合法、无换行的 JSON 对象（不能缩进，不能多行，不能嵌套 JSON 字符串）
- 不要传二进制数据（如 raw image）、未过滤的
$_POST或资源句柄（curl_init()返回值），json_encode()会失败或静默丢弃 - 在 worker 模式下，
date('c')可能因协程时钟漂移不准，改用(new DateTime())->format('c')更可靠
为什么不能依赖 php.ini 的 error_log=xxx.log 做结构化日志
- 单文件交付时，你无法控制客户机器上的
php.ini - 文件路径权限常出问题（
www-data写不了/var/log/myapp/） - 多进程并发写同一文件会导致日志错乱（无原子写、无锁）
- Filebeat / Fluent Bit 无法直接 tail 一个被轮转切割中的文件（
.log.1,.log.2）而保持顺序
所以：结构化日志只走 stdout/stderr；业务日志文件（如 Laravel 的 storage/logs/）仅用于调试回溯，不接入采集链路。
Caddy 访问日志怎么也变 JSON（和 PHP 日志对齐）
FrankenPHP 0.19+ 支持环境变量 CADDY_LOG_OUTPUT=stdout，启用后 Caddy 会把 access log 和 server error log 都以 JSON 行格式输出到 stdout：
- 启动容器时加：
-e CADDY_LOG_OUTPUT=stdout - 确保不是旧版（
frankenphp version输出 ≥ 0.19） - 输出样例：
{"level":"info","msg":"handled request","status":200,"method":"GET","request_id":"abc123"}
⚠️ 这不会影响你 PHP 代码里的 error_log() —— 它们是两条独立日志流，靠采集器（如 Filebeat）合并解析字段。
最常被忽略的一点：时间字段格式不统一。Caddy 用 time 字段（ISO8601），而你自己打的日志如果用 microtime(true) 或 time()，Logstash 就没法做统一时间排序或告警。务必全部统一为 (new DateTime())->format('c') 或 date('c')。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
