PHP setrawcookie() 函数

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

从 PHP 7.3.0 开始，支持数组参数格式：

setrawcookie ( string $name , string $value = "" , array $options = [] ) : bool

<?php
// 设置原始 Cookie
$cookie_name = "raw_data";
$cookie_value = "Hello World!"; // 不会进行 URL 编码
$expiry_time = time() + (60 * 60); // 1小时后过期

if (setrawcookie($cookie_name, $cookie_value, $expiry_time)) {
    echo "原始 Cookie '$cookie_name' 已设置成功。\n";
} else {
    echo "设置原始 Cookie 失败。\n";
}

// 对比 setcookie() 的行为
$encoded_value = "Hello World!";
setcookie("encoded_data", $encoded_value, $expiry_time);

echo "setrawcookie() 发送的值: $cookie_value\n";
echo "setcookie() 发送的值会被编码，实际存储: " . urlencode($encoded_value) . "\n";
?>

<?php
// 准备 JSON 数据
$user_data = [
    'id' => 123,
    'name' => '张三',
    'email' => 'zhangsan@example.com',
    'preferences' => ['theme' => 'dark', 'language' => 'zh-CN']
];

$json_string = json_encode($user_data, JSON_UNESCAPED_UNICODE);

// 使用 setrawcookie() 存储 JSON
setrawcookie('user_json', $json_string, time() + (86400 * 7), '/');

// 对比：如果使用 setcookie()，JSON 中的特殊字符会被编码
setcookie('user_json_encoded', $json_string, time() + (86400 * 7), '/');

echo "JSON 数据已存储到 Cookie。\n";
echo "原始 JSON: " . $json_string . "\n\n";

// 读取 Cookie
if (isset($_COOKIE['user_json'])) {
    $decoded_data = json_decode($_COOKIE['user_json'], true);
    echo "从原始 Cookie 读取的数据:\n";
    print_r($decoded_data);
}

// 注意：由于 Cookie 是浏览器发送的，特殊字符可能需要处理
function safe_json_cookie($name, $value, $expires = 0, $path = '/') {
    // 确保 JSON 字符串是有效的
    if (json_decode($value) === null && json_last_error() !== JSON_ERROR_NONE) {
        return false;
    }

    // 使用 setrawcookie 存储原始 JSON
    return setrawcookie($name, $value, $expires, $path);
}
?>

<?php
// 假设有一些二进制数据（例如加密后的数据）
$binary_data = random_bytes(32); // 32字节的随机数据
$base64_data = base64_encode($binary_data);

// 使用 setrawcookie() 存储 Base64 编码的数据
// 注意：Base64 编码可能包含 '+'、'/'、'=' 等字符
if (setrawcookie('encrypted_data', $base64_data, time() + 3600, '/')) {
    echo "Base64 编码数据已存储到 Cookie。\n";
    echo "Base64 字符串: " . $base64_data . "\n";

    // 解码验证
    $decoded = base64_decode($base64_data);
    echo "解码后长度: " . strlen($decoded) . " 字节\n";
} else {
    echo "存储失败。\n";
}

// 安全注意事项：Base64 字符串可能包含 '=' 填充字符
// 这些字符在 Cookie 中是安全的，但某些旧系统可能有问题
function safe_base64_cookie($name, $data, $expires = 0, $path = '/') {
    // 对 Base64 进行 URL 安全的编码（替换 '+' 和 '/'）
    $base64_url = str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($data));

    return setrawcookie($name, $base64_url, $expires, $path);
}

// 使用安全版本
$secure_data = "敏感数据需要加密存储";
safe_base64_cookie('secure_cookie', $secure_data, time() + 3600, '/');
?>

<?php
// 需要包含特殊字符的值
$special_value = "Line 1\nLine 2\tTab"; // 包含换行符和制表符

// 这些字符会破坏 HTTP 头，需要处理
$safe_value = str_replace(["\n", "\r", "\t"], ['\\n', '\\r', '\\t'], $special_value);

if (setrawcookie('multiline_data', $safe_value, time() + 3600, '/')) {
    echo "包含特殊字符的数据已安全存储。\n";
    echo "原始值: " . addcslashes($special_value, "\n\r\t") . "\n";
    echo "存储值: " . $safe_value . "\n";
}

// 读取时反向处理
if (isset($_COOKIE['multiline_data'])) {
    $restored_value = str_replace(['\\n', '\\r', '\\t'], ["\n", "\r", "\t"], $_COOKIE['multiline_data']);
    echo "恢复的值:\n" . $restored_value . "\n";
}

// 更通用的编码函数
function encode_cookie_value($value) {
    // 对可能破坏 HTTP 头的字符进行编码
    $search = ["\n", "\r", "\t", ";", ","];
    $replace = ['%0A', '%0D', '%09', '%3B', '%2C'];

    return str_replace($search, $replace, $value);
}

function decode_cookie_value($value) {
    $search = ['%0A', '%0D', '%09', '%3B', '%2C'];
    $replace = ["\n", "\r", "\t", ";", ","];

    return str_replace($search, $replace, $value);
}

// 使用编码函数
$encoded = encode_cookie_value("Value;with,special\nchars");
setrawcookie('encoded_cookie', $encoded, time() + 3600, '/');
?>