PHP setrawcookie() 函数 · W3School PHP 参考手册

# PHP setrawcookie() 函数 ## 定义和用法 setrawcookie() 函数不对 cookie 值进行 URL 编码，发送一个 HTTP cookie。 cookie 是由服务器发送到浏览器的变量。cookie 通常是服务器嵌入到用户计算机中的小文本文件。每当计算机通过浏览器请求一个页面，就会发送这个 cookie。 cookie 的名称指定为相同名称的变量。例如，如果被发送的 cookie 名为 "name"，会自动创建名为 $user 的变量，包含 cookie 的值。必须在任何其他输出发送前对 cookie 进行赋值。如果成功，则该函数返回 true，否则返回 false。 ### 语法 ``` setcookie(name,value,expire,path,domain,secure) ``` | 参数 | 描述 | | --- | --- | | name | 必需。规定 cookie 的名称。 | | value | 必需。规定 cookie 的值。 | | expire | 可选。规定 cookie 的有效期。 | | path | 可选。规定 cookie 的服务器路径。 | | domain | 可选。规定 cookie 的域名。 | | secure | 可选。规定是否通过安全的 HTTPS 连接来传输 cookie。 | ## 提示和注释注释：可以通过 $HTTP_COOKIE_VARS["user"] 或 $_COOKIE["user"] 来访问名为 "user" 的 cookie 的值。注释：setrawcookie() 与 [setcookie()](/php/func_http_setcookie.asp "PHP setcookie() 函数") 几乎完全相同，不同的是不会在发往客户机时，对 cookie 值进行自动 URL 编码。 ## 例子 ### 例子 1 设置并发送 cookie： ``` <?php $value = "my cookie value"; // 发送一个简单的 cookie setrawcookie("TestCookie",$value); ?> <html> <body> ... ... ``` ``` <?php $value = "my cookie value"; // 发送一个 24 小时候过期的 cookie setrawcookie("TestCookie",$value, time()+3600*24); ?> <html> <body> ... ... ``` ### 例子 2 检索 cookie 值的不同方法： ``` <html> <body> <?php // 输出个别的 cookie echo $_COOKIE["TestCookie"]; echo "<br />"; echo $HTTP_COOKIE_VARS["TestCookie"]; echo "<br />"; // 输出所有 cookie print_r($_COOKIE); ?> </body> </html> ``` 输出： ``` my cookie value my cookie value Array ([TestCookie] => my cookie value) ``` ### 例子 3 通过把失效日期设置为过去的日期/时间，删除一个 cookie： ``` <?php // 把失效日期设置为一小时前 setrawcookie ("TestCookie", "", time() - 3600); ?> <html> <body> ... ... ``` ### 例子 4 创建一个数组 cookie： ``` <?php setrawcookie("cookie[three]","cookiethree"); setrawcookie("cookie[two]","cookietwo"); setrawcookie("cookie[one]","cookieone"); // 输出 cookie （在重载页面后） if (isset($_COOKIE["cookie"])) { foreach ($_COOKIE["cookie"] as $name => $value) { echo "$name : $value <br />"; } } ?> <html> <body> ... ... ``` 输出： ``` three : cookiethree two : cookietwo one : cookieone ```