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 1mo ago

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 22% 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

962d 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

[shopify/shopify-api

Shopify API Library for PHP

4634.8M16](/packages/shopify-shopify-api)[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k21](/packages/neuron-core-neuron-ai)[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28137.8k](/packages/phpro-http-tools)[huaweicloud/huaweicloud-sdk-php

Huawei Cloud SDK for PHP

1829.2k2](/packages/huaweicloud-huaweicloud-sdk-php)[mimmi20/browser-detector

Library to detect Browsers and Devices

48153.5k3](/packages/mimmi20-browser-detector)[aedart/athenaeum

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

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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