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