FrankenPHP 日志分割怎么配置防止日志文件无限变大-php教程-PHP中文网

frankenphp 日志需由系统 logrotate 管理，因其自身无轮转能力且 caddy 默认不切分日志；正确做法是配置 /etc/logrotate.d/frankenphp，使用 copytruncate、create 和 rotate 等参数实现安全轮转。

frankenphp 日志分割怎么配置防止日志文件无限变大

FrankenPHP 本身不内置日志轮转能力，它的日志输出（如访问日志、错误日志）由底层 Caddy 引擎控制，而 Caddy 默认采用单文件追加写入模式——不自动按大小或时间切分，也不清理旧日志。若长期运行又无干预，access.log 或 error.log 很容易涨到 GB 级别，最终占满磁盘。

要防止日志无限变大，核心思路是：交由系统级 logrotate 管理，而非依赖 PHP 或 Caddy 自身轮转逻辑。这是最稳定、原子、免重启的方案。

✅ 正确做法：用 logrotate 切割 FrankenPHP 日志

FrankenPHP 启动后，Caddy 会把日志写入你配置中指定的路径（例如 /var/log/frankenphp/access.log）。你需要为这个路径单独配一个 logrotate 规则。

创建配置文件

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

下载
```
sudo nano /etc/logrotate.d/frankenphp
```
写入以下内容（根据你的日志路径和需求调整）：
```
/var/log/frankenphp/*.log {
    daily
    missingok
    rotate 30
    compress
    delaycompress
    notifempty
    create 644 www-data www-data
    copytruncate
    sharedscripts
    postrotate
        # 如果 FrankenPHP 是 systemd 服务，可选重载（非必须）
        # systemctl kill --signal=USR1 frankenphp.service 2>/dev/null || true
    endscript
}
```
- copytruncate 是关键：先复制内容，再清空原文件，确保 FrankenPHP 进程持续写入不中断；
- create 644 www-data www-data 保证新日志文件权限正确（Ubuntu/Debian 默认用户组是 www-data；CentOS 是 www）；
- rotate 30 表示最多保留 30 个归档（.log.1, .log.2 …），超出自动删除最老的；
- daily 表示每天触发一次切割（也可换为 size 100M 实现按大小触发）。
测试配置是否生效
```
sudo logrotate -f /etc/logrotate.d/frankenphp
ls -lh /var/log/frankenphp/
```
应看到 access.log.1 出现，且原 access.log 变为空文件。

⚠️ 不推荐的做法（易出问题）

❌ 在 Caddyfile 中用 log 指令加 roll 参数（如 roll 100MB）
Caddy v2.8+ 虽支持简单 roll，但不支持压缩、归档命名、保留数量控制，也没有 postrotate 机制，无法安全刷新句柄，高并发下易丢日志。
❌ 用 PHP 层自定义日志处理器（如 Monolog RotatingFileHandler）
FrankenPHP 的访问日志和错误日志是 Caddy 直接写的，绕过 PHP 运行时，你在应用里配的 Monolog 对这些日志完全无效。它只影响你代码中 error_log() 或框架 Log::write() 输出的内容（即 runtime/log/ 下的应用日志）。
❌ 直接 rm 或 find ... -delete 删除日志文件
删除正在被 FrankenPHP 写入的文件会导致磁盘空间不释放（Linux 文件句柄仍被占用），甚至引发写入失败。

? 补充建议：控制日志量源头

关闭不必要的日志级别
在 Caddyfile 的 log 块中限制 level，例如只记录 warn 及以上：
```
log {
    output file /var/log/frankenphp/access.log
    level warn
}
```
禁用 PHP-FPM 类型的 access.log（FrankenPHP 不需要）
它没有 php-fpm.conf，所以无需处理该问题；但如果你同时运行了独立 PHP-FPM，请确保其 access.log 已关闭，避免重复记录。
应用层日志（如 ThinkPHP 的 runtime/log/）需单独配置
这部分属于 PHP 框架日志，和 FrankenPHP 的服务器日志无关。例如 TP6 应改用 Monolog RotatingFileHandler，并设 maxFiles = 30，参考官方通道配置。