FrankenPHP静态资源缓存一年怎么做

小婷姑娘_1209

小婷姑娘_1209

2026-10-06

1005人浏览

原创

FrankenPHP中配置一年强缓存的关键在于Caddyfile中为静态资源路径显式设置Cache-Control: public, max-age=31536000, immutable,并确保文件名带哈希、路径匹配优先级高于PHP路由,三者缺一不可。

frankenphp静态资源缓存一年怎么做

FrankenPHP里配强缓存一年,关键在Caddyfile加Cache-Control

FrankenPHP本身不直接处理静态资源缓存逻辑,它把这事交给内嵌的Caddy引擎。所以配「一年缓存」不是改PHP配置,而是写对Caddyfile里的Cache-Control响应头。默认Caddy对静态文件(比如/static/、/assets/下)不会自动加长缓存,必须显式声明。

常见错误是只加max-age=31536000却漏掉immutable——这会导致浏览器在资源更新后仍可能复用旧缓存,尤其配合HTML内联引用时出问题。

  • 确保静态资源路径明确,例如/static/或/dist/,避免和PHP路由冲突
  • 在Caddyfile对应路径块里写:header Cache-Control "public, max-age=31536000, immutable"
  • 不要对.php或/api/这类动态路径加这个头,否则页面会卡在旧版本
  • 如果用了worker模式,确认Caddyfile里没被php指令意外覆盖静态路径处理顺序

为什么必须配合文件名哈希,光设max-age会失效

设了max-age=31536000后,浏览器真的一年都不再发请求——哪怕你悄悄替换了app.js内容,用户还是拿到旧版。这就是「强缓存不校验内容」的本质。所以immutable存在的前提,是文件名本身带变化标识。

构建时生成带哈希的文件名,比如app.a1b2c3.js,上线后新HTML里引用的是app.d4e5f6.js,浏览器一看文件名不同,就自然跳过旧缓存,发起新请求。没这步,Cache-Control配得再狠也没用。

  • Laravel Mix、Vite、Webpack都默认支持哈希输出,检查构建产物是否含哈希字符串
  • 手动版本号(如style.v2.css)也行,但必须保证每次内容变更都改版本号,不能只改注释
  • HTML里引用必须同步更新,用模板变量或构建插件自动注入,别手写死

FrankenPHP下etag和last-modified要不要关

不需要关,也不建议关。FrankenPHP默认开启ETag(基于文件内容生成),但只要你对静态资源路径配了Cache-Control: immutable,浏览器根本不会发送If-None-Match请求——ETag压根没机会被用到。它只是个后备机制,不影响主流程。

Build MCP servers and clients for PHP applications with the official PHP SDK
Build MCP servers and clients for PHP applications with the official PHP SDK

使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

下载

真正要留意的是:别在同一个路径上混用协商缓存和强缓存。比如给/static/既加no-cache又加max-age,Caddy会按规则合并,结果不可控。

  • 静态资源路径只配Cache-Control,别额外加etag off或header -Etag
  • HTML页面路径(如/或/*.html)才需要开ETag + no-cache,让每次刷新都校验
  • 用curl -I https://yoursite.com/static/app.js验证响应头,确认只有Cache-Control且无ETag字段被强制移除

容易被忽略的FrankenPHP特有坑:worker模式下静态文件路径匹配优先级

FrankenPHP的worker指令默认会接管所有PHP相关路径,但如果Caddyfile里静态路径规则写在php块之后,Caddy可能先匹配到PHP路由,把/static/app.js当成PHP脚本去执行——结果返回500或空白,而不是文件内容。

解决方法是把静态资源路径块写在php或frankenphp块之前,利用Caddy「从上到下匹配」的规则优先处理。

  • 正确顺序示例:handle /static/* { ... } → handle *.php { ... } → frankenphp { ... }
  • 用handle_path比handle更安全,避免正则误匹配
  • 本地测试时用caddy validate检查配置语法,上线前务必caddy reload而非重启

实际生效的关键,永远是「文件名变」+「响应头对」+「路径不被PHP劫持」三者同时成立。少一个,缓存一年就是一句空话。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

13464

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7701

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2295

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4848

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5574

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

4411

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

6377

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

5042

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12662

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习