FrankenPHP怎么接入Monolog日志-php教程-PHP中文网

frankenphp默认不写日志文件，需同时配置caddy的log指令指定access.log/error.log路径，并在php层用monolog统一写业务日志到绝对路径，且必须配合系统logrotate轮转所有日志。

frankenphp怎么接入monolog日志

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
    }
}

注意点：

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 头部）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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]);
</p>

关键细节：

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
}

特别注意：