萬盛學電腦網

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

PHP 取得客戶端真實 IP 與完整 URL 的實用函式

前言

在 Web 開發中,記錄訪客 IP 與目前請求的完整 URL 是常見需求。但由於 Proxy、Load Balancer、CDN 等中間層存在,單靠 $_SERVER['REMOTE_ADDR'] 往往無法取得真實客戶端 IP。本文提供兩個可直接使用的函式,分別處理 IP 偵測與 URL 組裝。

1. 取得客戶端 IP(支援 Proxy 與 CDN)

function getOnlineIP() {
    if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
        $onlineIP = $_SERVER['HTTP_CLIENT_IP'];  // 直接由 Proxy 轉發
    } elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $onlineIP = $_SERVER['HTTP_X_FORWARDED_FOR'];  // 可能包含多個 IP,取第一個
    } else {
        $onlineIP = $_SERVER['REMOTE_ADDR'];  // 直接連線或無轉發標頭
    }
    return $onlineIP;
}

注意: HTTP_X_FORWARDED_FOR 格式為 client, proxy1, proxy2...,若需嚴謹驗證,建議搭配可信 Proxy 白名單並取第一個非私有 IP。

2. 取得完整請求 URL

function curPageURL() {
    $pageURL = 'http';
    if (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on') {
        $pageURL .= 's';
    }
    $pageURL .= '://';
    if ($_SERVER['SERVER_PORT'] != '80') {
        $pageURL .= $_SERVER['SERVER_NAME'] . ':' . $_SERVER['SERVER_PORT'] . $_SERVER['REQUEST_URI'];
    } else {
        $pageURL .= $_SERVER['SERVER_NAME'] . $_SERVER['REQUEST_URI'];
    }
    return $pageURL;
}

自動偵測 HTTPS、非標準埠號,組合出完整絕對網址。

使用範例

$ip  = getOnlineIP();
$url = curPageURL();
echo "訪客 IP:$ip
目前網址:$url";

進階提示

  • 若使用 Nginx + PHP-FPM,確認 fastcgi_param 有正確傳遞 HTTP_X_FORWARDED_FOR 與 HTTPS。
  • 搭配 filter_var($ip, FILTER_VALIDATE_IP) 做格式驗證。
  • 若專案採用 PSR-7,可直接從 ServerRequestInterface 取得屬性,更符合現代框架慣例。
copyright © 萬盛學電腦網 all rights reserved