PHP调用手机归属地查询API的实现方法

一、使用cURL调用API

cURL是PHP中功能强大的网络库，非常适合处理HTTP请求。

1. 基础GET请求示例

以下代码演示了如何向聚合数据（Juhe.cn）的API发送请求。

$appkey = "你的APPKEY"; // 需在官网申请
$mobile = "18912345678";
$url = "http://apis.juhe.cn/mobile/get?phone=" . $mobile . "&key=" . $appkey;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 将响应作为字符串返回
curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 设置超时时间
$response = curl_exec($ch);

if (curl_errno($ch)) {
    // 错误处理，记录日志或抛出异常
    echo 'cURL Error: ' . curl_error($ch);
} else {
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if ($httpCode === 200) {
        $data = json_decode($response, true);
        if ($data['error_code'] === 0) {
            echo "省份: " . $data['result']['province'] . "\n";
            echo "城市: " . $data['result']['city'] . "\n";
            echo "运营商: " . $data['result']['company'] . "\n";
        } else {
            echo "API返回错误: " . $data['reason'];
        }
    } else {
        echo "HTTP请求失败，状态码: " . $httpCode;
    }
}
curl_close($ch);

2. 增强的POST请求与参数处理

对于需要POST请求或参数较多的API，可以这样处理：

$url = "https://eolink.o.apispace.com/teladress/teladress"; // 示例API地址
$params = [
    "mobile" => $mobile
    // 可按API文档添加其他参数
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params)); // 将参数编码为查询字符串
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-APISpace-Token: 你的API密钥', // 在Header中进行认证
    'Content-Type: application/x-www-form-urlencoded'
]);

$response = curl_exec($ch);
// ... 后续错误处理与结果解析同上
curl_close($ch);

二、使用Guzzle客户端库

对于现代PHP项目，Guzzle提供了更优雅、功能更丰富的HTTP客户端。

1. 安装与基础使用

首先通过Composer安装：composer require guzzlehttp/guzzle。

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$client = new Client([
    'base_uri' => 'https://eolink.o.apispace.com/', // API基础地址
    'timeout' => 5.0, // 超时时间
]);

try {
    $response = $client->request('POST', '/teladress/teladress', [
        'form_params' => [ // 表单参数
            'mobile' => $mobile
        ],
        'headers' => [
            'X-APISpace-Token' => '你的API密钥',
        ]
    ]);

    if ($response->getStatusCode() == 200) {
        $body = $response->getBody();
        $data = json_decode($body, true);
        // 处理返回数据
        if ($data['code'] == '200000') {
            echo "归属地: " . $data['data']['province'] . $data['data']['city'];
            echo "运营商: " . $data['data']['isp'];
        }
    }
} catch (RequestException $e) {
    // 捕获请求异常
    echo "请求出错: " . $e->getMessage();
    if ($e->hasResponse()) {
        echo "，响应内容: " . $e->getResponse()->getBody();
    }
}

2. 高级功能：并发请求与缓存

• 并发请求：当需要查询多个号码时，使用Guzzle的异步请求可以提升效率。
• 缓存：对不常变动的归属地信息进行缓存是重要的优化手段。例如，可以将查询结果在Redis或文件中缓存一段时间（如1小时），避免重复请求API。

三、使用file_get_contents函数

对于简单的GET请求，如果服务器配置允许（allow_url_fopen为On），file_get_contents是一个轻量级的选择。

$mobile = "15018788111";
$url = "http://tcc.taobao.com/cc/json/mobile_tel_segment.htm?tel=" . $mobile;
$content = file_get_contents($url);

// 淘宝API返回的是特定格式的JSONP，需要字符串截取处理
if ($content !== false) {
    // 示例处理逻辑，实际应用需根据API返回格式调整
    $province = substr($content, 56, 4);
    $supplier = substr($content, 81, 4);
    echo "省份: $province, 运营商: $supplier";
} else {
    echo "请求失败";
}

注意：此方法错误处理能力较弱，且很多旧API（如示例中的淘宝API）可能已不稳定或停用。

四、关键问题与优化策略

1. 错误处理与重试机制

必须对网络请求进行完善的错误处理。

• 设置超时：CURLOPT_TIMEOUT或 Guzzle 的 'timeout'选项，避免脚本长时间等待。
• 检查HTTP状态码：除了200，还应处理如404、500等异常状态。
• 实现重试机制：对于暂时的网络问题，可以采用指数退避策略进行重试。

$maxRetries = 3;
for ($retry = 0; $retry < $maxRetries; $retry++) {
    $response = // ... 发送请求
    if ($response !== false && 检查业务状态) {
        break; // 成功则跳出重试循环
    }
    usleep(100000 * pow(2, $retry)); // 指数退避：0.1s, 0.2s, 0.4s...
}

2. 安全性与性能优化

• 使用HTTPS：确保API请求通过HTTPS进行，防止数据被窃听或篡改。
• 管理API密钥：切勿将密钥硬编码在代码中。应使用环境变量或安全的配置文件进行管理。
• 数据缓存：如前所述，对结果进行缓存是减少API调用次数、提升响应速度的有效方法。

五、总结与建议

在选择具体方法时，可以遵循以下原则：

• 追求开发效率和代码可维护性：建议选择 Guzzle，尤其适合现代PHP项目。
• 需要最大程度的控制力和灵活性：cURL​ 提供了底层的配置选项。
• 快速原型验证或简单脚本：可考虑使用 file_get_contents，但务必注意其局限性。

希望这份详细的指南能帮助您顺利实现手机归属地查询功能。如果您在特定场景下有更具体的问题，欢迎随时提出！