olehlytiuha/geo-time

PSR-20 ClockInterface based on IP geolocation timezone (Laravel Implementation)

dev-master 2025-05-26 06:08 UTC

Requires

• php: >=8.2
• guzzlehttp/guzzle: ^7.9
• jms/serializer: ^3.32
• laravel/framework: ^10.0
• psr/clock: ^1.0
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• phpunit/phpunit: ^11.5

proprietary

• Oleh Lytiuha

README

// README.md (excerpt)

Geo Clock (Laravel Package)

This package implements a PSR-20 ClockInterface using geolocation time detection.

Requirements

• PHP >= 8.2
• Laravel Framework >= 10.x

Installation

composer require paynoomo/geo-clock

Configuration

php artisan vendor:publish --tag=geo-clock-config

Edit .env:

GEO_TIMEZONE_API_URL=https://timeapi.io/api/Time/current/ip
GEO_TIMEZONE_API_KEY=your-key-if-needed

How to obtain an API Key

To use ipgeolocation.io, follow these steps:

1. Go to https://ipgeolocation.io and Sign Up.
2. Log in to your dashboard.
3. Navigate to: https://app.ipgeolocation.io/requestApiLogs
4. Your API Key will be visible in the top right corner or under the "API Key" section.
5. Copy and paste it into your .env file:

GEO_TIMEZONE_API_URL=https://api.ipgeolocation.io/timezone
GEO_TIMEZONE_API_KEY=your-api-key-here

⚠️ Do not commit your .env file with secrets to version control.

Usage

use GeoTimezone\Interfaces\GeoClientInterface;

public function __construct(GeoClientInterface $geoClient) {
    $time = $geoClient->getLocalTimeByIp('8.8.8.8');
}

Testing

composer test