Watch-IP

Watch-IP mit PHP verwenden

digitload/watch-ip-sdk (Packagist, v0.1.1) umschließt GET /v1/geo in einem Composer-Paket, das auf cURL aufbaut — ohne Abhängigkeit von Guzzle oder einem anderen HTTP-Client.

Installation

Erfordert PHP 8.1+ mit den Erweiterungen curl und json, beide in praktisch jeder PHP-Installation enthalten.

Composer

composer require digitload/watch-ip-sdk

Schnellstart

Wie bei den anderen serverseitigen SDKs bedeutet der Aufruf von GET /v1/geo aus PHP, ihn von Ihrem eigenen Server statt aus dem Browser eines Besuchers aufzurufen, übergeben Sie also eine explizite origin, um die Prüfung der erlaubten Origins des Schlüssels zu erfüllen.

PHP

use Digitload\WatchIP\WatchIP;

$client = new WatchIP('wip_pub_xxxxxxxx', origin: 'https://example.com');
$geo = $client->getGeo();

echo $geo['country'], ' ', $geo['city'], ' ', $geo['timezone'];

Fehlerbehandlung und Timeouts

Jeder Fehlschlag wirft eine WatchIPError, die \RuntimeException erweitert. PHPs Exception::getCode() ist int-typisiert, aber die Fehlercodes der API sind Strings, lesen Sie sie also mit getErrorCode() statt mit getCode(). Übergeben Sie timeout (in Sekunden) zusammen mit include im Optionen-Array.

PHP

use Digitload\WatchIP\WatchIP;
use Digitload\WatchIP\WatchIPError;

$client = new WatchIP('wip_pub_xxxxxxxx', origin: 'https://example.com');

try {
    $geo = $client->getGeo(['timeout' => 5.0]);
} catch (WatchIPError $err) {
    echo $err->getErrorCode(), ' ', $err->getStatus(), ' ', $err->getMessage();
}

Was dieses SDK nicht abdeckt

Dieses Paket ruft nur GET /v1/geo auf. IP-Abfrage, E-Mail-Validierung und Risikoprüfungen sind separate Server-zu-Server-Endpoints ohne PHP-Client bisher — rufen Sie sie direkt mit cURL auf, authentifiziert auf dieselbe Weise, wie es der Authentifizierungsleitfaden beschreibt.

Verwandte Seiten