在PHP中发送Early Hints的Link Header指南-php教程-PHP中文网

在PHP中发送Early Hints的Link Header指南

花韻仙語

发布： 2025-11-26 12:00:07

原创

907人浏览过

在php中发送early hints的link header指南

本文详细介绍了如何在PHP应用中正确利用HTTP Link Header发送Early Hints，以优化前端性能。核心在于使用`header()`函数构建Link Header，并强调添加`nopush`属性以区分预加载指令和HTTP/2服务器推送，确保浏览器能有效利用这些早期提示资源，提升页面加载速度。

理解Early Hints与Link Header

Early Hints（早期提示）是一种HTTP/1.1和HTTP/2的响应状态码（103），它允许服务器在处理主响应（如200 OK）的同时，提前告知客户端可能需要的关键资源。这可以显著减少页面渲染阻塞时间，提高用户体验。Early Hints主要通过Link HTTP Header来传递这些资源提示。

Link Header的常见用途包括：

rel="preload": 预加载关键资源，如CSS、JavaScript、字体等。
rel="preconnect": 预连接到其他域，减少后续请求的DNS解析、TCP握手和TLS协商时间。
rel="prefetch": 预获取将来可能需要的资源，通常用于下一页或用户可能操作的资源。

当服务器在发送最终的200 OK响应之前，通过103 Early Hints状态码发送包含Link Header的响应时，客户端（浏览器）可以提前开始下载或连接这些资源，从而在主响应到达时，这些资源已经准备就绪或正在传输中。

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

PHP中发送Early Hints的Link Header

在PHP中，我们使用内置的header()函数来发送HTTP响应头。要发送一个Link Header作为Early Hints，关键在于正确构造Header字符串，并特别注意一个重要的属性：nopush。

基本语法

发送Link Header的基本结构如下：

header("Link: <资源URL>; rel=关系类型; as=资源类型", false);

登录后复制

其中：

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

396

查看详情

zuojiankuohaophpcn资源URL>: 待预加载或预连接的资源完整URL。
rel=关系类型: 定义了资源与当前文档的关系，如preload、preconnect、prefetch等。
as=资源类型: （仅对preload有效）指定了预加载资源的具体类型，如style、script、font、image等，这有助于浏览器正确处理和缓存资源。

区分Early Hints与HTTP/2 Server Push

最初，Link Header也可以用于触发HTTP/2服务器推送（Server Push），这意味着服务器主动将资源推送到客户端，而无需客户端明确请求。然而，Early Hints的目标是让客户端决定是否以及何时请求资源，而不是强制推送。

为了明确区分这两种行为，并确保你的Link Header仅作为Early Hints的提示，而不是触发服务器推送，必须添加nopush属性。

header("Link: <https://example.com/style.css>; rel=preload; as=style; nopush", false);

登录后复制

在这里：

nopush: 这个属性明确告诉服务器和客户端，这个Link Header不应该触发HTTP/2服务器推送。它指示客户端这是一个“提示”，而不是一个强制的推送指令。

为什么nopush如此重要？ 如果不加nopush，一些支持HTTP/2 Server Push的服务器可能会将这个Link Header解释为推送指令，从而可能导致资源被重复发送（一次推送，一次客户端请求），或者在某些情况下，如果客户端不需要该资源，造成带宽浪费。通过添加nopush，我们确保了Link Header仅用于Early Hints，让客户端根据自身情况决定是否预加载。

完整的PHP示例

假设你希望在页面加载前预加载一个CSS文件和一个JavaScript文件，并预连接到一个CDN域。你可以在PHP脚本的早期阶段（在任何输出之前）添加如下代码：

<?php
// 确保在任何实际内容输出之前发送HTTP头

// 预加载一个CSS文件
header("Link: <https://example.com/assets/css/main.css>; rel=preload; as=style; nopush", false);

// 预加载一个JavaScript文件
header("Link: <https://example.com/assets/js/app.js>; rel=preload; as=script; nopush", false);

// 预连接到一个CDN域
header("Link: <https://cdn.example.com>; rel=preconnect; nopush", false);

// ... 你的PHP业务逻辑和HTML内容 ...

?>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>我的Early Hints页面</title>
    <!-- 实际的资源引用 -->
    <link rel="stylesheet" href="https://example.com/assets/css/main.css">
</head>
<body>
    <h1>欢迎来到我的网站</h1>
    <script src="https://example.com/assets/js/app.js"></script>
</body>
</html>

登录后复制

注意事项：

执行时机： header()函数必须在任何实际的HTML内容或其他输出发送到浏览器之前调用。否则，PHP会报错。
false参数： header()函数的第二个参数replace默认为true，表示如果存在同名Header，则替换。当发送多个Link Header时，应将其设置为false，以允许添加多个Link Header实例，而不是覆盖前一个。
服务器支持： 要使Early Hints真正发挥作用，你的Web服务器（如Nginx、Apache）和前端代理（如Cloudflare）也需要配置为支持和发送103 Early Hints状态码。PHP代码负责生成Link Header，但服务器负责将其包装在103响应中并发送。
谨慎使用： 仅对关键资源使用Early Hints。过度使用或预加载非关键资源可能会适得其反，反而增加初始请求的负担。

总结

在PHP中利用Link Header发送Early Hints是优化Web性能的有效手段。核心在于使用header()函数，并为每个预加载或预连接的资源构造正确的Link Header字符串。至关重要的是，务必在Link Header中包含nopush属性，以确保这些提示被正确解释为Early Hints，而不是触发HTTP/2服务器推送，从而避免潜在的性能问题。结合服务器对103 Early Hints的支持，你可以显著提升网站的加载速度和用户体验。

以上就是在PHP中发送Early Hints的Link Header指南的详细内容，更多请关注php中文网其它相关文章！