FrankenPHP 原生支持 HTTP 103 Early Hints用 PHP 预加载资源、加速页面渲染的完整指南【免费下载链接】frankenphp The modern PHP app server项目地址: https://gitcode.com/GitHub_Trending/fr/frankenphp导读本文围绕 FrankenPHP 对 HTTP 103 Early Hints早期提示状态码的原生支持展开讲解如何在 PHP 业务代码中通过header()与headers_send(103)在最终响应之前向浏览器提前推送预加载指令从而并行下载 CSS/JS 等关键资源。读完本文你将掌握 Early Hints 的完整调用方式、headers_send()的底层实现原理含 C 扩展与 Go 侧 1xx 响应处理细节、官方测试对普通模式与 worker 模式的验证以及生产环境中的注意事项。一、什么是 103 Early HintsHTTP 103 Early Hints 是一种信息性informational状态码服务器可以在最终 200 响应尚未就绪时先发送一组Link响应头告诉浏览器页面最终会用到这些资源现在就可以开始预加载。这能显著减少页面关键路径的等待时间。FrankenPHP 在 SAPIServer API层面原生支持这一状态码无需任何额外配置模块。官方文档docs/early-hints.md指出使用 Early Hints 可以将网页加载时间提升约 30%——这尤其适用于先做慢查询、再输出 HTML的典型 PHP 动态页面场景浏览器请求/index.php服务器立即返回103 Early Hints附带头Link: /style.css; relpreload; asstyle浏览器在服务器还在执行 SQL 查询/算法期间提前开始下载style.css服务器处理完毕返回最终200 OK与完整 HTML。由于预加载与后端计算并行发生最终响应的首字节TTFB之后的资源等待时间被压缩感知加载速度明显提升。二、核心 APIheaders_send()与 PHP 示例Early Hints 在 FrankenPHP 中的使用极其简单先用header()设置Link预加载头再调用headers_send(103)立即把当前累积的头作为 1xx 响应发送出去。官方文档给出的最小可用示例见 docs/tr/early-hints.md 与英文原版 docs/early-hints.md?php header(Link: /style.css; relpreload; asstyle); headers_send(103); // 你的慢算法和 SQL 查询 echo HTML !DOCTYPE html titleHello FrankenPHP/title link relstylesheet hrefstyle.css HTML;代码执行顺序决定了效果步骤代码作用1header(Link: /style.css; relpreload; asstyle)注册Link预加载指令仅加入响应头缓冲区尚未发送2headers_send(103)将当前缓冲区内的头作为103 Early Hints立即刷出3慢 SQL / 耗时计算后端继续工作浏览器已开始并行下载资源4echo输出 HTML生成最终 200 响应体注意Link头值中的资源路径要写真实可访问的静态资源地址relpreload配合asstyle样式表、asscript脚本或asimage图片等类型声明浏览器才能正确发起预加载。三、源码级原理headers_send()是如何工作的3.1 PHP 侧函数签名headers_send()是 FrankenPHP 内置的 PHP 函数其函数签名定义在 frankenphp.stub.phpfunction headers_send(int $status 200): int {}即接受一个可选的状态码参数默认 200返回int。参数与返回类型信息同时固化在 frankenphp_arginfo.h 的arginfo_headers_send中编译期即可完成类型校验。3.2 C 实现的核心逻辑真正的实现位于 C 扩展源码 frankenphp.c 的PHP_FUNCTION(headers_send)PHP_FUNCTION(headers_send) { zend_long response_code 200; ZEND_PARSE_PARAMETERS_START(0, 1) Z_PARAM_OPTIONAL Z_PARAM_LONG(response_code) ZEND_PARSE_PARAMETERS_END(); int previous_status_code SG(sapi_headers).http_response_code; SG(sapi_headers).http_response_code response_code; if (response_code 100 response_code 200) { int ret sapi_module.send_headers(SG(sapi_headers)); SG(sapi_headers).http_response_code previous_status_code; RETURN_LONG(ret); } RETURN_LONG(sapi_send_headers()); }关键点可以总结为1xx 分支当传入的状态码落在100 code 200区间即信息性响应103 属于其中函数会先保存当前真实状态码previous_status_code把 SAPI 层状态临时切换为目标码调用sapi_module.send_headers()把已累积的Link等头作为 1xx 响应发送出去然后立即恢复原状态码——确保后续200 OK不受影响非 1xx 分支传入 200 或其他普通状态码时走常规的sapi_send_headers()路径行为与正常请求无异返回值RETURN_LONG(ret)返回底层发送结果可用于错误处理。这套设计让headers_send(103)成为一次性的早期提示触发器每次调用只发送当前缓冲区内的头且不改变请求最终的响应状态。3.3 Go 侧对 1xx 响应的配合处理PHP 扩展发送 1xx 状态后最终要落到 Go 侧的http.ResponseWriter。在 frankenphp.go 中可以看到对应的适配逻辑fc.responseWriter.WriteHeader(goStatus) if goStatus 200 { // Clear headers, its not automatically done by ResponseWriter.WriteHeader() for 1xx responses h : fc.responseWriter.Header() for k : range h { delete(h, k) } }这段代码揭示了 Early Hints 得以正确工作的另一个关键机制Go 标准库的ResponseWriter.WriteHeader()不会在 1xx 响应后自动清除 HeaderMap因此 FrankenPHP 在发送完 1xx 状态码后手动清空所有响应头。这样103 Early Hints里携带的Link头就不会泄漏到最终的 200 响应中——保证预加载指令只在早期提示阶段出现一次。四、测试验证普通模式与 worker 模式双覆盖Early Hints 功能并非仅文档宣称仓库中配有完整的自动化测试frankenphp_test.gofunc TestEarlyHints_module(t *testing.T) { testEarlyHints(t, testOptions{}) } func TestEarlyHints_worker(t *testing.T) { testEarlyHints(t, testOptions{workerScript: early-hints.php}) }TestEarlyHints_module验证普通classic模式下的 Early HintsTestEarlyHints_worker验证worker 模式下的 Early Hints通过workerScript: early-hints.php指定 worker 入口。测试通过httptrace.ClientTrace.Got1xxResponse钩子捕获 1xx 响应并断言case http.StatusEarlyHints: assert.Equal(t, /style.css; relpreload; asstyle, header.Get(Link))同时验证最终响应中Link头已被清除assert.Equal(t, , w.Header().Get(Link))与 frankenphp.go 的清理逻辑相互印证。测试所用的请求端 Recorder 同样支持 1xx 回调见 recorder_test.go。对应测试脚本测试实际执行的是 testdata/early-hints.php它展示了比文档示例更完整的实战写法?php require_once __DIR__./_executor.php; return function () { header(Link: /style.css; relpreload; asstyle); header(Request: {$_GET[i]}); headers_send(103); header_remove(Link); echo Hello; };注意其中的header_remove(Link)发送完 103 后主动移除Link头确保最终 200 响应不再携带预加载指令。虽然 FrankenPHP 在 Go 侧已有 1xx 后的头清理逻辑见上文 3.3 节在业务代码里显式header_remove()依然是更稳妥、可读性更好的做法——尤其当上游代理或其他中间件也会透传响应头时。五、普通模式与 worker 模式一致的体验Early Hints 在 FrankenPHP 的两种运行模式下均可用普通classic模式每个请求在独立的 PHP 线程/进程中执行headers_send(103)在请求生命周期内按上述流程工作worker 模式PHP 脚本常驻内存、复用进程处理多个请求Early Hints 依赖的sapi_module.send_headers调用链同样生效官方测试TestEarlyHints_worker即是该场景的回归保障。对于 worker 模式建议把预加载逻辑放在请求回调内如 testdata/early-hints.php 所示而不是 worker 启动时的全局代码中以避免请求间头状态串扰。六、使用前提与实战注意事项结合源码实现在实际项目中启用 Early Hints 前请确认以下几点运行环境本文所述能力基于当前仓库 FrankenPHP 的headers_send()扩展与 Go 适配层frankenphp.c、frankenphp.go请使用包含该扩展的 FrankenPHP 构建版本只发送一次headers_send(103)每次调用都会把当时缓冲区内的头作为 1xx 发送出去不要在循环中重复调用同一组头头清理1xx 响应后记得header_remove()移除Link等预加载头避免其出现在最终 200 响应中Go 侧已有兜底清理但显式移除更安全业务顺序headers_send(103)必须在耗时计算之前调用才有意义——其价值就在于先发指令、后算结果链路兼容103 Early Hints 属于 HTTP/1.1 及 HTTP/2 均支持的信息性响应但若你的请求经过某些不支持 1xx 透传的反向代理/CDN预加载指令可能被丢弃最终效果取决于整条链路的兼容性收益场景文档称 Early Hints 可将加载时间提升约 30%docs/early-hints.md该收益主要出现在后端耗时占比高、且有明确可预加载资源的页面上对纯静态、零延迟页面收益有限建议按实际页面测速评估。七、小结FrankenPHP 对 HTTP 103 Early Hints 的原生支持让 PHP 开发者无需依赖任何第三方服务或 CDN 约定就能用最朴素的header()headers_send(103)组合实现响应前预加载。其背后是 C 扩展中精确的 1xx 状态切换逻辑frankenphp.c与 Go 侧对响应头的及时清理frankenphp.go共同保障的且通过普通模式与 worker 模式的双测试frankenphp_test.go验证了稳定性。下一份优化清单里不妨把这条零依赖、零配置的加速手段排进去。【免费下载链接】frankenphp The modern PHP app server项目地址: https://gitcode.com/GitHub_Trending/fr/frankenphp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FrankenPHP 原生支持 HTTP 103 Early Hints：用 PHP 预加载资源、加速页面渲染的完整指南
FrankenPHP 原生支持 HTTP 103 Early Hints用 PHP 预加载资源、加速页面渲染的完整指南【免费下载链接】frankenphp The modern PHP app server项目地址: https://gitcode.com/GitHub_Trending/fr/frankenphp导读本文围绕 FrankenPHP 对 HTTP 103 Early Hints早期提示状态码的原生支持展开讲解如何在 PHP 业务代码中通过header()与headers_send(103)在最终响应之前向浏览器提前推送预加载指令从而并行下载 CSS/JS 等关键资源。读完本文你将掌握 Early Hints 的完整调用方式、headers_send()的底层实现原理含 C 扩展与 Go 侧 1xx 响应处理细节、官方测试对普通模式与 worker 模式的验证以及生产环境中的注意事项。一、什么是 103 Early HintsHTTP 103 Early Hints 是一种信息性informational状态码服务器可以在最终 200 响应尚未就绪时先发送一组Link响应头告诉浏览器页面最终会用到这些资源现在就可以开始预加载。这能显著减少页面关键路径的等待时间。FrankenPHP 在 SAPIServer API层面原生支持这一状态码无需任何额外配置模块。官方文档docs/early-hints.md指出使用 Early Hints 可以将网页加载时间提升约 30%——这尤其适用于先做慢查询、再输出 HTML的典型 PHP 动态页面场景浏览器请求/index.php服务器立即返回103 Early Hints附带头Link: /style.css; relpreload; asstyle浏览器在服务器还在执行 SQL 查询/算法期间提前开始下载style.css服务器处理完毕返回最终200 OK与完整 HTML。由于预加载与后端计算并行发生最终响应的首字节TTFB之后的资源等待时间被压缩感知加载速度明显提升。二、核心 APIheaders_send()与 PHP 示例Early Hints 在 FrankenPHP 中的使用极其简单先用header()设置Link预加载头再调用headers_send(103)立即把当前累积的头作为 1xx 响应发送出去。官方文档给出的最小可用示例见 docs/tr/early-hints.md 与英文原版 docs/early-hints.md?php header(Link: /style.css; relpreload; asstyle); headers_send(103); // 你的慢算法和 SQL 查询 echo HTML !DOCTYPE html titleHello FrankenPHP/title link relstylesheet hrefstyle.css HTML;代码执行顺序决定了效果步骤代码作用1header(Link: /style.css; relpreload; asstyle)注册Link预加载指令仅加入响应头缓冲区尚未发送2headers_send(103)将当前缓冲区内的头作为103 Early Hints立即刷出3慢 SQL / 耗时计算后端继续工作浏览器已开始并行下载资源4echo输出 HTML生成最终 200 响应体注意Link头值中的资源路径要写真实可访问的静态资源地址relpreload配合asstyle样式表、asscript脚本或asimage图片等类型声明浏览器才能正确发起预加载。三、源码级原理headers_send()是如何工作的3.1 PHP 侧函数签名headers_send()是 FrankenPHP 内置的 PHP 函数其函数签名定义在 frankenphp.stub.phpfunction headers_send(int $status 200): int {}即接受一个可选的状态码参数默认 200返回int。参数与返回类型信息同时固化在 frankenphp_arginfo.h 的arginfo_headers_send中编译期即可完成类型校验。3.2 C 实现的核心逻辑真正的实现位于 C 扩展源码 frankenphp.c 的PHP_FUNCTION(headers_send)PHP_FUNCTION(headers_send) { zend_long response_code 200; ZEND_PARSE_PARAMETERS_START(0, 1) Z_PARAM_OPTIONAL Z_PARAM_LONG(response_code) ZEND_PARSE_PARAMETERS_END(); int previous_status_code SG(sapi_headers).http_response_code; SG(sapi_headers).http_response_code response_code; if (response_code 100 response_code 200) { int ret sapi_module.send_headers(SG(sapi_headers)); SG(sapi_headers).http_response_code previous_status_code; RETURN_LONG(ret); } RETURN_LONG(sapi_send_headers()); }关键点可以总结为1xx 分支当传入的状态码落在100 code 200区间即信息性响应103 属于其中函数会先保存当前真实状态码previous_status_code把 SAPI 层状态临时切换为目标码调用sapi_module.send_headers()把已累积的Link等头作为 1xx 响应发送出去然后立即恢复原状态码——确保后续200 OK不受影响非 1xx 分支传入 200 或其他普通状态码时走常规的sapi_send_headers()路径行为与正常请求无异返回值RETURN_LONG(ret)返回底层发送结果可用于错误处理。这套设计让headers_send(103)成为一次性的早期提示触发器每次调用只发送当前缓冲区内的头且不改变请求最终的响应状态。3.3 Go 侧对 1xx 响应的配合处理PHP 扩展发送 1xx 状态后最终要落到 Go 侧的http.ResponseWriter。在 frankenphp.go 中可以看到对应的适配逻辑fc.responseWriter.WriteHeader(goStatus) if goStatus 200 { // Clear headers, its not automatically done by ResponseWriter.WriteHeader() for 1xx responses h : fc.responseWriter.Header() for k : range h { delete(h, k) } }这段代码揭示了 Early Hints 得以正确工作的另一个关键机制Go 标准库的ResponseWriter.WriteHeader()不会在 1xx 响应后自动清除 HeaderMap因此 FrankenPHP 在发送完 1xx 状态码后手动清空所有响应头。这样103 Early Hints里携带的Link头就不会泄漏到最终的 200 响应中——保证预加载指令只在早期提示阶段出现一次。四、测试验证普通模式与 worker 模式双覆盖Early Hints 功能并非仅文档宣称仓库中配有完整的自动化测试frankenphp_test.gofunc TestEarlyHints_module(t *testing.T) { testEarlyHints(t, testOptions{}) } func TestEarlyHints_worker(t *testing.T) { testEarlyHints(t, testOptions{workerScript: early-hints.php}) }TestEarlyHints_module验证普通classic模式下的 Early HintsTestEarlyHints_worker验证worker 模式下的 Early Hints通过workerScript: early-hints.php指定 worker 入口。测试通过httptrace.ClientTrace.Got1xxResponse钩子捕获 1xx 响应并断言case http.StatusEarlyHints: assert.Equal(t, /style.css; relpreload; asstyle, header.Get(Link))同时验证最终响应中Link头已被清除assert.Equal(t, , w.Header().Get(Link))与 frankenphp.go 的清理逻辑相互印证。测试所用的请求端 Recorder 同样支持 1xx 回调见 recorder_test.go。对应测试脚本测试实际执行的是 testdata/early-hints.php它展示了比文档示例更完整的实战写法?php require_once __DIR__./_executor.php; return function () { header(Link: /style.css; relpreload; asstyle); header(Request: {$_GET[i]}); headers_send(103); header_remove(Link); echo Hello; };注意其中的header_remove(Link)发送完 103 后主动移除Link头确保最终 200 响应不再携带预加载指令。虽然 FrankenPHP 在 Go 侧已有 1xx 后的头清理逻辑见上文 3.3 节在业务代码里显式header_remove()依然是更稳妥、可读性更好的做法——尤其当上游代理或其他中间件也会透传响应头时。五、普通模式与 worker 模式一致的体验Early Hints 在 FrankenPHP 的两种运行模式下均可用普通classic模式每个请求在独立的 PHP 线程/进程中执行headers_send(103)在请求生命周期内按上述流程工作worker 模式PHP 脚本常驻内存、复用进程处理多个请求Early Hints 依赖的sapi_module.send_headers调用链同样生效官方测试TestEarlyHints_worker即是该场景的回归保障。对于 worker 模式建议把预加载逻辑放在请求回调内如 testdata/early-hints.php 所示而不是 worker 启动时的全局代码中以避免请求间头状态串扰。六、使用前提与实战注意事项结合源码实现在实际项目中启用 Early Hints 前请确认以下几点运行环境本文所述能力基于当前仓库 FrankenPHP 的headers_send()扩展与 Go 适配层frankenphp.c、frankenphp.go请使用包含该扩展的 FrankenPHP 构建版本只发送一次headers_send(103)每次调用都会把当时缓冲区内的头作为 1xx 发送出去不要在循环中重复调用同一组头头清理1xx 响应后记得header_remove()移除Link等预加载头避免其出现在最终 200 响应中Go 侧已有兜底清理但显式移除更安全业务顺序headers_send(103)必须在耗时计算之前调用才有意义——其价值就在于先发指令、后算结果链路兼容103 Early Hints 属于 HTTP/1.1 及 HTTP/2 均支持的信息性响应但若你的请求经过某些不支持 1xx 透传的反向代理/CDN预加载指令可能被丢弃最终效果取决于整条链路的兼容性收益场景文档称 Early Hints 可将加载时间提升约 30%docs/early-hints.md该收益主要出现在后端耗时占比高、且有明确可预加载资源的页面上对纯静态、零延迟页面收益有限建议按实际页面测速评估。七、小结FrankenPHP 对 HTTP 103 Early Hints 的原生支持让 PHP 开发者无需依赖任何第三方服务或 CDN 约定就能用最朴素的header()headers_send(103)组合实现响应前预加载。其背后是 C 扩展中精确的 1xx 状态切换逻辑frankenphp.c与 Go 侧对响应头的及时清理frankenphp.go共同保障的且通过普通模式与 worker 模式的双测试frankenphp_test.go验证了稳定性。下一份优化清单里不妨把这条零依赖、零配置的加速手段排进去。【免费下载链接】frankenphp The modern PHP app server项目地址: https://gitcode.com/GitHub_Trending/fr/frankenphp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考