Inštalácia

Pridajte balík. Service provider aj globálny alias fasády Geolocation sa načítajú automaticky — bez manuálnej registrácie a bez migrácií:

composer require roundly-consulting/geolocation-for-laravel

Konfiguračný súbor je voliteľný — každý kľúč má predvolenú hodnotu z env. Publikujte ho, až keď chcete zmeniť poradie pipeline, zaregistrovať vlastných poskytovateľov alebo doladiť limity požiadaviek:

php artisan vendor:publish --tag="geolocation-config"

Prvé vyhľadávanie

Po inštalácii sú oba poskytovatelia MaxMind vypnutí a vyhľadávanie IP ide na ip2location.io a potom na ipinfo.io — oba odpovedajú aj bez kľúča, ako neautentifikované požiadavky. Záložná poloha mlčí, kým ju nenastavíte, takže IP, ktorú nikto neurčí, vráti null. Návštevníka určíte jediným volaním:

use RoundlyConsulting\Geolocation\Facades\Geolocation;

$location = Geolocation::locateRequest();   // walks the pipeline for the client IP

$location?->city;           // "Mountain View"
$location?->countryIsoCode; // "US"

Pred nasadením do produkcie zúžte pipeline na poskytovateľov, ku ktorým máte prístupové údaje — alebo len na offline databázu MaxMind, ak IP návštevníkov nesmú opustiť vaše servery. Pozrite časť Ako to funguje.

Kontrola zapojenia

Balík pridá do php artisan about sekciu Geolocation s aktívnou pipeline a informáciou, či je zapnutá cache a udalosti. Prístupové údaje nikdy nevypíše:

php artisan about   # adds a "Geolocation" section: Pipeline, Cache, Events