PHPackages                             effectra/tracker - 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. [HTTP & Networking](/categories/http)
4. /
5. effectra/tracker

ActiveLibrary[HTTP & Networking](/categories/http)

effectra/tracker
================

The Effectra Tracker package.

v1.0.0(2y ago)1201MITPHP

Since Sep 29Pushed 2y agoCompare

[ Source](https://github.com/effectra/tracker)[ Packagist](https://packagist.org/packages/effectra/tracker)[ RSS](/packages/effectra-tracker/feed)WikiDiscussions main Synced yesterday

READMEChangelog (1)Dependencies (3)Versions (2)Used By (1)

Effectra Tracker
================

[](#effectra-tracker)

Effectra Tracker is a PHP package that provides methods to extract information from the client's request, including IP address, browser details, operating system, device type, accepted languages, and referer URL. It also includes integration with IP tracking services to fetch additional attributes related to the provided IP address.

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

[](#installation)

You can install the Effectra Tracker package via [Composer](https://getcomposer.org/):

```
composer require effectra/tracker
```

Usage
-----

[](#usage)

### Tracker Class

[](#tracker-class)

#### Initialize Tracker

[](#initialize-tracker)

```
use Effectra\Tracker\Tracker;
use Psr\Http\Message\ServerRequestInterface;

$request = ...; // Your PSR-7 ServerRequestInterface implementation
$tracker = new Tracker($request);
```

#### Get Client's IP Address

[](#get-clients-ip-address)

```
$ipAddress = $tracker->getIp();
```

#### Get Browser Details

[](#get-browser-details)

```
$browser = $tracker->getBrowser();
// $browser['name'] contains the browser name
// $browser['version'] contains the browser version
```

#### Get Operating System Details

[](#get-operating-system-details)

```
$os = $tracker->getOs();
// $os['name'] contains the OS name
// $os['version'] contains the OS version
```

#### Get Device Type

[](#get-device-type)

```
$deviceType = $tracker->getDevice();
```

#### Get User Agent

[](#get-user-agent)

```
$userAgent = $tracker->getUserAgent();
```

#### Get Accepted Languages

[](#get-accepted-languages)

```
$acceptedLanguages = $tracker->getAcceptLangs();
```

#### Get Referer URL

[](#get-referer-url)

```
$refererUrl = $tracker->getReferer();
```

#### Check if Client is Using a Phone Device

[](#check-if-client-is-using-a-phone-device)

```
$isPhone = $tracker->isPhone();
```

#### Get All Client Information

[](#get-all-client-information)

```
$clientInfo = $tracker->getAll();
// $clientInfo is an associative array containing all client information
```

### IP Tracking Services Integration

[](#ip-tracking-services-integration)

Effectra Tracker supports integration with various IP tracking services. Currently, the following services are supported:

#### IpGeoLocation Service

[](#ipgeolocation-service)

```
use Effectra\Tracker\Services\IpGeoLocation;
use GuzzleHttp\Client;

$client = new Client(); // GuzzleHttp client instance
$ip = ...; // IP address to query
$apiKey = ...; // Your API key for ipgeolocation.io

$ipGeoLocation = new IpGeoLocation($client, $ip, $apiKey);
$ipAttributes = $ipGeoLocation->getAll();
```

#### IpRegistry Service

[](#ipregistry-service)

```
use Effectra\Tracker\Services\IpRegistry;
use GuzzleHttp\Client;

$client = new Client(); // GuzzleHttp client instance
$ip = ...; // IP address to query
$apiKey = ...; // Your API key for ipregistry.co

$ipRegistry = new IpRegistry($client, $ip, $apiKey);
$ipAttributes = $ipRegistry->getAll();
```

#### IpWhoIs Service

[](#ipwhois-service)

```
use Effectra\Tracker\Services\IpWhoIs;
use GuzzleHttp\Client;

$client = new Client(); // GuzzleHttp client instance
$ip = ...; // IP address to query

$ipWhoIs = new IpWhoIs($client, $ip, null); // No API key required for ipwho.is
$ipAttributes = $ipWhoIs->getAll();
```

Requirements
------------

[](#requirements)

- [PSR-7 HTTP Message](https://www.php-fig.org/psr/psr-7/)
- [Guzzle HTTP Client](https://docs.guzzlephp.org/en/stable/)
- [Effectra HTTP Foundation](https://github.com/effectra/http-foundation)

Author
------

[](#author)

- **Mohammed Taha** - [Email](mailto:info@mohammedtaha.net)

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

1008d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7e6219ae87e98df8783b2f595b013035dd183c0712afd24045a8acf0a40c3bdf?d=identicon)[effectra](/maintainers/effectra)

---

Top Contributors

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

---

Tags

geolocationguzzlehttphttp-clientphppsrpsr7-httptrackeruseragent

### Embed Badge

![Health badge](/badges/effectra-tracker/health.svg)

```
[![Health](https://phpackages.com/badges/effectra-tracker/health.svg)](https://phpackages.com/packages/effectra-tracker)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[guzzlehttp/psr7

PSR-7 message implementation that also provides common utility methods

8.0k1.1B4.0k](/packages/guzzlehttp-psr7)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[oat-sa/tao-core

TAO core extension

66143.7k122](/packages/oat-sa-tao-core)

PHPackages © 2026

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