0

0

php如何设置响应头信息?php header()函数设置HTTP头信息

穿越時空

穿越時空

发布时间:2025-09-13 19:56:01

|

798人浏览过

|

来源于php中文网

原创

答案:PHP中header()函数必须在任何输出前调用,否则会触发“Headers already sent”错误。常见用途包括设置Content-Type、页面重定向、状态码、Cookie和文件下载,需注意调用时机与输出缓冲控制。

php如何设置响应头信息?php header()函数设置http头信息

PHP中设置HTTP响应头信息,核心就是依赖

header()
函数。它允许你直接操作浏览器或客户端在接收到你的PHP脚本输出之前,需要知道的一些元数据。无论是告诉浏览器这是一个JSON数据,还是引导用户跳转到另一个页面,甚至控制内容的缓存行为,
header()
函数都是完成这些任务的关键工具。理解并正确使用它,是每个PHP开发者必备的技能,也是构建高效、可靠Web应用的基础。

在PHP里,如果你想对客户端发出HTTP响应头,

header()
函数就是你的不二之选。它的基本用法很简单,但背后藏着一些需要注意的细节,稍不留神就可能踩坑。

最常见的形式是这样:

header("Header-Name: Header-Value");

比如,你想告诉浏览器你返回的是一个JSON格式的数据,而不是默认的HTML:

<?php
header("Content-Type: application/json; charset=utf-8");
echo json_encode(['message' => 'Hello, world!']);
exit;
?>

这里有个非常关键的点,也是我个人在早期开发中经常犯错的地方:

header()
函数必须在任何实际输出(包括HTML、空格、换行符,甚至是BOM头)之前被调用。一旦有任何内容被发送到浏览器,PHP就会抛出“Headers already sent”的错误。所以,通常我都会把所有的
header()
调用放在脚本的最顶部,确保万无一失。

立即学习PHP免费学习笔记(深入)”;

除了

Content-Type
header()
函数还有很多强大的用途:

  • 页面重定向: 这是最常用的功能之一,强制浏览器跳转到另一个URL。

    <?php
    header("Location: https://www.example.com/new-page.php");
    exit; // 重定向后立即终止脚本,防止后续代码执行
    ?>

    这里

    exit;
    非常重要,它能确保在重定向指令发出后,当前脚本不再继续处理,这既是性能考量,也是安全实践。

  • 设置HTTP状态码: 默认情况下,PHP会发送

    200 OK
    。但如果你想表示资源未找到(404)、未授权(401)或者服务器内部错误(500),你可以这么做:

    Khroma
    Khroma

    AI调色盘生成工具

    下载
    <?php
    // 方法一:直接设置HTTP状态行
    header("HTTP/1.0 404 Not Found");
    // 方法二:使用http_response_code(),更现代也更推荐
    http_response_code(404);
    echo "<h1>404 - 页面未找到</h1>";
    ?>

    我个人更倾向于

    http_response_code()
    ,因为它语义更清晰,也更不容易出错。

  • 设置Cookie: 虽然有

    setcookie()
    函数,但从技术上讲,它也是通过设置
    Set-Cookie
    头来实现的。

    <?php
    header("Set-Cookie: username=john_doe; expires=" . gmdate("D, d M Y H:i:s T", time() + 3600) . "; path=/");
    // 或者更推荐使用 setcookie() 函数
    // setcookie("username", "john_doe", time() + 3600, "/");
    ?>
  • 文件下载: 当你想让浏览器下载文件而不是直接打开它时,

    Content-Disposition
    头就派上用场了。

    <?php
    $filename = "document.pdf";
    header("Content-Type: application/octet-stream"); // 或具体的文件MIME类型
    header("Content-Disposition: attachment; filename=\"" . $filename . "\"");
    // header("Content-Length: " . filesize($filepath)); // 如果知道文件大小,加上这个会更好
    readfile($filepath); // 输出文件内容
    exit;
    ?>

    这里

    application/octet-stream
    是一个通用的二进制流类型,告诉浏览器这是一个文件,而不是文本或图片。

header()
函数虽然强大,但它的不可逆性(一旦输出就不能再设置头信息)决定了我们在使用时必须非常小心和有条理。这就像在飞机起飞前检查所有系统一样,头信息也需要在页面内容生成前就全部敲定。

PHP
header()
函数使用不当会引发哪些问题?

说实话,

header()
函数用起来有时候确实有点让人头疼,尤其是当你刚开始接触PHP的时候。最常见也最让人抓狂的问题,莫过于那个经典的“Headers already sent”错误。

这个错误通常发生在你的PHP脚本在调用

header()
函数之前,已经向浏览器发送了任何形式的输出。这个输出可能是一行

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

457

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

549

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6500

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

368

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

447

2024.02.23

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

97

2025.08.19

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号