setrawcookie

适用PHP版本

PHP 5.2.0 及以上版本

函数说明

setrawcookie() 用于发送一个原始的 HTTP Cookie，且不会对 Cookie 的值进行 URL 编码。它适合在需要自定义编码格式时使用。

函数语法

bool setrawcookie ( string $name [, string $value = "" [, int $expires = 0 [, string $path = "" [, string $domain = "" [, bool $secure = false [, bool $httponly = false ]]]]]] )

参数

• $name：必须，Cookie 名称。
• $value：可选，Cookie 的值，不会进行 URL 编码，默认空字符串。
• $expires：可选，Cookie 过期时间，Unix 时间戳，默认值为 0（表示会话 Cookie，关闭浏览器失效）。
• $path：可选，Cookie 可用的服务器路径，默认为空字符串。
• $domain：可选，Cookie 所属域名，默认为空字符串。
• $secure：可选，布尔值，是否仅通过 HTTPS 发送 Cookie，默认 false。
• $httponly：可选，布尔值，是否仅通过 HTTP 协议访问 Cookie（JavaScript 无法访问），默认 false。

返回值

成功返回 true，失败返回 false。

示例

下面示例设置了一个名为 my_cookie，值为 hello world! 的 Cookie，有效期为 1 小时，路径为根目录，且不进行 URL 编码。

示例代码

<?php
setrawcookie("my_cookie", "hello world!", time() + 3600, "/");
?>

示例代码的说明

这段代码会发送一个 HTTP 头部，设置一个原始值为 hello world! 的 Cookie。与 setcookie 不同，setrawcookie 不会对值进行 URL 编码，适合需要保持原始字符串的场景。