<?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;
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;。
{
"ret": 1,
"start": "115.148.101.0",
"end": "115.148.101.255",
"country": "中國",
"province": "湖南",
"city": "長沙",
"district": "岳麓區",
"isp": "電信",
"type": "學校",
"desc": "湖南大學"
}
permalink() 直接生成 URL 友好 slug)。composer require overtrue/pinyin拼音庫基於詞典,對地名多音字(如「重慶」chóng qìng 非 zhòng qìng、「廈門」xià mén 非 shà mén)常誤判。**人工維護修正表是工程上最穩妥的方案**,表規模小(百餘條),維護成本低。
ip_city:{ip},TTL 24h,減少外部 API 依賴與延遲。/api/geo 獲取城市並動態渲染/跳轉,提升首屏速度。「IP → 城市 → 拼音 → 跳轉」是典型的地理位置個性化場景。核心難點在於**真實 IP 獲取**、**外部 API 可用性兜底**、**多音字修正**。採用成熟拼音庫 + 人工修正表 + 多級降級策略 + 快取,可構建高可用、低延遲的地理位置服務。