萬盛學電腦網

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

PHP addslashes 與 stripslashes 深度解析:魔術引號時代的遺產與現代最佳實踐

歷史背景:魔術引號的興衰

magic_quotes_gpc 是 PHP 早期(< 5.4)為防 SQL 注入引入的「自動轉義」機制:自動對 $_GET/$_POST/$_COOKIE 的單引號、雙引號、反斜線、NULL 字元加反斜線。這導致開發者在不知情下重複轉義,資料庫存入 O\'Reilly,輸出又需 stripslashes() 還原,極易混淆。PHP 5.4 完全移除此功能,現代框架均不再依賴。

兩個函數的核心差異

函數操作方向轉換規則主要用途
addslashes()編碼/轉義'→\', "→\", \→\\, \0→\0舊式 SQL 字串拼接(已棄用)
stripslashes()解碼/還原移除上述反斜線(保留非轉義反斜線)修正魔術引號重複轉義

為什麼 addslashes() 不能防 SQL 注入?

<?php
// 看似安全實則危險
$name = "O'Reilly'; DROP TABLE users; --";
$sql = "SELECT * FROM users WHERE name = '" . addslashes($name) . "'";
// 產生:SELECT * FROM users WHERE name = 'O\'Reilly\'; DROP TABLE users; --'
?>

addslashes() 僅處理單引號,無法應對:

  • 多位元組編碼繞過(GBK/Big5 字元尾字節 0x5c 被吃掉)
  • 數值型注入(無引號包裹)
  • 編碼不一致導致的邊界繞過

現代最佳實踐:參數化查詢(Prepared Statements)

<?php
// PDO 範例(推薦)
$stmt = $pdo->prepare('SELECT * FROM users WHERE name = :name AND status = :status');
$stmt->execute(['name' => $name, 'status' => 1]);
$users = $stmt->fetchAll();

// MySQLi 範例
$stmt = $mysqli->prepare('SELECT * FROM users WHERE name = ? AND status = ?');
$stmt->bind_param('si', $name, $status);
$stmt->execute();
$result = $stmt->get_result();
?>

核心原則:資料與代碼分離。參數化查詢讓資料庫引擎在解析 SQL 結構前先綁定參數,從根源杜絕注入,無需任何手動轉義。

何時仍需用到 addslashes/stripslashes?

  1. 維護舊專案:無法立即重構參數化查詢的歷史代碼
  2. 非 SQL 場景:生成 JavaScript 字串字面量、Shell 命令參數(建議用 escapeshellarg())、LDAP 查詢(ldap_escape())
  3. 序列化資料處理:某些老舊序列化格式需要反斜線保護

正確的「雙重轉義」修正邏輯

<?php
/**
 * 智慧型還原:僅在魔術引號開啟且資料已被 addslashes 處理時才 stripslashes
 * 現代環境(magic_quotes_gpc 已移除)通常不需要
 */
function smartStripslashes(string $value): string
{
    // PHP 5.4+ 永遠回傳 false,此判斷僅為相容極舊環境
    if (function_exists('get_magic_quotes_gpc') && get_magic_quotes_gpc()) {
        // 只有確定資料經過 addslashes() 才還原
        // 實務上難以自動判斷,建議明確標記來源
        return stripslashes($value);
    }
    return $value;
}

// 更好的做法:在輸入層統一正規化
function normalizeInput(array $input): array
{
    array_walk_recursive($input, function (&$value) {
        if (is_string($value)) {
            // 移除魔術引號殘留(若有)
            if (function_exists('get_magic_quotes_gpc') && get_magic_quotes_gpc()) {
                $value = stripslashes($value);
            }
            // 統一編碼、修剪等
            $value = trim($value);
        }
    });
    return $input;
}
?>

常見誤區對照

誤區正確認知
addslashes() 能防 SQL 注入不能,請用參數化查詢
magic_quotes_gpc=On 時不用管會導致雙重轉義,必須在輸入層 stripslashes()
stripslashes() 等同 str_replace('\\\\', '', $str)不等同,stripslashes() 只移除「轉義用」反斜線,保留字面反斜線
輸出 HTML 時用 stripslashes()錯誤,HTML 輸出應用 htmlspecialchars()
JSON 資料要 addslashes()錯誤,JSON 用 json_encode() 自動處理

編碼與輸出的正確分層

<?php
// 輸入層:正規化(移除魔術引號殘留、trim、編碼驗證)
$input = normalizeInput($_POST);

// 業務層:參數化查詢存入資料庫(完全不需要 addslashes)
$stmt = $pdo->prepare('INSERT INTO articles (title, content) VALUES (?, ?)');
$stmt->execute([$input['title'], $input['content']]);

// 輸出層:根據輸出語境編碼
// HTML 語境
echo '

' . htmlspecialchars($article['title'], ENT_QUOTES, 'UTF-8') . '

'; // JavaScript 語境(內聯 script 標籤) echo ''; // URL 參數語境 echo '連結'; // Shell 命令語境(極度謹慎) $cmd = 'convert ' . escapeshellarg($input['image_path']) . ' output.png'; ?>

總結

addslashes()/stripslashes() 是 PHP 早期缺乏參數化查詢時的權宜之計,現代開發完全不應用於 SQL 防注入。掌握輸入正規化 → 參數化查詢 → 語境感知輸出編碼三層防線,才是資料安全的正道。若維護舊代碼,請在輸入統一入口處理魔術引號殘留,其餘邏輯全面遷移至參數化查詢。

copyright © 萬盛學電腦網 all rights reserved