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),你可以这么做:

    ModelGate
    ModelGate

    一站式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()
函数之前,已经向浏览器发送了任何形式的输出。这个输出可能是一行

相关文章

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

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

下载

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

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

26

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号