萬盛學電腦網

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

PHP 實用函數:文本轉 HTML 與獲取客戶端 IP

前言

在 PHP 開發中,經常需要將純文本轉換為安全的 HTML 格式,以及準確獲取訪客的真實 IP 地址。本文提供兩個現成的函數 Text2Html() 與 GetIP(),並詳細解析其運作邏輯,方便直接引用至專案中。

1. Text2Html() —— 文本轉 HTML 安全輸出

此函數將用戶輸入的純文本轉換為可在網頁安全顯示的 HTML,主要處理以下三項:

  • 將全形空格   還原為普通空格
  • 將 <、> 轉換為 HTML 實體 &lt;、&gt;,防止 XSS
  • 將換行符(\r、\n)替換為 <br/> 標籤

程式碼實作

/**
 * 文本轉 HTML
 * @param string $txt 待處理的文本
 * @return string 處理後的 HTML 字符串
 */
function Text2Html($txt) {
    $txt = str_replace(" ", " ", $txt);
    $txt = str_replace("<", "&lt;", $txt);
    $txt = str_replace(">", "&gt;", $txt);
    $txt = preg_replace("/[\r\n]{1,}/isU", "<br/>\r\n", $txt);
    return $txt;
}

使用範例

$input = "測試<script>alert(1)</script>\n第二行";
echo Text2Html($input);
// 輸出:測試&lt;script&gt;alert(1)&lt;/script&gt;<br/>
// 第二行

2. GetIP() —— 穿透代理獲取真實 IP

由於訪客可能經過 CDN、負載均衡或代理伺服器,單靠 $_SERVER['REMOTE_ADDR'] 往往無法取得真實 IP。本函數依優先順序檢查以下 Header:

  1. HTTP_CLIENT_IP(部分代理設置)
  2. HTTP_X_FORWARDED_FOR(標準代理 Header,可能包含多個 IP,取第一個)
  3. REMOTE_ADDR(直接連線時的 IP)

最後以正則 /[\d.]{7,15}/ 擷取符合 IPv4 格式的字串,若無匹配則回傳 unknown。

程式碼實作

/**
 * 獲取客戶端真實 IP
 * @return string IP 字符串或 'unknown'
 */
function GetIP() {
    if (!empty($_SERVER["HTTP_CLIENT_IP"])) {
        $cip = $_SERVER["HTTP_CLIENT_IP"];
    } elseif (!empty($_SERVER["HTTP_X_FORWARDED_FOR"])) {
        $cip = $_SERVER["HTTP_X_FORWARDED_FOR"];
    } elseif (!empty($_SERVER["REMOTE_ADDR"])) {
        $cip = $_SERVER["REMOTE_ADDR"];
    } else {
        $cip = "";
    }
    preg_match("/[\d.]{7,15}/", $cip, $cips);
    $cip = $cips[0] ? $cips[0] : 'unknown';
    unset($cips);
    return $cip;
}

注意事項

  • HTTP_X_FORWARDED_FOR 可被偽造,關鍵業務(如登入驗證、風控)建議配合可信代理清單驗證。
  • IPv6 環境下,正則需擴展支援 : 字符。

總結

將這兩個函數放入通用工具類或 Helper 文件中,即可在專案任何處呼叫,提升開發效率與安全性。

copyright © 萬盛學電腦網 all rights reserved