ThinkPHPでサーバー出口IPを確認する方法

設計目標

「ThinkPHPでサーバー出口IPを確認する方法」では、IP リクエストが完了する前からページが役立つ状態である必要があります。位置情報は補助データとして検証し、限定した一つの判定だけに使い、不完全な場合は採用しません。

リクエストと判定の流れ

ThinkPHPでサーバー出口IPを確認する方法: 次の流れはこの実装専用であり、一般的な IP 検索チェックリストの使い回しではありません。

1. 手順 1 — 既定状態: OutboundIpService(endpoint)
2. 手順 2 — リクエスト: connect=1.2s; total=3s
3. 手順 3 — 検証: ip + country validation
4. 手順 4 — 判定: Cache::set(..., 300)
5. 手順 5 — フォールバック: 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 出口で次のケースを確認します。

自動 / スモークテスト

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を確認する方法: 障害はログや開発者ツールで確認できるようにしつつ、空のモジュールや壊れた決済画面を利用者に見せないことが重要です。

実運用の例

「ThinkPHPでサーバー出口IPを確認する方法」の現実的な利用例：API サーバーを新しいプロキシ配下へ移した後、運用担当者が検出した出口 IP を取引先の許可リストと照合し、最後に成功した値を保存します。

本番公開時の注意

ThinkPHPでサーバー出口IPを確認する方法: 既定の HTML を完全な状態で残してください。IP 位置情報は本人確認ではなく、クライアント側の結果を権限制御に使ってはいけません。

まとめ

「ThinkPHPでサーバー出口IPを確認する方法」は、共通テンプレートではなく、独自の実装手順、テスト、フォールバック動作を持つ記事になりました。