所有來自 $_GET、$_POST、$_COOKIE、$_REQUEST、$_SERVER、數據庫、第三方 API、文件讀取的數據,均視為**不可信**,必須在**使用前**根據上下文進行過濾/轉義/驗證。
PDO::prepare() / mysqli_prepare()。禁用 addslashes()、mysql_real_escape_string()(已移除)。escapeshellarg()(單個參數)、escapeshellcmd()(整條命令)。嚴禁直接拼接用戶輸入進 exec()/shell_exec()。basename() + realpath() 限制在允許目錄內。核心原則:**在輸出時根據上下文編碼**,而非輸入時過濾。
| 輸出上下文 | 編碼函數 | 示例 |
|---|---|---|
| HTML 內容/屬性 | htmlspecialchars($str, ENT_QUOTES, 'UTF-8') | <div>= h($user->name) ?></div> |
| JavaScript 字符串 | json_encode($str)(含引號) | const name = = json_encode($user->name) ?>; |
| URL 參數值 | urlencode($str) / rawurlencode() | <a href="?q== urlencode($kw) ?>> |
| CSS 值 | 專用編碼器 | 避免直接輸出用戶數據進 CSS |
| HTML 原樣輸出(富文本) | HTMLPurifier 白名單過濾 | 允許 <b><i><a> 等安全標籤 |
<?php
// 通用 HTML 轉義助手
function h(string $str, int $flags = ENT_QUOTES | ENT_SUBSTITUTE, string $encoding = 'UTF-8'): string {
return htmlspecialchars($str, $flags, $encoding);
}
// JS 字符串輸出助手
function js(string $str): string {
return json_encode($str, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT);
}
?>
在控制器/服務層,對業務字段進行**格式、範圍、枚舉**驗證:
<?php
// 郵箱驗證
$email = filter_var($_POST['email'] ?? '', FILTER_VALIDATE_EMAIL);
if (!$email) throw new Exception('郵箱格式無效');
// 枚舉白名單
$allowedStatus = ['draft', 'published', 'archived'];
$status = $_POST['status'] ?? 'draft';
if (!in_array($status, $allowedStatus, true)) {
throw new Exception('無效狀態值');
}
// 數字範圍
$age = filter_var($_POST['age'] ?? '', FILTER_VALIDATE_INT, ['options' => ['min_range' => 1, 'max_range' => 120]]);
if ($age === false) throw new Exception('年齡無效');
// 文件上傳:MIME + 擴展名雙重驗證
$allowedMimes = ['image/jpeg', 'image/png', 'application/pdf'];
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $_FILES['file']['tmp_name']);
if (!in_array($mime, $allowedMimes)) throw new Exception('文件類型不允許');
參考文章中的 dispatch.php 模式與 security.inc 包含模式,現代框架(Laravel、Symfony、ThinkPHP)均內置:
| 誤區 | 後果 | 正確做法 |
|---|---|---|
用 addslashes() 防 SQL 注入 | 多字節編碼繞過、編碼不一致、已棄用 | PDO 預處理語句 |
開啟 magic_quotes_gpc | 污染全局數據、雙重轉義、PHP 5.4 已移除 | 絕不開啟,手動控制 |
strip_tags() 防 XSS | 屬性注入繞過(onclick=...)、破壞合法 HTML | 輸出時 htmlspecialchars() 或 HTMLPurifier |
入庫前 htmlspecialchars() | 數據污染、重複編碼、搜索/統計失效 | 原始數據入庫,輸出時編碼 |
依賴 empty() 檢查函數返回值 | PHP < 5.5 致命錯誤,語義混淆 | 先賦值變量再 empty($var) |
FormRequest 類集中聲明規則,自動重定向攜帶錯誤。{{ $var }} 自動 htmlspecialchars,{!! $var !!} 故意輸出原始 HTML(需極謹慎)。JsonResource 統一序列化輸出,避免手動 json_encode 遺漏編碼。if ($user->can(...))。PHP 安全防護的核心是**「上下文感知的輸出編碼」+「預處理語句」+「業務白名單驗證」**。拒絕「全局神奇過濾函數」,擁抱分層防禦:Web 服務器層(ModSecurity/WAF)→ 框架中間件 → 控制器驗證 → 模板自動編碼 → 數據庫參數化。安全是系統工程,而非單一函數調用。