Server-Ausgangs-IP in ThinkPHP prüfen

Autorenname:Lisa Farrell·2026-06-01

In einem ThinkPHP-Projekt prüft ein serverseitiger Aufruf von https://my.ipin.io/info die ausgehende IP, die der Server beim Zugriff auf das öffentliche Internet verwendet. Das dient Betriebsdiagnose, Proxy-Prüfung und Cloud-Server-Regionserkennung.

Entwurfsziel

Bei „Server-Ausgangs-IP in ThinkPHP prüfen“ muss die Seite bereits vor Abschluss der IP-Anfrage nützlich sein. Das Geosignal ist nur eine Ergänzung: Es wird geprüft, auf eine klar begrenzte Entscheidung angewendet und bei unvollständigen Daten verworfen.

Anfrage- und Entscheidungsablauf

Server-Ausgangs-IP in ThinkPHP prüfen: Der folgende Ablauf wurde für dieses konkrete Thema entworfen und ist keine allgemeine IP-Checkliste.

  1. Schritt 1 — Standardzustand: OutboundIpService(endpoint)
  2. Schritt 2 — Anfrage: connect=1.2s; total=3s
  3. Schritt 3 — Validierung: ip + country validation
  4. Schritt 4 — Entscheidung: Cache::set(..., 300)
  5. Schritt 5 — Fallback: Log::warning context

Produktionsnahes Beispiel

Server-Ausgangs-IP in ThinkPHP prüfen: Das Beispiel enthält Timeout, Antwortvalidierung, einen deterministischen Fallback und eine zum Framework passende Lebenszyklusbehandlung.

<?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);
        }
    }
}

Testmatrix

Vor der Veröffentlichung von „Server-Ausgangs-IP in ThinkPHP prüfen“ sollten diese Fälle mit Mock-Antworten oder einem kontrollierten VPN-Ausgang geprüft werden.

BedingungEingabe / SetupErwartetes Ergebnis
T1HTTP 200; ip=203.0.113.10; country=JPsource=live; Cache TTL=300
T2egress IP A → Bnew value after TTL
T3cURL error=28source=fallback; Log::warning
T4private IP / country=nullreject; cache unchanged

Automatisierter / Smoke-Test

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']);
}

Fehlerbehandlung

Server-Ausgangs-IP in ThinkPHP prüfen: Fehler müssen in Logs oder Entwicklertools sichtbar sein, dürfen aber keinen leeren Bereich und keinen defekten Checkout erzeugen.

FehlerUrsacheReaktion
cURL 6 / 60DNS / CACache:last_good + Log
HTTP 429 / 5xxremote APIshort cache; no request loop
allow_url_fopen=0file_get_contentscURL
proxy IP mismatchegress routeproxy/container network check

Praxisbeispiel

Ein realistischer Einsatz für „Server-Ausgangs-IP in ThinkPHP prüfen“: Nach dem Umzug eines API-Servers hinter einen neuen Proxy vergleicht das Betriebsteam die erkannte Ausgangs-IP mit der Allowlist eines Partners und speichert den letzten gültigen Wert.

Hinweise für den Betrieb

Server-Ausgangs-IP in ThinkPHP prüfen: Das Standard-HTML muss vollständig bleiben. IP-Standort ist keine Identität und ein clientseitiges Geosignal darf keine Berechtigung steuern.

Fazit

„Server-Ausgangs-IP in ThinkPHP prüfen“ besitzt nun einen eigenen Implementierungsweg, konkrete Tests und ein definiertes Fallback statt einer gemeinsamen Artikelschablone.