Výnimky

Chybové odpovede poskytovateľov ani nedostupné API vyhľadávanie neukončia — počítajú sa ako minutie a pipeline pokračuje. Balík vyhadzuje výnimky pri problémoch s konfiguráciou (neznámy poskytovateľ, chýbajúca či poškodená databáza MaxMind), neplatnom vstupe, neúspešnej obnove databázy a voliteľnom strope limitu požiadaviek. Všetky sú v RoundlyConsulting\Geolocation\Exceptions:

Chybná hodnota v konfigurácii — preklep v prepínači, timeout, ktorý nie je celé číslo, neznáme okno limitu — namiesto toho vyhodí InvalidConfigurationException z package-toolkit (RoundlyConsulting\PackageToolkit\Exceptions) s názvom kľúča. Nie je to GeolocationException, takže zachytenie GeolocationException nesprávnu konfiguráciu nikdy neskryje.

Zlyhanie spojenia

Keď poskytovateľ vôbec nie je dostupný — timeout, zlyhanie DNS, odmietnuté spojenie —, HTTP klient Laravelu zopakuje pokus podľa nastavení poskytovateľa, potom poskytovateľ vyhodí ProviderUnavailableException a manažér prejde na ďalšieho poskytovateľa. Ak neodpovie nikto, vyhľadávanie vráti null a LocationResolutionFailed uvedie posledného nedostupného poskytovateľa a jeho chybu. distance() nedostupného poskytovateľa preskočí rovnako a distanceMatrix() zmení každú bunku na null.

API kľúče ani licenčný kľúč MaxMind sa v správach výnimiek nikdy neobjavia: sú odstránené a výnimka prenosu — jej správa cituje celú URL požiadavky — sa nepripája ako previous.

Zachyťte GeolocationException a ošetríte všetko na jednom mieste:

use RoundlyConsulting\Geolocation\Exceptions\GeolocationException;

try {
    $location = Geolocation::locateRequest();
} catch (GeolocationException $e) {
    report($e);   // missing or corrupt .mmdb, rate-limit ceiling, unknown provider...
    $location = null;
}

batch() výnimky zachytáva sám po položkách a pre danú IP ich mení na null.