https://github.com/ip2location/ip2location-yii

IP2Location Yii extension enables the user to find the country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation, usage type, IP address type and IAB advertising category from IP address using IP2Location database.
https://github.com/ip2location/ip2location-yii

geolocation ip-address-database ip-database ip-geolocation ip-lookup ip2location ip2location-bin-databases web-service yii2 yii2-extension

Last synced: about 1 month ago
JSON representation

IP2Location Yii extension enables the user to find the country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation, usage type, IP address type and IAB advertising category from IP address using IP2Location database.

• Host: GitHub
• URL: https://github.com/ip2location/ip2location-yii
• Owner: ip2location
• License: mit
• Created: 2020-09-22T08:00:31.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-01-03T08:20:02.000Z (11 months ago)
• Last Synced: 2024-09-30T23:49:22.557Z (about 1 month ago)
• Topics: geolocation, ip-address-database, ip-database, ip-geolocation, ip-lookup, ip2location, ip2location-bin-databases, web-service, yii2, yii2-extension
• Language: PHP
• Homepage: https://www.ip2location.com
• Size: 436 KB
• Stars: 7
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.TXT

Awesome Lists containing this project

README

        
# IP2Location Yii extension

IP2Location Yii extension enables the user to find the country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation, usage type, IP address type and IAB advertising category from IP address using IP2Location database. It has been optimized for speed and memory utilization. Developers can use the API to query all IP2Location BIN databases or web service for applications written using Yii

## INSTALLATION

For Yii2

1. Run the command: `composer require ip2location/ip2location-yii` to download the extension into the Yii2 framework.

2. Download latest IP2Location BIN database

    - IP2Location free LITE database at https://lite.ip2location.com

    - IP2Location commercial database at https://www.ip2location.com

3. Unzip and copy the BIN file into the Yii2 framework.

**Note:** The BIN database refers to the binary file ended with .BIN extension, but not the CSV format.

Please select the right package for download.

## USAGE

```

use IP2LocationYii\IP2Location_Yii;

// (required) Define IP2Location database path.

define('IP2LOCATION_DATABASE', '/path/to/ip2location/database');

// (required) Define IP2Location.io API key.

define('IP2LOCATION_IO_API_KEY', 'your_api_key');

// (optional) Define Translation information. Refer to https://www.ip2location.io/ip2location-documentation for available languages.

define('IP2LOCATION_IO_LANGUAGE', 'en');

// (optional) Define Translation information. Refer to https://www.ip2location.com/web-service/ip2location for available languages.

define('IP2LOCATION_LANGUAGE', 'en');

$IP2Location = new IP2Location_Yii();

$record = $IP2Location->get('8.8.8.8');

echo 'Result from BIN Database:
';

echo 'IP Address: ' . $record['ipAddress'] . '
';

echo 'IP Number: ' . $record['ipNumber'] . '
';

echo 'ISO Country Code: ' . $record['countryCode'] . '
';

echo 'Country Name: ' . $record['countryName'] . '
';

echo 'Region Name: ' . $record['regionName'] . '
';

echo 'City Name: ' . $record['cityName'] . '
';

echo 'Latitude: ' . $record['latitude'] . '
';

echo 'Longitude: ' . $record['longitude'] . '
';

echo 'ZIP Code: ' . $record['zipCode'] . '
';

echo 'Time Zone: ' . $record['timeZone'] . '
';

echo 'ISP Name: ' . $record['isp'] . '
';

echo 'Domain Name: ' . $record['domainName'] . '
';

echo 'Net Speed: ' . $record['netSpeed'] . '
';

echo 'IDD Code: ' . $record['iddCode'] . '
';

echo 'Area Code: ' . $record['areaCode'] . '
';

echo 'Weather Station Code: ' . $record['weatherStationCode'] . '
';

echo 'Weather Station Name: ' . $record['weatherStationName'] . '
';

echo 'MCC: ' . $record['mcc'] . '
';

echo 'MNC: ' . $record['mnc'] . '
';

echo 'Mobile Carrier Name: ' . $record['mobileCarrierName'] . '
';

echo 'Elevation: ' . $record['elevation'] . '
';

echo 'Usage Type: ' . $record['usageType'] . '
';

echo 'Address Type: ' . $record['addressType'] . '
';

echo 'Category: ' . $record['category'] . '
';

$record = $IP2Location->getWebService('8.8.8.8');

echo 'Result from Web service:
';

echo '
';

print_r ($record);

echo '
';

```


## DEPENDENCIES

This library requires IP2Location BIN data file or IP2Location API key to function. You may download the BIN data file at

* IP2Location LITE BIN Data (Free): https://lite.ip2location.com

* IP2Location Commercial BIN Data (Comprehensive): https://www.ip2location.com

You can also sign up for [IP2Location.io IP Geolocation API](https://www.ip2location.io/sign-up) to get one free API key.

## SUPPORT

Email: [email protected]

Website: https://www.ip2location.com