萬盛學電腦網

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

PHP 獲取客戶端 IP 並調用 API 解析地理位置(含新浪/ip138 接口實戰)

第一步:穩健獲取客戶端真實 IP

代理、CDN、負載均衡環境下,$_SERVER['REMOTE_ADDR'] 往往是代理 IP。需按優先級檢查多個頭部:

<?php
/**
 * 獲取客戶端真實 IP
 * @return string IPv4 地址或 'unknown'
 */
function getClientIp(): string {
    $ipKeys = [
        'HTTP_CLIENT_IP',        // 標準代理頭
        'HTTP_X_FORWARDED_FOR',  // 標準代理鏈(可能包含多個 IP,取第一個)
        'HTTP_X_REAL_IP',        // Nginx proxy_set_header 設置
        'REMOTE_ADDR',           // 直接連接或最後一級代理
    ];

    foreach ($ipKeys as $key) {
        if (!empty($_SERVER[$key])) {
            // HTTP_X_FORWARDED_FOR 可能包含 "client, proxy1, proxy2",取首個
            $ips = explode(',', $_SERVER[$key]);
            $ip = trim($ips[0]);
            
            // 簡單合法性校驗
            if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4 | FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
                return $ip;
            }
            // 允許私有/保留地址(內網測試環境)
            if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
                return $ip;
            }
        }
    }
    return 'unknown';
}

第二步:調用地理位置 API

方案一:新浪 IP 查詢接口(JSON 格式,免費、穩定)

<?php
/**
 * 調用新浪 IP 地址庫
 * @param string $ip
 * @return array|false ['country','province','city','isp',...] 或 false
 */
function getLocationSina(string $ip) {
    $url = "https://int.dpool.sina.com.cn/iplookup/iplookup.php?format=json&ip={$ip}";
    
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_USERAGENT => 'Mozilla/5.0 (compatible; PHP IP Lookup)',
    ]);
    $response = curl_exec($ch);
    $errno = curl_errno($ch);
    curl_close($ch);

    if ($errno) {
        error_log("Sina IP API curl error [{$errno}]: " . curl_error($ch));
        return false;
    }

    $data = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        error_log("Sina IP API JSON decode error: " . json_last_error_msg());
        return false;
    }

    // 新浪返回 ret=-1 表示失敗
    if (isset($data['ret']) && $data['ret'] == -1) {
        return false;
    }
    return $data; // 包含 country, province, city, district, isp, type 等
}

方案二:ip138 接口(HTML 解析,較脆弱但可作備選)

<?php
function getLocationIp138(string $ip): ?string {
    $url = "https://www.ip138.com/ips138.asp?ip={$ip}";
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_USERAGENT => 'Mozilla/5.0',
    ]);
    $html = curl_exec($ch);
    curl_close($ch);

    if (!$html) return null;

    // 解析特定 HTML 結構(易失效,需維護)
    if (preg_match('/
  • (.*?)<\/li>/is', $html, $m)) { if (preg_match('/本站主數據:(.*)/i', $m[1], $m2)) { return trim($m2[1]); } } return null; }

方案三:本地 QQWry.dat 純真 IP 庫(離線、高性能、無外部依賴)

下載 qqwry.dat,使用成熟解析類(如 IPLocation):

<?php
require_once 'IPLocation.php'; // 需自行引入成熟解析類

$ipLoc = new IPLocation('/path/to/qqwry.dat');
$loc = $ipLoc->getlocation(getClientIp()); // 返回 ['country'=>..., 'area'=>...]
print_r($loc);
?>

第三步:城市名轉拼音(含多音字修正)

<?php
require_once 'pinyin.php'; // 需引入拼音庫(如 overtrue/pinyin)

$pin = new \Overtrue\Pinyin\Pinyin();
$city = $loc['city'] ?? 'unknown';
$pinyin = $pin->permalink($city); // 獲取拼音 slug,如 beijing, shanghai

// 多音字/易錯城市人工修正表
$fixMap = [
    'zhongqing'   => 'chongqing',  // 重慶
    'shenfang'    => 'shifang',    // 什邡
    'chengdou'    => 'chengdu',    // 成都
    'yueshan'     => 'leshan',     // 樂山
    'junxian'     => 'xunxian',    // 濬縣
    'shamen'      => 'xiamen',     // 廈門
    'zhangsha'    => 'changsha',   // 長沙
    'weili'       => 'yuli',       // 尉犁
    'zhaoyang'    => 'chaoyang',   // 朝陽
    'danxian'     => 'shanxian',   // 單縣/鄯善
];

$cityEn = $fixMap[$pinyin] ?? $pinyin;

// 最終跳轉
header("Location: https://www.example.com/city/{$cityEn}");
exit;

完整整合示例

<?php
// index.php
$ip = getClientIp();
if ($ip === 'unknown') {
    die('無法獲取有效 IP');
}

$loc = getLocationSina($ip);
if (!$loc) {
    // 降級嘗試 ip138 或本地庫
    $loc = ['city' => 'beijing']; // 默認回落
}

$cityEn = $fixMap[$pin->permalink($loc['city'])] ?? $pin->permalink($loc['city']);
header("Location: https://www.example.com/{$cityEn}");
exit;
?>

生產環境建議

  1. 快取 IP 解析結果:同一 IP 短時間內重複查詢無意義,用 Redis/Memcached 快取 24h。
  2. 異步非阻塞:頁面渲染不依賴地理位置,用 JS 異步請求後端 API 獲取位置再跳轉/個性化。
  3. 隱私合規:明確告知用戶收集 IP 用途,遵循 GDPR/個信法,不記錄 IP 與用戶身份關聯數據。
  4. 備選方案鏈:新浪 → ip138 → 本地庫 → 默認城市,層層兜底。

總結

IP 歸屬地解析鏈路:獲取真實 IP → 多源 API 調用與降級 → 城市標準化(拼音+多音字修正) → 業務跳轉/個性化。新浪接口免費穩定適合中小項目;大流量、高可用、隱私敏感場景請採用**本地 IP 庫(如 ip2region、MaxMind GeoIP2)**或商業服務(阿雲 IP 庫、騰訊位置服務)。

copyright © 萬盛學電腦網 all rights reserved