萬盛學電腦網

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

PHP 根據 IP 調用新浪 API 獲取城市並轉拼音跳轉:完整實現與多音字修正

功能流程

  1. 獲取客戶端真實 IP(支援代理環境)
  2. 調用新浪 IP 地址庫 API 獲取城市中文名
  3. 3. 使用拼音庫轉換為拼音 4. 多音字/易錯城市人工修正 5. 302 跳轉至城市對應頁面

完整代碼實現

<?php
// 引入拼音庫(推薦 composer require overtrue/pinyin)
require_once __DIR__ . '/vendor/autoload.php';
use Overtrue\Pinyin\Pinyin;

$pinyin = new Pinyin();

/**
 * 獲取客戶端真實 IP
 */
function getClientIp(): string {
    $keys = ['HTTP_CLIENT_IP', 'HTTP_X_FORWARDED_FOR', 'HTTP_X_REAL_IP', 'REMOTE_ADDR'];
    foreach ($keys as $key) {
        if (!empty($_SERVER[$key])) {
            $ips = explode(',', $_SERVER[$key]);
            $ip = trim($ips[0]);
            if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
                return $ip;
            }
        }
    }
    return '127.0.0.1'; // 本地測試回落
}

/**
 * 調用新浪 IP API
 */
function getLocationSina(string $ip): ?array {
    $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_CONNECTTIMEOUT => 3,
        CURLOPT_TIMEOUT => 5,
        CURLOPT_USERAGENT => 'Mozilla/5.0 (compatible; IPGeo/1.0)',
    ]);
    $resp = curl_exec($ch);
    $errno = curl_errno($ch);
    curl_close($ch);

    if ($errno) return null;
    $data = json_decode($resp, true);
    if (json_last_error() !== JSON_ERROR_NONE) return null;
    if (($data['ret'] ?? 0) == -1) return null;
    return $data;
}

// ===== 主流程 =====
$ip = getClientIp();
$loc = getLocationSina($ip);

if (!$loc) {
    // 降級:默認北京或記錄日誌
    $cityName = '北京';
} else {
    $cityName = $loc['city'] ?? '北京';
}

// 轉拼音(permalink 產生適合 URL 的小寫無聲調拼音)
$cityEn = $pinyin->permalink($cityName);

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

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

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

關鍵技術點

1. IP 獲取優先級

HTTP_CLIENT_IP > HTTP_X_FORWARDED_FOR(取首個)> HTTP_X_REAL_IP > REMOTE_ADDR。生產環境需配合 Nginx proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;。

2. 新浪 API 響應結構

{
  "ret": 1,
  "start": "115.148.101.0",
  "end": "115.148.101.255",
  "country": "中國",
  "province": "湖南",
  "city": "長沙",
  "district": "岳麓區",
  "isp": "電信",
  "type": "學校",
  "desc": "湖南大學"
}

3. 拼音庫選型

  • overtrue/pinyin:最流行、維護活躍、支援多音字、輸出格式豐富(permalink() 直接生成 URL 友好 slug)。
  • 安裝:composer require overtrue/pinyin

4. 多音字修正必要性

拼音庫基於詞典,對地名多音字(如「重慶」chóng qìng 非 zhòng qìng、「廈門」xià mén 非 shà mén)常誤判。**人工維護修正表是工程上最穩妥的方案**,表規模小(百餘條),維護成本低。

生產級增強建議

  1. 快取 IP → 城市映射:Redis 存儲 ip_city:{ip},TTL 24h,減少外部 API 依賴與延遲。
  2. 異步非阻塞:首屏不依賴地理位置,頁面載入後 JS 異步請求 /api/geo 獲取城市並動態渲染/跳轉,提升首屏速度。
  3. 備選 API 鏈:新浪 → ip-api.com → ipinfo.io → 本地 ip2region/MaxMind,層層兜底。
  4. 隱私合規:不記錄 IP 與用戶 ID 關聯,僅用於即時跳轉/展示,隱私政策說明。
  5. IPv6 支援:驗證邏輯兼容 IPv6,API 支援 IPv6 查詢。

總結

「IP → 城市 → 拼音 → 跳轉」是典型的地理位置個性化場景。核心難點在於**真實 IP 獲取**、**外部 API 可用性兜底**、**多音字修正**。採用成熟拼音庫 + 人工修正表 + 多級降級策略 + 快取,可構建高可用、低延遲的地理位置服務。

copyright © 萬盛學電腦網 all rights reserved