PHPackages                             parvion/ip-intelligence - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. parvion/ip-intelligence

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

parvion/ip-intelligence
=======================

A high-performance Laravel package for IP intelligence, geolocation, and device detection.

v1.0.0(1mo ago)01↓50%MITPHPPHP ^8.0

Since Jun 14Pushed 1mo agoCompare

[ Source](https://github.com/AnandKumar2002/ip-intelligence)[ Packagist](https://packagist.org/packages/parvion/ip-intelligence)[ RSS](/packages/parvion-ip-intelligence/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Laravel IP Intelligence
=======================

[](#laravel-ip-intelligence)

[![PHP Version](https://camo.githubusercontent.com/8374974966349d091d449f65bd658093c8c436ccd163d9df90b670a3a20359d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e302d383839324246)](https://php.net)[![Laravel](https://camo.githubusercontent.com/e6c348de52be9b1322cbd21a1f88fc446194890e4a720fa01507a04ba4d38a42/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d31302532302537432532303131253230253743253230313225323025374325323031332d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com)[![License: MIT](https://camo.githubusercontent.com/1e64768fef09f35b66921728160f533208fd2e3e792a2755187d16c25d535511/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d3232633535652e737667)](LICENSE)

> A robust, ultra-fast, and zero-dependency Laravel package that collects and analyzes visitor information from Request IPs and User Agents.

This package provides deep insights into your visitors, featuring built-in geolocation, device detection, browser parsing, bot detection, VPN/Proxy detection, and more—all without relying on heavy third-party device libraries like `Mobile_Detect`.

---

🌟 Core Features
---------------

[](#-core-features)

- **Zero Third-Party Dependencies:** Custom-built parsers ensure maximum performance without the bloat of massive external libraries.
- **Advanced Geolocation:** Instantly detects Continents, Countries, States, Cities, Timezones, Zip Codes, ISPs, and ASNs.
- **Smart Device Detection:** Accurately identifies exact device platforms (Windows, macOS, iOS, Android), architectures (x64, ARM), types (Desktop, Phone, Tablet), brands (Apple, Samsung, Xiaomi), and models.
- **Browser &amp; Engine Parsing:** Detects the browser name, version, and rendering engine (Blink, WebKit, Gecko, Trident).
- **Security &amp; Bot Detection:** Sniffs out known web crawlers, Tor exit nodes, proxies, VPNs, and suspicious network topologies.
- **Automated Caching:** Geolocation requests are automatically cached using Laravel's Cache to prevent rate limits and boost speed.

---

📦 Installation
--------------

[](#-installation)

You can install the package via composer:

```
composer require parvion/ip-intelligence
```

*(Optional)* You can publish the configuration file to customize the caching and geolocation providers:

```
php artisan vendor:publish --provider="Parvion\IpIntelligence\IpIntelligenceServiceProvider"
```

---

🚀 How to Use
------------

[](#-how-to-use)

The package gives you an elegant Facade (`IpIntelligence`) and a global helper (`ip_info()`) to access all intelligence seamlessly.

### 1. Get the Full Intelligence Profile

[](#1-get-the-full-intelligence-profile)

You can retrieve a comprehensive JSON-ready array of everything detected about the current visitor using the Facade, the global helper, or direct Object Instantiation.

**Using Object Instantiation:**

```
use Parvion\IpIntelligence\IpInfo;

$info = new IpInfo();
$profile = $info->all();
```

**Using the Facade:**

```
use Parvion\IpIntelligence\Facades\IpIntelligence;

$profile = IpIntelligence::all();
```

**Using the Global Helper:**

```
$profile = ip_info()->all();
```

**Example Output:**

```
{
    "ip": "8.8.8.8",
    "location": {
        "country": "United States",
        "country_code": "US",
        "state": "Virginia",
        "city": "Ashburn",
        "zip_code": "20149",
        "latitude": 39.03,
        "longitude": -77.5,
        "timezone": "America/New_York",
        "currency": "USD",
        "isp": "Google LLC",
        "organization": "Google Public DNS",
        "asn": "AS15169 Google LLC"
    },
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X)...",
    "browser": {
        "name": "Safari",
        "version": "16.0",
        "engine": "WebKit"
    },
    "device": {
        "type": "Mobile",
        "name": "iPhone",
        "brand": "Apple",
        "model": "iPhone"
    },
    "platform": {
        "name": "iOS",
        "version": "16.0",
        "architecture": "ARM64"
    },
    "security": {
        "is_bot": false,
        "bot_name": null,
        "is_vpn": false,
        "is_proxy": false,
        "is_tor": false,
        "is_suspicious": false
    },
    "network": {
        "isp": "Google LLC",
        "asn": "AS15169 Google LLC",
        "organization": "Google Public DNS",
        "hosting": null
    },
    "language": "en-US",
    "referrer": "https://google.com"
}
```

---

### 2. Individual Feature Usage

[](#2-individual-feature-usage)

If you don't need the entire profile, you can call specific methods individually:

#### IP &amp; Location Detection

[](#ip--location-detection)

```
IpIntelligence::ip();             // Returns current Request IP (e.g., '192.168.1.1')
IpIntelligence::country();        // 'United States'
IpIntelligence::city();           // 'New York'
IpIntelligence::timezone();       // 'America/New_York'
IpIntelligence::currency();       // 'USD'
```

#### Custom IP Lookup

[](#custom-ip-lookup)

You can lookup a specific IP address instead of using the current Request IP:

```
IpIntelligence::lookup('8.8.8.8')->city();
```

#### Device &amp; Browser Parsing

[](#device--browser-parsing)

```
IpIntelligence::deviceType();     // 'Desktop', 'Phone', 'Tablet'
IpIntelligence::deviceBrand();    // 'Apple', 'Samsung', 'Xiaomi', etc.
IpIntelligence::platform();       // 'Windows', 'macOS', 'iOS', 'Android'
IpIntelligence::browser();        // 'Chrome', 'Firefox', 'Safari'
IpIntelligence::browserEngine();  // 'Blink', 'WebKit', 'Gecko'
```

#### Security &amp; Network

[](#security--network)

```
IpIntelligence::isBot();          // bool
IpIntelligence::botName();        // 'Googlebot', 'Bingbot', null
IpIntelligence::isVpn();          // bool
IpIntelligence::isProxy();        // bool
IpIntelligence::isTor();          // bool
IpIntelligence::network();        // Returns ISP and ASN information array
```

---

🛡 License
---------

[](#-license)

This package is open-source software licensed under the [MIT license](LICENSE).

Copyright (c) 2026 Anand Kumar (Parvion)

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance90

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

46d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b84ce931c7243cd3a15fdb641abf1443a66fd4635b68470eed5df38d99d20359?d=identicon)[AnandKumar2002](/maintainers/AnandKumar2002)

### Embed Badge

![Health badge](/badges/parvion-ip-intelligence/health.svg)

```
[![Health](https://phpackages.com/badges/parvion-ip-intelligence/health.svg)](https://phpackages.com/packages/parvion-ip-intelligence)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M348](/packages/psalm-plugin-laravel)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
