萬盛學電腦網

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

PHP magic_quotes_gpc 歷史遺毒:為什麼 ini_set 無效與正確清洗方案

現象重現

頁面輸出出現多餘反斜桿:\"用戶輸入\" 變成 \\\"用戶輸入\\\"。檢查代碼發現入口文件已寫:

ini_set('magic_quotes_gpc', 'Off'); // 看似關閉了

**但完全不生效!** 原因在於 **PHP 生命週期機制**。

核心原理:請求生命週期階段

  1. RINIT (請求初始化):PHP 引擎啟動,**解析 $_GET/$_POST/$_COOKIE/$_REQUEST**,**此時依據 php.ini 中的 magic_quotes_gpc=On 自動對所有輸入字符串執行 addslashes()** (轉義單雙引號、反斜桿、NULL)
  2. 執行用戶腳本:你的 index.php 開始跑,此時 ini_set('magic_quotes_gpc', 'Off') 執行,**但請求數據已被污染**
  3. RSHUTDOWN:請求結束

結論:magic_quotes_gpc 是 **PHP_INI_PERDIR** 級別配置,**只能在 php.ini / .htaccess / httpd.conf / .user.ini 中設定**,**運行時 ini_set 無效** (官方文檔明確註明)。

歷史背景:為什麼有這個爛功能?

  • PHP 早期 (4.x/5.0) 為防 SQL 注入,「貼心」自動對 GPC (Get/Post/Cookie) 數據 addslashes()
  • **副作用**:雙重轉義 (開發者又手動 mysql_real_escape_string)、非資料庫輸出也被轉義、JSON/XML 輸出亂碼、二進制數據損壞
  • **PHP 5.4.0 正式移除** 此功能 (連配置項都不存在了)

正確解決方案 (按優先級)

方案一:修改配置文件 (根治,推薦)

; php.ini (生效需重啟 PHP-FPM/Apache)
magic_quotes_gpc = Off

; 或 .htaccess (Apache 模塊模式)
php_flag magic_quotes_gpc Off

; 或 .user.ini (PHP-FPM / CGI 模式,無需重啟主進程,目錄級生效)
magic_quotes_gpc = Off

方案二:入口文件極早期清洗 (不改配置時的應急/共享主機方案)

**必須在所有代碼之前、任何框架啟動之前**執行 (如 public/index.php 第一行):

<?php
/**
 * 遞歸清洗 GPC 超全局數組的 magic_quotes 污染
 * 僅在 magic_quotes_gpc 實際開啟時執行 (PHP 5.4+ 恆為 false)
 */
if (function_exists('get_magic_quotes_gpc') && get_magic_quotes_gpc()) {
    function stripslashes_deep(mixed $value): mixed
    {
        if (is_string($value)) {
            return stripslashes($value);
        }
        if (is_array($value)) {
            foreach ($value as $key => $val) {
                $value[$key] = stripslashes_deep($val);
            }
            return $value;
        }
        return $value; // 數字、布爾、null、物件不處理
    }

    // 清洗超全局變量 (注意:$_REQUEST 通常是 $_GET+$_POST+$_COOKIE 合併,清洗前三個即可)
    $_GET     = stripslashes_deep($_GET);
    $_POST    = stripslashes_deep($_POST);
    $_COOKIE  = stripslashes_deep($_COOKIE);
    // $_REQUEST 會自動反映變化 (PHP 內部機制),但為保險可重新賦值
    $_REQUEST = array_merge($_GET, $_POST, $_COOKIE); 
}
?>

方案三:框架/中間件層統一處理 (現代框架已內建)

  • **Laravel** : Illuminate\Foundation\Http\Middleware\TrimStrings + ConvertEmptyStringsToNull (不處理 magic_quotes 因要求 PHP 7.2+ 已移除)
  • **Symfony** : Request::createFromGlobals() 內部處理
  • **Yii2** : Request::load() 內部處理
  • **ThinkPHP** : 核心啟動階段清洗

**若使用現代框架 (要求 PHP 7.2+),完全無需擔心此問題,功能已從語言層面移除。**

驗證清洗是否生效

<?php
// 測試腳本 test_mq.php
echo "magic_quotes_gpc: " . (get_magic_quotes_gpc() ? 'On' : 'Off') . "\n";
echo "_GET['test']: " . ($_GET['test'] ?? 'not set') . "\n";
echo "_POST['test']: " . ($_POST['test'] ?? 'not set') . "\n";

// 瀏覽器訪問:test_mq.php?test=O'Reilly
// 未清洗輸出:O\'Reilly
// 清洗後輸出:O'Reilly
?>

避坑指南

誤區後果正確做法
用 ini_set 關閉無效,污染已發生改 php.ini/.htaccess/.user.ini
只清洗 $_POST$GET/$_COOKIE 仍污染清洗 $_GET/$_POST/$_COOKIE 三者
對物件/資源類型執行 stripslashes報錯/破壞物件遞歸函數僅處理 string/array
清洗後又手動 addslashes 存資料庫雙重轉義,資料庫存入反斜桿**棄用 addslashes,改用參數化查詢 (PDO Prepared Statements)**
以為 PHP 7/8 還有這功能代碼檢測邏輯失效PHP 5.4+ 已移除,get_magic_quotes_gpc() 恆回 false

現代資料庫交互:徹底告別 addslashes/magic_quotes

<?php
// PDO 參數化查詢:驅動層處理轉義,完全隔離 SQL 與數據
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass');
$stmt = $pdo->prepare('SELECT * FROM users WHERE name = ? AND status = ?');
$stmt->execute([$_GET['name'] ?? '', 1]); // 直接傳入原始輸入,無需任何轉義
$user = $stmt->fetch();

// 批量插入
$data = [['name' => "O'Reilly", 'email' => 'test@example.com'], ...];
$stmt = $pdo->prepare('INSERT INTO users (name, email) VALUES (?, ?)');
$pdo->beginTransaction();
foreach ($data as $row) {
    $stmt->execute([$row['name'], $row['email']]);
}
$pdo->commit();
?>

結語

magic_quotes_gpc 是 PHP 歷史上**最糟糕的設計決策之一**,已被徹底移除。**現代 PHP (7.2+) 專案零風險**。維護舊專案 (PHP 5.3-) 時,**務必在配置層面關閉**,或**入口極早期遞歸清洗三大超全局數組**,並**全面遷移至 PDO 參數化查詢**,從根源斷開「轉義」與「安全」的錯誤綁定。

copyright © 萬盛學電腦網 all rights reserved