萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP Cookie 名稱含點號會被自動轉為底線的機制與影響

設定 $_COOKIE['my.name'] = 1 後,實際在 `$_COOKIE` 超全域陣列中鍵名會變成 my_name。這不是 Bug,而是 PHP 為了相容舊版 register_globals 機制而刻意設計的行為。本文深入解析原因、影響與最佳實踐。

現象複現

<?php
setcookie('my.name', 'value', time() + 3600);
// 下一次請求時
var_dump($_COOKIE['my.name']); // NULL
var_dump($_COOKIE['my_name']); // 'value'
?>

歷史緣由:register_globals 的陰影

PHP 4.2 以前預設開啟 register_globals = On,會將 $_GET、$_POST、$_COOKIE 等超全域變數自動註冊為全域變數(如 `$my_name`)。

  • 變數命名規則:只能包含字母、數字、底線,且不得以數字開頭。
  • Cookie 名稱若含點號(my.name),對應變數 `$my.name` 為非法語法。
  • 為避免衝突,PHP 內部將「非法字元(含點號、空格、中括號等)統一轉為底線」後再註冊為全域變數。

雖然 register_globals 已於 PHP 5.4 移除,但此轉換行為為保持向後相容而保留至今。

影響範圍

  • 僅影響鍵名在 `$_COOKIE`、`$_GET`、`$_POST`、`$_REQUEST`、$_SERVER 中的呈現,實際 HTTP Cookie 標頭傳輸的原始名稱(my.name)不變。
  • JavaScript document.cookie 讀寫不受影響,仍可操作 my.name。
  • 若後端用 $_COOKIE['my.name'] 讀取永遠取不到值,易造成除錯困擾。

最佳實踐

  1. 命名規範:Cookie、GET/POST 參數名統一使用底線(snake_case),避免點號、連字號、中括號。
  2. 讀取時統一轉換:若必須支援舊版含點號的 Cookie,可在入口處統一正規化:
    <?php
    function normalizeCookieKeys(array &$cookies): void
    {
        foreach ($cookies as $key => $val) {
            $newKey = str_replace('.', '_', $key);
            if ($newKey !== $key) {
                $cookies[$newKey] = $val;
            }
        }
    }
    normalizeCookieKeys($_COOKIE);
    ?>
  3. 勿依賴 `register_globals` 行為:代碼審查時禁止直接使用 `$var` 接收外部輸入,強制使用 `$_GET['var']` 等超全域陣列。

補充:`register_globals` 的危害回顧

<?php
// 舊代碼風險範例
if ($is_admin) { ... } // 攻擊者傳 ?is_admin=1 即可繞過
?>

此機制導致變數來源模糊、極易被覆寫,現代 PHP 已徹底移除。理解 Cookie 鍵名轉換的歷史背景,有助於避免遺留系統遷移時的坑。

copyright © 萬盛學電腦網 all rights reserved