setcookie

函数名

setcookie

适用 PHP 版本

PHP 4, PHP 5, PHP 7, PHP 8

函数说明

setcookie() 函数用于向客户端发送一个 HTTP cookie。这个 cookie 会随着后续请求被自动发送回服务器。setcookie() 必须在发送任何其他输出之前调用。

函数语法

setcookie(string $name, string $value = "", int $expires = 0, string $path = "", string $domain = "", bool $secure = false, bool $httponly = false): bool

参数

• $name：必需。cookie 的名称。
• $value：可选。cookie 的值。
• $expires：可选。过期时间，使用 UNIX 时间戳格式。
• $path：可选。cookie 可用的服务器路径。
• $domain：可选。cookie 可用的域名。
• $secure：可选。如果为 true，则仅在 HTTPS 连接中传输 cookie。
• $httponly：可选。如果为 true，则只能通过 HTTP 协议访问 cookie，不能通过 JavaScript 访问。

返回值

如果成功设置了 cookie，则返回 true，否则返回 false。

示例

setcookie("username", "JohnDoe", time() + 3600, "/");

示例代码的说明

该示例设置了一个名为 username 的 cookie，值为 JohnDoe，有效期为当前时间加 3600 秒（即 1 小时），路径为整个网站根目录（/），这意味着整个网站都能访问该 cookie。