benjamin-smith/php-ipify

PHP client library for ipify: A Simple IP Address API.

php-ipify

, _(*1)

This library will retrieve your public IP address from ipify's API service, and return it as a string., _(*2)

This library also has some other nice features you might care about:, _(*3)

• This library handles exceptions properly, and usage examples below show you how to deal with errors in a foolproof way.
• This library only makes API requests over HTTPS.

Install

Via Composer, _(*4)

``` bash $ composer require benjamin-smith/php-ipify, <sub>(*5)</sub>

## Usage

``` php
echo Ipify\Ip::get();

Or, if your inclined to catch any errors:, <sub>(*6)</sub>

try {
    $ip = Ipify\Ip::get();    
} catch (ConnectionError $e) {
    // If you get here, it means you were unable to reach the ipify service,
    // most likely because of a network error on your end.
} catch (ServiceError $e) {
    // If you get here, it means ipify is having issues, so the request
    // couldn't be completed :(
} catch (Exception $e) {
    // Something else happened (non-ipify related).
}

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*7)</sub>

Testing

bash $ vendor/bin/phpunit, <sub>(*8)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*9)</sub>

Security

If you discover any security related issues, please email ben@benjaminsmith.com instead of using the issue tracker., <sub>(*10)</sub>

Credits

• Benjamin Smith
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*11)</sub>