萬盛學電腦網

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

PHP 串接新浪 IP 地址查詢 API 取得地理位置資訊

新浪提供免費的 IP 地址查詢介面,回傳 JSON 格式資料,包含國家、省份、城市、區縣、ISP 等資訊。本文示範如何用 PHP cURL 呼叫該 API 並解析結果。

核心函數實作

<?php
/**
 * 透過新浪 IP 查詢介面取得地理位置
 * @param string $ip 目標 IP,預設為自動偵測
 * @return string|false 位置字串或失敗回傳 false
 */
function getIPLocationSina($ip = '') {
    if (empty($ip)) {
        $ip = $_SERVER['REMOTE_ADDR'] ?? '';
    }
    if (empty($ip)) return false;

    $url = "https://int.dpool.sina.com.cn/iplookup/iplookup.php?format=json&ip=$ip";

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 5,
        CURLOPT_ENCODING       => 'utf-8',
        CURLOPT_USERAGENT      => 'Mozilla/5.0 (compatible; PHP IP Lookup)',
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode !== 200 || empty($response)) {
        error_log("Sina IP API 請求失敗: HTTP $httpCode, IP: $ip");
        return false;
    }

    $data = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE || empty($data)) {
        error_log("Sina IP API 回傳非合法 JSON: $response");
        return false;
    }

    // 新浪 API 回傳結構:ret=1 成功,desc 為詳細地址,或分欄位 province/city/district/isp
    if (isset($data['ret']) && $data['ret'] == 1) {
        return $data['desc'] ?? implode('', [
            $data['province'] ?? '',
            $data['city'] ?? '',
            $data['district'] ?? '',
            $data['isp'] ?? ''
        ]);
    }

    return false;
}

// 使用範例
$ip = '183.37.209.57'; // 或留空自動偵測
$location = getIPLocationSina($ip);
echo $location ?: '查詢失敗';
?>

回傳資料結構說明

成功時 JSON 範例:

{
    "ret": 1,
    "start": "183.37.209.0",
    "end": "183.37.209.255",
    "country": "中国",
    "province": "广东",
    "city": "深圳",
    "district": "",
    "isp": "电信",
    "type": "学校",
    "desc": "中国 广东 深圳 电信"
}

注意事項與最佳實踐

  • 頻率限制:新浪未公開明確限制,建議自行快取結果(如 Redis 存 24 小時),避免頻繁請求被封禁
  • HTTPS 支援:該介面僅支援 HTTP,若網站為全站 HTTPS,瀏覽器會阻擋混合內容,建議伺服器端代理請求
  • 編碼處理:API 回傳 UTF-8,確保 PHP 檔案與資料庫皆為 UTF-8
  • 備援方案:搭配其他免費 IP 庫(如 ip-api.com、ipinfo.io)做多層備援
  • 內網 IP:10.x、172.16-31.x、192.168.x 等私有 IP 無法查詢,需特別處理

進階:整合至 Laravel / Symfony 服務類

<?php
// 簡易服務類雛形
class IpLocationService {
    private $providers = ['sina', 'taobao', 'ipapi'];

    public function locate($ip = '') {
        foreach ($this->providers as $provider) {
            $method = "getFrom" . ucfirst($provider);
            if ($result = $this->$method($ip)) {
                return ['provider' => $provider, 'location' => $result];
            }
        }
        return ['provider' => 'none', 'location' => '未知'];
    }

    private function getFromSina($ip) { /* ... 同上 ... */ }
    // 其他提供者實作...
}

透過策略模式整合多家提供者,可大幅提升查詢成功率與可用性。

copyright © 萬盛學電腦網 all rights reserved