malvik-lab/ip-api-client

A PHP library for interfacing with ip-api.com, providing geolocation details based on an IP address.

1.0.0 2023-12-09 18:42 UTC

This package is auto-updated.

Last update: 2024-04-09 19:32:12 UTC


README

This unofficial library provides a simple interface to interact with the ip-api.com service, allowing you to obtain geographic information based on the IP address.

Installation

You can install this library using Composer. Run the following command:

composer require malvik-lab/ip-api-client

Usage

Example of Use

<?php

require_once __DIR__ . '/vendor/autoload.php';

use GuzzleHttp\Client;
use MalvikLab\IpApiClient\IpApiClient;

$ipApiClient = new IpApiClient(new Client());
$ipData = $ipApiClient->get('8.8.8.8');

Available Methods

  • get($ip): Gets details about the specified IP address.

Output Example

MalvikLab\IpApiClient\DTO\DataDTO Object
(
    [limit] => MalvikLab\IpApiClient\DTO\LimitDTO Object
        (
            [ttl] => 60
            [rl] => 44
        )

    [ipInfo] => MalvikLab\IpApiClient\DTO\IpInfoDTO Object
        (
            [status] => success
            [country] => United States
            [countryCode] => US
            [region] => VA
            [regionName] => Virginia
            [city] => Ashburn
            [zip] => 20149
            [lat] => 39.03
            [lon] => -77.5
            [timezone] => DateTimeZone Object
                (
                    [timezone_type] => 3
                    [timezone] => America/New_York
                )

            [isp] => Google LLC
            [org] => Google Public DNS
            [as] => AS15169 Google LLC
            [query] => 8.8.8.8
        )

)

Running Test

vendor/bin/phpunit tests --testdox