effectra/tracker

The Effectra Tracker package.

v1.0.0 2023-09-29 10:44 UTC

This package is auto-updated.

Last update: 2024-10-29 13:09:41 UTC


README

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

You can install the Effectra Tracker package via Composer:

composer require effectra/tracker

Usage

Tracker Class

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

$ipAddress = $tracker->getIp();

Get Browser Details

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

Get Operating System Details

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

Get Device Type

$deviceType = $tracker->getDevice();

Get User Agent

$userAgent = $tracker->getUserAgent();

Get Accepted Languages

$acceptedLanguages = $tracker->getAcceptLangs();

Get Referer URL

$refererUrl = $tracker->getReferer();

Check if Client is Using a Phone Device

$isPhone = $tracker->isPhone();

Get All Client Information

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

IP Tracking Services Integration

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

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

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

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

Author

License

This project is licensed under the MIT License - see the LICENSE file for details.