README

The complete global app toolkit for Laravel.
Detect location, personalize experiences, prevent fraud, and secure logins — all in one package.

One Package. Everything You Need for a Global App.

Trusted By Developers

• 780+ installs and growing
• 149 tests passing
• Built for Laravel 10-13
• PHP 8.2, 8.3, 8.4 compatible
• MIT Licensed

View on Packagist · Report Issues · Star on GitHub

One Line of Code

$details = Geolocation::lookup();
echo $details->getCity();          // "Mountain View"
echo $details->getTimezone();      // "America/Los_Angeles"
echo $details->getCurrencyCode();  // "USD"

Security Built In (Not Bolted On)

if ($details->isProxy() || $details->isTor()) {
    return redirect()->route('mfa.challenge');
}

// Or get a full risk assessment
$risk = $user->getRiskScore($request->ip());
// ['score' => 45, 'is_high_risk' => false, 'triggers' => [...]]

6 Providers. One API.

*IpInfo Lite: country only

Compare all providers

Quick Install

composer require bkhim/laravel-geolocation
php artisan vendor:publish --provider="Bkhim\Geolocation\GeolocationServiceProvider" --tag=geolocation-config

# For security features (login tracking, IP blocking):
php artisan vendor:publish --tag=geolocation-migrations
php artisan migrate

// That's it.
$location = Geolocation::lookup('8.8.8.8');
echo $location->getCountry(); // "United States"

Use Cases

Documentation

• Getting Started
• Security Features
• Providers
• API Reference
• Addons
• Testing
• Contributing

Built for Laravel 10-13 | PHP 8.2+ | MIT License