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

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

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

---

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

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

1. 创建配置文件

   立即学习“PHP免费学习笔记（深入）”；

   

   btpanel phpsite 宝塔面板PHP网站

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

   下载

   sudo nano /etc/logrotate.d/frankenphp

2. 写入以下内容（根据你的日志路径和需求调整）：

   /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 实现按大小触发）。

3. 测试配置是否生效

   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，参考官方通道配置。

---

FrankenPHP 的日志管理本质是 Caddy 的日志管理，而 Caddy 的最佳实践就是交给 logrotate。配置一次，长期省心，不丢日志、不中断服务、不污染应用代码。