新浪提供免費的 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": "中国 广东 深圳 电信"
}
<?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) { /* ... 同上 ... */ }
// 其他提供者實作...
}
透過策略模式整合多家提供者,可大幅提升查詢成功率與可用性。