effectra / tracker
The Effectra Tracker package.
v1.0.0
2023-09-29 10:44 UTC
Requires
- effectra/http-foundation: ^1.0
- guzzlehttp/guzzle: ^7.7
- psr/http-message: ^2.0
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
- Mohammed Taha - Email
License
This project is licensed under the MIT License - see the LICENSE file for details.