萬盛學電腦網

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

PHP 過濾非法字符:htmlspecialchars 與 html_entity_decode 完整指南

前言

在 Web 開發中,處理使用者輸入的字串時,防止跨站腳本攻擊(XSS)是基礎也是關鍵。PHP 內建的 htmlspecialchars() 與 html_entity_decode() 兩個函數,分別負責將特殊字元轉換為 HTML 實體、以及將實體還原為原始字元,是表單處理、資料輸出時的必備工具。

htmlspecialchars():將特殊字元轉為 HTML 實體

此函數會把下列字元轉換為對應的 HTML 實體,避免瀏覽器將其解析為標籤或屬性:

  • &(和號) → &
  • "(雙引號) → "
  • <(小於號) → &lt;
  • >(大於號) → &gt;

注意: 它只轉換上述四個字元,不會將所有字元轉為 ASCII 碼。

程式碼範例

<?php
$str = "<a >fdafsa''&#x</a>";
echo htmlspecialchars($str);
// 輸出:&lt;a &gt;fdafsa''&#x&lt;/a&gt;
?>

html_entity_decode():將 HTML 實體還原為字元

此函數與 htmlspecialchars()、htmlentities() 搭配使用,可將先前轉換的實體還原為原始字串,常用於資料庫存儲後的再次顯示或編輯。

程式碼範例

<?php
$encoded = "&lt;a &gt;test&lt;/a&gt;";
$decoded = html_entity_decode($encoded);
echo $decoded; // 輸出:<a >test</a>
?>

最佳實務建議

  1. 輸出時轉義: 在將變數輸出到 HTML 內容、屬性、JavaScript 時,務必使用 htmlspecialchars($var, ENT_QUOTES, 'UTF-8')。
  2. 儲存原始資料: 資料庫建議存儲未轉義的原始字串,僅在輸出時轉義,避免重複轉義導致顯示異常。
  3. 指定編碼: 永遠明確指定第三個參數為 'UTF-8'(或對應編碼),防止多語言環境下出現亂碼。

常見錯誤與避坑指南

錯誤情境後果正確做法
直接輸出未轉義的使用者輸入XSS 攻擊風險輸出前呼叫 htmlspecialchars()
對已轉義字串再次呼叫 htmlspecialchars()顯示 &amp;lt; 等雙重編碼僅在最終輸出時轉義一次
使用 htmlentities() 卻未指定編碼中文等非 ASCII 字元被轉為實體,導致資料膨脹改用 htmlspecialchars() 或指定編碼

總結

掌握 htmlspecialchars() 與 html_entity_decode() 的正確用法,是 PHP 開發者防範 XSS、確保資料完整顯示的基本功。記住「輸出時轉義、儲存原始資料、指定編碼」三原則,即可構建更安全的 Web 應用程式。

copyright © 萬盛學電腦網 all rights reserved