FrankenPHP怎么减少静态资源访问日志-php教程-PHP中文网

应禁用静态资源日志以减少日志量，可通过设置 log level error 配合 not path 匹配排除 js/css/图片等后缀，或仅在 api 路由块中启用日志。

frankenphp怎么减少静态资源访问日志

FrankenPHP 默认会把所有请求（包括 JS、CSS、图片等静态资源）记进 access.log，日志量可能占总量 70% 以上。这不是 bug，是 Caddy 的默认行为——但完全没必要全量记录。

为什么静态资源日志要单独控制

Caddy 的 log 指令默认不区分请求类型，GET /js/app.js 和 POST /api/login 在日志里地位相同。而静态资源通常：无业务价值、高频访问、格式固定、可缓存。全量记录只会撑大日志体积、拖慢磁盘 I/O、干扰错误排查。

常见现象：access.log 单日增长超 500MB，其中 85% 是 200 状态的 .png、.woff2 请求
真实需求：只记录非 200 响应（如 404、500）、或只记录动态路由（/api/、/admin/）
关键限制：Caddy 的 log 不支持按文件后缀过滤，只能靠路径匹配或状态码拦截

用 matchers + level error 实现最小化日志

最轻量、最可靠的做法是把日志级别设为 error，并配合路径 matcher 排除已知静态路径——这样只有出错的静态请求（比如漏传文件、权限问题）才会被记录。

btpanel phpsite 宝塔面板PHP网站

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

下载

在 Caddyfile 的 log 块中显式指定 level error，而非默认的 info

添加 match 条件，只对非静态路径启用日志，例如：

log {
    output file /var/log/frankenphp/access.log
    level error
    match {
        not path *.js *.css *.png *.jpg *.gif *.ico *.woff2 *.svg
        not path /favicon.ico
    }
}

注意：match 必须写在 log 块内，且 not path 支持 glob，但不支持正则；路径匹配基于 request.uri，不是文件系统路径

彻底禁用静态资源日志（推荐用于 CDN 回源场景）

如果你用 Cloudflare 或 Nginx 做前置 CDN，静态资源根本不会打到 FrankenPHP，那连 error 级都不用记——直接让 Caddy 跳过日志逻辑。

删掉全局 { log } 块，改用条件式日志：只在需要监控的路由块里加 log

例如，仅对 API 路径记录：

route /api/* {
    log {
        output file /var/log/frankenphp/api.log
        level info
    }
    php { ... }
}

确保静态资源路由（如 route *.js）块里**不包含任何 log 指令**——Caddy 就不会为它生成日志条目
验证方式：发起一个 curl -I /css/app.css，检查 access.log 是否无新增；再触发一个 curl http://localhost/nonexistent.js，确认 404 也不出现（因为没配 log）