如何安全高效地在 Cookie 中存储多语言翻译数据-php教程-PHP中文网

如何安全高效地在 Cookie 中存储多语言翻译数据

本文讲解如何正确将 PHP 翻译数组序列化后存入 Cookie，并避免因错误返回值导致的 ERR_INVALID_RESPONSE；同时指出该方案的性能隐患，并提供更合理的替代实践。

本文讲解如何正确将 php 翻译数组序列化后存入 cookie，并避免因错误返回值导致的 `err_invalid_response`；同时指出该方案的性能隐患，并提供更合理的替代实践。

在 Web 多语言支持中，将翻译数据缓存至客户端（如 Cookie）看似能减少服务端文件包含开销，但实现不当极易引发严重问题。你遇到的 ERR_INVALID_RESPONSE 错误，根源在于 en.php 中使用了 return json_encode($translation); —— 这会导致 PHP 脚本直接输出 JSON 字符串并终止执行，而 require_once() 在被调用时若脚本以 return 结束，其返回值为 null 或未定义行为，后续 json_encode(null) 会生成无效内容，最终污染 HTTP 响应头，触发浏览器拒绝解析。

✅ 正确做法是：移除 return 语句，仅定义 $translation 数组，让 require_once() 正常返回数组变量：

// en.php（修正后）
$translation = [
    "home" => ["title" => "Home"],
    "contact" => ["title" => "Contact"],
];
// 不加 return！也不输出任何内容（无空格、无 BOM、无 echo）

然后在 header.php 中统一处理编码与写入：

if (!isset($_COOKIE['translation']) && !isset($_GET['lang'])) {
    require_once('en.php'); // 此时 $translation 已被定义
    $jsonEncodedTranslation = json_encode($translation, JSON_UNESCAPED_UNICODE);
    setcookie('translation', $jsonEncodedTranslation, [
        'expires' => time() + 86400,
        'path'    => '/',
        'domain'  => '', // 根据需要设置
        'secure'  => false, // 生产环境建议设为 true（HTTPS）
        'httponly'=> true,  // 防 XSS，推荐启用
        'samesite'=> 'Lax'
    ]);
    $_COOKIE['translation'] = $jsonEncodedTranslation;
} elseif (isset($_GET['lang']) && preg_match('/^[a-z]{2}$/', $_GET['lang'])) {
    $langFile = $_GET['lang'] . '.php';
    if (file_exists($langFile)) {
        require_once($langFile);
        $jsonEncodedTranslation = json_encode($translation, JSON_UNESCAPED_UNICODE);
        setcookie('translation', $jsonEncodedTranslation, [
            'expires' => time() + 86400,
            'path'    => '/',
            'httponly'=> true,
            'samesite'=> 'Lax'
        ]);
        $_COOKIE['translation'] = $jsonEncodedTranslation;
    }
}

// 安全解码（需校验 Cookie 是否存在且非空）
if (isset($_COOKIE['translation']) && !empty($_COOKIE['translation'])) {
    $decoded = json_decode($_COOKIE['translation']);
    if (json_last_error() === JSON_ERROR_NONE && is_object($decoded)) {
        echo htmlspecialchars($decoded->home->title, ENT_QUOTES, 'UTF-8');
    } else {
        error_log("Invalid translation cookie JSON");
        echo 'Home'; // fallback
    }
} else {
    echo 'Home';
}

⚠️ 重要注意事项：

NotebookLM CLI Cookies

使用 nlm CLI 检索并回答已上传至 NotebookLM 的文档问题。适用于用户需要查找信息、总结来源或查询特定笔记本时。

下载

Cookie 大小限制：HTTP Cookie 单个值通常限制在 4KB 内。大型翻译文件（如含百条以上词条）极易超限，导致写入失败或截断。
安全风险：直接拼接 $_GET['lang'] 构造文件名属典型路径遍历漏洞（如 ?lang=../etc/passwd），必须严格白名单校验（如正则 /^[a-z]{2}$/）或映射到预定义语言列表。
性能反模式：每次请求需传输完整翻译 JSON（可能数 KB），显著增加请求头体积；且服务端需反复 json_decode()，不如直接 require 静态 PHP 数组（PHP OPcache 可高效缓存已编译脚本）。
缓存与更新问题：Cookie 过期后用户仍可能看到旧翻译，且无法主动刷新所有客户端缓存。

? 更优实践建议：