FrankenPHP同时开zstd和br和gzip会怎么选

陌涛吖_6746

陌涛吖_6746

2026-10-09

870人浏览

原创

frankenphp按客户端accept-encoding从左到右匹配首个服务端启用的编码,非最优协商;默认仅支持gzip,brotli需插件+配置,zstd需手动注册且浏览器兼容性差,生产环境慎用。

frankenphp同时开zstd和br和gzip会怎么选

FrankenPHP 会按客户端 Accept-Encoding 顺序选第一个匹配的算法

FrankenPHP 本身不“同时启用多个压缩算法并挑最优的”,它只是把请求头里的 Accept-Encoding 拿过来,从左到右扫描,取第一个它支持且服务端已启用的编码。比如客户端发来:Accept-Encoding: br, gzip, zstd,FrankenPHP 已配置了 Brotli 和 gzip(但没开 zstd),那它就选 br;如果只开了 zstd 和 gzip,就会跳过 br,选 gzip。

这个行为不是 FrankenPHP 特有,而是 HTTP/1.1 规范要求的协商逻辑——服务端不决定“哪个最好”,只响应“我支持你排在最前面的那个”。所以“同时开 zstd/br/gzip”本身没有冲突,但实际生效的永远只有一个,取决于客户端怎么写头、服务端开了哪些。

FrankenPHP 默认不内置 zstd 或 br,必须手动注册和启用

FrankenPHP 的压缩能力依赖底层 Caddy 的编码器插件机制,而它的默认发行版只带 gzip。Brotli 和 zstd 都要额外操作:

  • Brotli 需安装 caddy-brotli 插件,并在 Caddyfile 里加 encode br
  • zstd 需引入 github.com/klauspost/compress/zstd,自己写 encoder 注册进 Caddy 的 http.encode 模块,再配 encode zstd
  • 漏掉任一环节(比如装了插件但没在 Caddyfile 写 encode 行),对应算法就完全不可用,客户端即使声明了也会被忽略

br 和 zstd 在浏览器兼容性上存在明显断层

别只看压缩率数字,得看谁真能解:

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

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

下载
  • br:Chrome 49+、Firefox 44+、Safari 11.1+(即 macOS 10.13.4 / iOS 11.3+)都支持;但 Safari 11.0 及更早版本会直接拒收 Content-Encoding: br 响应,返回 406
  • zstd:截至 2026 年 10 月,**iOS Safari 仍不支持**,桌面 Safari 仅从 15.4 开始实验性支持,且需显式开启 Experimental Features > Zstandard;Chrome 和 Firefox 也未原生集成,目前只有通过 Service Worker 或 fetch API 手动解压才可能用上
  • gzip:所有浏览器、所有年代的 curl、wget、旧版 Android WebView 全支持,是真正的兜底项

这意味着:如果你开了 br 和 gzip,现代浏览器走 br,老设备自动 fallback 到 gzip;但开了 zstd 却没配好降级,大量真实用户会拿到无法解析的响应体。

gzip 和 br 同时启用时,br 几乎总赢,除非客户端头写错顺序

只要客户端 Accept-Encoding 把 br 放在 gzip 前面,且服务端启用了 br,FrankenPHP 就不会考虑 gzip。实测中常见干扰点有:

  • 某些 CDN(如 Cloudflare 免费版)会主动重写 Accept-Encoding,删掉 br 只留 gzip,导致你白配了 br
  • Postman 或 curl 测试时忘了加 -H "Accept-Encoding: br,gzip",默认只发 gzip,你以为没生效其实是客户端没申明
  • Nginx 做前置代理时没透传 Accept-Encoding 头,FrankenPHP 根本看不到原始值

真正需要警惕的是 zstd —— 它不是“多开一个更保险”,而是“多开一个就多一个故障面”。除非你 100% 控制客户端(比如内部 Electron 应用 + 自研 fetch 封装),否则别把它放进生产环境的 encode 链。

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

10364

6

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

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

2023.10.11

6101

5

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

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

2023.10.11

2115

5

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

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

2023.10.23

3848

4

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

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

2023.10.23

4534

6

html怎么上传
html怎么上传

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

2023.11.03

3571

9

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

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

2023.11.09

5077

8

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

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

2023.11.13

3982

8

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

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

2023.11.27

11942

4

热门下载

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

精品课程

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

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习