讲师中心 微信公众号
AI工具推荐 视频效率加速

php cookie怎么设置_setcookie函数参数含义与用法说明【说明】

大芳酱_3404

大芳酱_3404

发布时间:2025-12-30 09:51:15

|

221人浏览过

|

来源于php中文网

原创

setcookie() 必须在任何输出前调用,因它发送HTTP头;若已输出则报错“headers already sent”。推荐PHP 7.3+数组参数形式,删除Cookie需设过期时间并匹配原path/domain,$_COOKIE不会实时更新。

php cookie怎么设置_setcookie函数参数含义与用法说明【说明】

setcookie 函数必须在任何输出之前调用

PHP 的 setcookie() 是一个 HTTP 头部函数,它向客户端发送 Set-Cookie 响应头。一旦有任意输出(包括空格、换行、HTML、echo、print 甚至 BOM 字节),PHP 就无法再修改响应头,此时调用 setcookie() 会失败,并触发警告:Warning: Cannot modify header information - headers already sent。

  • 检查 PHP 文件开头是否有 UTF-8 BOM(可用编辑器如 VS Code 切换编码为 “UTF-8 without BOM”)
  • 确保 setcookie() 调用前没有 echo、var_dump()、print_r() 或 HTML 标签
  • 如果逻辑上必须先处理数据再设 Cookie,可启用输出缓冲:ob_start() 放在脚本最开头

setcookie 参数详解:第 3–7 个参数常被忽略但关键

setcookie() 完整签名是:setcookie(string $name, string $value = '', array|int $options = []): bool(PHP 7.3+ 推荐数组形式);旧式写法支持 7 个参数,但第 3–7 个位置参数易出错且已不推荐。

  • $name:Cookie 名,不能含空格或分号,建议只用字母、数字、下划线
  • $value:值,**自动 URL 编码**(空格变 +,特殊字符变 %xx),读取时 PHP 自动解码,无需手动 urlencode()
  • $expires_or_options:PHP 7.3+ 强烈建议传数组,例如:
    setcookie('theme', 'dark', [
        'expires' => time() + 86400,
        'path' => '/admin/',
        'domain' => '.example.com',
        'secure' => true,
        'httponly' => true,
        'samesite' => 'Strict'
    ]);
  • 旧式第 3 参数是过期时间戳(秒级 Unix 时间),设为 0 表示会话 Cookie(关闭浏览器即失效)
  • path 控制 Cookie 发送范围,默认 '/';设为 '/admin/' 则仅 /admin/xxx 及其子路径能访问该 Cookie
  • domain 需带前导点号(如 '.example.com')才允许子域名共享;设为 'example.com' 或留空则仅当前主机生效
  • secure 为 true 时,Cookie 仅通过 HTTPS 传输;HTTP 环境下设为 true 将导致 Cookie 不被发送
  • httponly 为 true 可防止 JS 读取(document.cookie 看不到),防御 XSS 窃取
  • samesite 推荐显式设为 'Lax'(默认行为,防 CSRF 且兼容大部分场景)或 'Strict'(更严,但可能影响跨站跳转)

删除 Cookie 的正确方式不是传空值

删除 Cookie 实际上是「覆盖一个已过期的同名 Cookie」。常见错误是:setcookie('user_id', '') —— 这只是把值设为空字符串,Cookie 依然存在且有效。

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载
  • 正确做法:设置 expires 为过去的时间(如 time() - 3600),并保持 path 和 domain 与原设置完全一致
  • 例如原 Cookie 是:setcookie('token', 'abc123', ['path' => '/api/', 'domain' => '.site.com']),则删除需:
    setcookie('token', '', ['expires' => time() - 3600, 'path' => '/api/', 'domain' => '.site.com']);
  • 若不确定原 path 或 domain,可尝试多组组合(path='/'、domain 留空等),但最稳妥的是记录原始配置

$_COOKIE 是请求开始时的快照,设完不能立刻读

$_COOKIE 数组在 PHP 脚本启动时从当前 HTTP 请求头中一次性读取,后续调用 setcookie() **不会更新** $_COOKIE。这意味着:

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

  • setcookie('lang', 'zh'); 之后立即 echo $_COOKIE['lang']; 仍为空或旧值
  • 要验证设置是否成功,只能在下一次请求中检查 $_COOKIE
  • 如需当前脚本内“模拟”读取,可手动赋值:$_COOKIE['lang'] = 'zh';(仅用于逻辑暂存,不影响实际 Cookie 行为)
  • 调试时可用浏览器开发者工具(Application → Cookies)确认是否收到 Set-Cookie 头及内容

Cookie 的安全性与路径/域/标志的匹配粒度密切相关,漏掉一个 path 或写错 domain 都会导致设而不用或删而不净。

相关文章

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

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

下载

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

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

2320

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

229

2026.02.03

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

5199

2023.08.02

cookie
cookie

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

10879

2023.06.30

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

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

926

2023.11.23

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

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

724

2024.02.23

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

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

1746

2025.08.19

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

11966

2023.09.14

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

20

2026.09.23

热门下载

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

精品课程

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

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

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

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn