ThinkPHP 中检测服务器出口 IP 的方法

在 ThinkPHP 项目中，服务端直接请求 https://my.ipin.io/info 可以检测当前服务器访问外网时使用的出口 IP。这个场景适合运维诊断、代理节点检查、云服务器地区确认，而不是访客 IP 个性化。

设计目标

对于“ThinkPHP 中检测服务器出口 IP 的方法”，页面必须在 IP 请求完成前就具备可用内容。地理位置结果只用于增强：先验证数据，只影响一个明确决策，字段不完整时直接放弃使用。

请求与决策流程

ThinkPHP 中检测服务器出口 IP 的方法: 下面的流程针对本主题设计，不再套用通用的 IP 查询清单。

步骤 1: 把 API 地址注入 OutboundIpService，使自动化测试不依赖公网。 OutboundIpService(endpoint)
步骤 2: 使用 cURL 分别设置连接超时和总超时，并关闭自动跳转。 connect=1.2s; total=3s
步骤 3: 只接受 HTTP 200、有效公网 IP 和两位大写国家代码。 ip + country validation
步骤 4: 成功结果缓存五分钟；网络失败时返回最近一次有效结果。 Cache::set(..., 300)
步骤 5: 只记录状态码、cURL 错误和耗时，不记录无关访客数据。 Log::warning context

面向生产环境的示例

ThinkPHP 中检测服务器出口 IP 的方法: 示例加入了超时、响应校验、确定性的回退方案，以及该框架特有的生命周期处理。

<?php
namespace app\service;

use think\facade\Cache;
use think\facade\Log;

final class OutboundIpService
{
    public function __construct(
        private string $endpoint = 'https://my.ipin.io/info'
    ) {}

    public function lookup(): array
    {
        $fallback = Cache::get('ipin:last_good', [
            'ip' => 'Unknown', 'country' => 'ZZ',
            'region' => '', 'city' => '', 'source' => 'fallback'
        ]);
        $started = microtime(true);
        $ch = curl_init($this->endpoint);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CONNECTTIMEOUT_MS => 1200,
            CURLOPT_TIMEOUT_MS => 3000,
            CURLOPT_FOLLOWLOCATION => false,
            CURLOPT_HTTPHEADER => ['Accept: application/json'],
            CURLOPT_USERAGENT => 'ipin-outbound-check/1.0',
        ]);

        try {
            $body = curl_exec($ch);
            if ($body === false) {
                throw new \RuntimeException('cURL: '.curl_error($ch));
            }
            $status = (int) curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
            if ($status !== 200) {
                throw new \RuntimeException('HTTP '.$status);
            }
            $data = json_decode($body, true, 32, JSON_THROW_ON_ERROR);
            $ip = filter_var($data['ip'] ?? '', FILTER_VALIDATE_IP,
                FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE);
            $country = strtoupper((string) ($data['country'] ?? ''));
            if (!$ip || !preg_match('/^[A-Z]{2}$/', $country)) {
                throw new \UnexpectedValueException('Invalid IP payload');
            }
            $result = [
                'ip' => $ip, 'country' => $country,
                'region' => (string) ($data['region'] ?? ''),
                'city' => (string) ($data['city'] ?? ''),
                'source' => 'live',
            ];
            Cache::set('ipin:last_good', $result, 300);
            return $result;
        } catch (\Throwable $e) {
            Log::warning('Outbound IP lookup failed', [
                'message' => $e->getMessage(),
                'duration_ms' => (int) ((microtime(true) - $started) * 1000),
            ]);
            return $fallback;
        } finally {
            curl_close($ch);
        }
    }
}

测试矩阵

发布“ThinkPHP 中检测服务器出口 IP 的方法”前，应使用模拟响应或可控的 VPN 出口逐项验证以下场景。

条件	输入 / 环境	预期结果
正常 JSON	ip=203.0.113.10, country=JP	source=live；更新五分钟缓存
代理迁移	服务器出口 IP 发生变化	缓存到期后显示新出口 IP
cURL 超时	error 28	返回 last_good 或 Unknown；写入警告日志
无效响应	缺少 country 或返回私网 IP	拒绝响应；不覆盖有效缓存

自动化 / 冒烟测试

public function test_rejects_incomplete_payload(): void
{
    $service = new OutboundIpService('http://127.0.0.1:9081/missing-country');
    $result = $service->lookup();
    $this->assertSame('fallback', $result['source']);
}

失败处理

ThinkPHP 中检测服务器出口 IP 的方法: 错误需要能够在日志或开发者工具中被观察到，但不能让访客看到空白模块、失效链接或损坏的结账页面。

故障	原因	处理方式
cURL error 6 / 60	DNS 解析或 CA 证书失败	保留缓存值；检查解析器和 CA bundle
HTTP 429 / 5xx	远端服务暂时不可用	页面请求中不循环重试；使用短缓存
allow_url_fopen 关闭	file_get_contents 方案失效	使用示例中的 cURL，不修改全局 php.ini
出口 IP 与预期不符	代理或容器使用了另一条出口路由	先核对代理和容器网络，再修改白名单

实际应用案例

“ThinkPHP 中检测服务器出口 IP 的方法”的一个真实应用场景：API 服务器迁移到新代理后，运维团队把检测到的出口 IP 与第三方白名单进行比对，并保留最近一次成功结果。

上线注意事项

ThinkPHP 中检测服务器出口 IP 的方法: 默认 HTML 必须完整；不要把 IP 位置当作用户身份，也不要把浏览器端地理结果当作权限判断依据。

结论

“ThinkPHP 中检测服务器出口 IP 的方法”现在拥有独立的实现路径、测试证据和回退逻辑，不再复用同一套文章模板。