magic_quotes_gpc 是 PHP 早期(< 5.4)為防 SQL 注入引入的「自動轉義」機制:自動對 $_GET/$_POST/$_COOKIE 的單引號、雙引號、反斜線、NULL 字元加反斜線。這導致開發者在不知情下重複轉義,資料庫存入 O\'Reilly,輸出又需 stripslashes() 還原,極易混淆。PHP 5.4 完全移除此功能,現代框架均不再依賴。
| 函數 | 操作方向 | 轉換規則 | 主要用途 |
|---|---|---|---|
addslashes() | 編碼/轉義 | '→\', "→\", \→\\, \0→\0 | 舊式 SQL 字串拼接(已棄用) |
stripslashes() | 解碼/還原 | 移除上述反斜線(保留非轉義反斜線) | 修正魔術引號重複轉義 |
<?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() 僅處理單引號,無法應對:
<?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 結構前先綁定參數,從根源杜絕注入,無需任何手動轉義。
escapeshellarg())、LDAP 查詢(ldap_escape())<?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 防注入。掌握輸入正規化 → 參數化查詢 → 語境感知輸出編碼三層防線,才是資料安全的正道。若維護舊代碼,請在輸入統一入口處理魔術引號殘留,其餘邏輯全面遷移至參數化查詢。