bkhim/laravel-geolocation

Laravel geolocation with built-in fraud prevention, risk scoring, MFA triggers, IP blocking, threat intelligence, and security auditing. 6 providers (IP2Location.io, MaxMind, IpInfo, IpStack, IpApi, IpGeolocation), proxy/VPN/Tor detection, login tracking, timezone/currency personalization for Larave

4.4.0 2026-04-12 09:34 UTC

Requires

• php: ^8.2
• ext-openssl: *
• geoip2/geoip2: ^v3.3.0
• guzzlehttp/guzzle: ^7.5
• illuminate/support: ^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^10.2|^11.0|^12.0|^13.0
• pestphp/pest: ^3.8|^4.0
• pestphp/pest-plugin-laravel: ^3.2|^4.0

Suggests

• ext-maxminddb: For better performance with MaxMind databases

Conflicts

• adrianorsouza/laravel-geolocation: *

MIT

• Brian Kimathi

• security
• geolocation
• maxmind
• currency
• laravel
• location
• timezone
• IP
• tor
• ipinfo
• ip2location
• MFA
• ipstack
• ipgeolocation
• vpn-detection
• proxy-detection
• fraud-prevention
• login-tracking
• risk-scoring

README

IP geolocation + fraud prevention for Laravel.
Detect proxy/VPN/Tor, trigger MFA on suspicious logins, personalize user experience.

✨ One Line of Code

$details = Geolocation::lookup();
echo $details->getCity(); // "Mountain View"

🛡️ Security First

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

🌍 6 Providers. One API.

Provider	Free Tier	Fraud Score	Proxy Detection
ipapi.co	30k/mo	❌	✅
IP2Location.io	50k/mo	✅	✅
IpInfo	Unlimited*	❌	❌
MaxMind	Unlimited	❌	❌
IPStack	100/mo	❌	❌
IPGeolocation	1k/mo	✅	✅

*IpInfo Lite: country only

→ Compare all providers

⚡ Quick Install

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

Documentation

• 🚀 Getting Started
• 🛡️ Security Features
• 🌍 Providers
• 📖 API Reference
• 🔧 Addons
• 🧪 Testing
• 🤝 Contributing

Use Cases

• 🔐 Login Security – MFA triggers on suspicious locations
• 💰 E-commerce – Local currency, geo-blocking
• 📊 Analytics – Visitor location tracking
• 🛡️ Fraud Prevention – Proxy/VPN/Tor detection

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