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 2w 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 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity44

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

1053d 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.2k555.0M2.8k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k832.6k54](/packages/neuron-core-neuron-ai)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)[oat-sa/tao-core

TAO core extension

64147.9k151](/packages/oat-sa-tao-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M672](/packages/shopware-core)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

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