FrankenPHP默认不写日志文件，需同时配置Caddy的log指令指定access.log/error.log路径，并在PHP层用Monolog统一写业务日志到绝对路径，且必须配合系统logrotate轮转所有日志。
FrankenPHP 默认不写日志文件，必须手动配 Caddy 和 PHP 两层
FrankenPHP 单文件启动后，caddy 引擎默认把访问日志、错误日志全打到 stdout 和 stderr，不落盘；PHP 应用层（比如你的控制器、支付逻辑）也默认不记录任何业务日志。这两层日志如果不显式配置，服务一重启就全丢，客户查问题时连个 access.log 都找不到。
所以得同时做两件事：
- 在
Caddyfile里用log指令指定access.log和error.log的写入路径 - 在 PHP 代码里用
Monolog实例接管业务日志，不能依赖error_log()或框架默认日志
Caddyfile 中必须显式配置 log 指令，否则无访问/错误日志文件
caddy 不像 Nginx 那样有默认日志路径，FrankenPHP 启动的 Caddy 实例默认禁用文件日志。你得在 Caddyfile 的站点块里加 log 块，例如：
example.com {
root * /var/www/public
php_backend
log {
output file /var/log/frankenphp/access.log
format json
}
handle_errors {
log {
output file /var/log/frankenphp/error.log
format console
}
respond "Internal Error" 500
}
}注意点：
立即学习“PHP免费学习笔记（深入）”；
-
output file路径必须提前创建好目录，且www-data（或运行 FrankenPHP 的用户）有写权限 - 不要省略
log块里的output，只写log不带参数等于没开 -
handle_errors块内要单独配log，否则 5xx 错误不会进error.log
PHP 层用 Monolog 写业务日志，yansongda/pay 等 SDK 也得走同一套实例
FrankenPHP 本身不干涉 PHP 日志，但你要让 yansongda/pay、自定义订单处理、API 入口等都写到同一个日志文件，就得统一用一个 Monolog\Logger 实例。它和 caddy 的日志是完全分离的两套系统。
示例（推荐放在项目启动入口，如 public/index.php 头部）：
use Monolog\Logger;
use Monolog\Handler\RotatingFileHandler;
use Monolog\Formatter\LineFormatter;
<p>$log = new Logger('app');
$handler = new RotatingFileHandler('/var/log/frankenphp/app.log', 30, Logger::INFO);
$handler->setFormatter(new LineFormatter(
"[%datetime%] [%level_name%] %message% %context%\n",
'Y-m-d H:i:s',
true,
true
));
$log->pushHandler($handler);</p><p>// 全局可用，比如在支付回调里：
// $log->info('Pay callback received', ['order_id' => $id]);
关键细节：
-
RotatingFileHandler自带按天轮转 + 保留 30 天，比StreamHandler更适合生产 -
yansongda/pay的logger配置项可以直接传入这个$log实例，只要它实现了Psr\Log\LoggerInterface - 别把日志写到
./logs/这种相对路径——FrankenPHP 工作目录不确定，必须用绝对路径
logrotate 必须配，FrankenPHP 和 Monolog 都不自动轮转
无论是 caddy 写的 access.log，还是 Monolog 写的 app.log，都不会自己切分。靠 RotatingFileHandler 只能解决 PHP 层日志，但 caddy 日志仍会无限追加。唯一可靠方案是系统级 logrotate。
新建 /etc/logrotate.d/frankenphp：
/var/log/frankenphp/*.log {
daily
missingok
rotate 30
compress
delaycompress
notifempty
create 644 www-data www-data
copytruncate
sharedscripts
}特别注意：
-
copytruncate是核心：先拷贝再清空原文件，避免 FrankenPHP 进程因文件被 mv 而写失败 -
create权限要匹配实际运行用户（Ubuntu/Debian 是www-data，CentOS 是apache或nginx） - 别指望
Monolog的RotatingFileHandler能管住caddy日志——它俩根本不在一个进程里
日志路径分散、轮转机制混用，是最容易导致磁盘爆满又查不到源头的地方。所有日志路径最好统一收口到 /var/log/frankenphp/ 下，然后用一份 logrotate 规则统管。
