PHPackages                             rafalmasiarek/real-ip-resolver - 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 & Helpers](/categories/utility)
4. /
5. rafalmasiarek/real-ip-resolver

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

rafalmasiarek/real-ip-resolver
==============================

Simple and extensible real IP resolver for PHP behind proxies and load balancers.

1.2.1(5mo ago)010MITPHPPHP >=7.4

Since Jul 25Pushed 5mo agoCompare

[ Source](https://github.com/rafalmasiarek/php-realIpResolver)[ Packagist](https://packagist.org/packages/rafalmasiarek/real-ip-resolver)[ RSS](/packages/rafalmasiarek-real-ip-resolver/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)DependenciesVersions (5)Used By (0)

RealIpResolver
==============

[](#realipresolver)

A lightweight PHP library to resolve the real client IP address, with optional support for trusted proxy lists like Cloudflare, AWS, or localhost.

Installation
------------

[](#installation)

```
composer require rafalmasiarek/real-ip-resolver

```

Basic Usage (no trusted proxy)
------------------------------

[](#basic-usage-no-trusted-proxy)

If you're not behind any proxies or load balancers, you can use the resolver directly:

```
use rafalmasiarek\Http\RealIpResolver\RealIpResolver;

$resolver = new RealIpResolver();
$realIp = $resolver->getIp();

echo "Real IP: " . $realIp;
```

Advanced Usage (with trusted proxies)
-------------------------------------

[](#advanced-usage-with-trusted-proxies)

You can specify trusted proxy IP ranges using predefined providers:

```
use rafalmasiarek\RealIpResolver;
use rafalmasiarek\RealIpResolver\TrustedProxy;
use rafalmasiarek\RealIpResolver\IPLists\Cloudflare;
use rafalmasiarek\RealIpResolver\IPLists\Localhost;

$trustedIps = array_merge(
    Localhost::get(),
    Cloudflare::get()
);

$trustedProxy = new TrustedProxy($trustedIps);$resolver = new RealIpResolver($trustedProxy);

$realIp = $resolver->getIp();
echo "Real IP: " . $realIp;
```

Creating a Custom IP List
-------------------------

[](#creating-a-custom-ip-list)

To define your own trusted proxy list, implement the `IpListInterface`:

```
namespace rafalmasiarek\RealIpResolver\IPLists;

class MyCustomProxy implements IpListInterface
{
    public static function get(): array
    {
        return [
            '203.0.113.5',
            '203.0.113.6',
            '2001:db8::abcd:1234',
        ];
    }
}
```

Using it:

```
use rafalmasiarek\RealIpResolver;
use rafalmasiarek\RealIpResolver\TrustedProxy;
use rafalmasiarek\RealIpResolver\IPLists\MyCustomProxy;

$trustedIps = MyCustomProxy::get();
$trustedProxy = new TrustedProxy($trustedIps);
$resolver = new RealIpResolver($trustedProxy);
```

Namespace Change in 1.2.0
-------------------------

[](#namespace-change-in-120)

Starting from version **1.2.0**, the library uses a cleaner and flatter namespace structure.

### What changed

[](#what-changed)

Old namespace (before 1.2.0):

```
rafalmasiarek\Http\RealIpResolver\

```

New namespace (1.2.0 and later):

```
rafalmasiarek\RealIpResolver\

```

### Updated imports

[](#updated-imports)

Before:

```
use rafalmasiarek\Http\RealIpResolver\RealIpResolver;
```

After:

```
use rafalmasiarek\RealIpResolver;
use rafalmasiarek\RealIpResolver\TrustedProxy;
use rafalmasiarek\RealIpResolver\IPLists\Cloudflare;
use rafalmasiarek\RealIpResolver\IPLists\Localhost;
```

All users should update their imports accordingly.

License
-------

[](#license)

MIT

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance70

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Every ~40 days

Total

4

Last Release

176d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/17765d36dfdee9f4179c94861184464cb4282d224e9db7fa86b4dff6005c166c?d=identicon)[rafalmasiarek](/maintainers/rafalmasiarek)

---

Top Contributors

[![rafalmasiarek](https://avatars.githubusercontent.com/u/36776423?v=4)](https://github.com/rafalmasiarek "rafalmasiarek (1 commits)")

### Embed Badge

![Health badge](/badges/rafalmasiarek-real-ip-resolver/health.svg)

```
[![Health](https://phpackages.com/badges/rafalmasiarek-real-ip-resolver/health.svg)](https://phpackages.com/packages/rafalmasiarek-real-ip-resolver)
```

###  Alternatives

[phalcon/zephir

Zephir is a compiled high level language aimed to the creation of C-extensions for PHP

3.4k414.1k18](/packages/phalcon-zephir)[code-tool/jaeger-client-php

35520.8k9](/packages/code-tool-jaeger-client-php)[rafaelfragoso/haversini-formula

This PHP class can replace the Google Distance Matrix to calculate the distance between two points using latitude and longitude. It will prevent you to do massive requests to Google servers and enhance your service performance.

45212.0k](/packages/rafaelfragoso-haversini-formula)

PHPackages © 2026

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