PHPackages                             yzh52521/think-geoip - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. yzh52521/think-geoip

ActiveLibrary

yzh52521/think-geoip
====================

Support for multiple GeoIP services.

v1.0.5(3y ago)251[1 issues](https://github.com/yzh52521/think-geoip/issues)proprietaryPHPPHP &gt;=7.4

Since Aug 29Pushed 3y ago1 watchersCompare

[ Source](https://github.com/yzh52521/think-geoip)[ Packagist](https://packagist.org/packages/yzh52521/think-geoip)[ RSS](/packages/yzh52521-think-geoip/feed)WikiDiscussions main Synced today

READMEChangelog (6)Dependencies (3)Versions (7)Used By (0)

think-geoip
===========

[](#think-geoip)

Determine the geographical location of website visitors based on their IP addresses

install
=======

[](#install)

```
composer require yzh52521/think-geoip

```

Configuration Quick breakdown of the two main options in the configuration file. To find out more simple open the config/geoip.php file.

Service Configuration To simplify and keep things clean, all third party composer packages, that are needed for a service, are installed separately.

For further configuration options checkout the services page.

Caching Configuration GeoIP uses think default caching to store queried IP locations. This is done to reduce the number of calls made to the selected service, as some of them are rate limited.

Options:

all all location are cached some cache only the requesting user none caching is completely disable

基本用法
====

[](#基本用法)

> The simplest way to use these method is through the helper function geoip() or by using the facade \\yzh52521\\GeoIP\\facades\\GeoIP. For the examples below we will use the helper method.

获取网站访问者的位置数据：

```
geoip($ip = null);
```

Arguments: $ip - The Ip to look up. If not set the application default to the remote address.示例：

```
\yzh52521\GeoIP\Location {

    #attributes:array [
        'ip'           => '232.223.11.11',
        'iso_code'     => 'US',
        'country'      => 'United States',
        'city'         => 'New Haven',
        'state'        => 'CT',
        'state_name'   => 'Connecticut',
        'postal_code'  => '06510',
        'lat'          => 41.28,
        'lon'          => -72.88,
        'timezone'     => 'America/New_York',
        'continent'    => 'NA',
        'currency'     => 'USD',
        'default'      => false,
    ]
}
```

Default Location In the case that a location is not found the fallback location will be returned with the default parameter set to true. To set your own default change it in the configurations config/geoip.php

think Commands
==============

[](#think-commands)

publish Service Data

```
php think geoip:publish

```

Updating Service Data Some services may need to update local files. For example the MaxMind Database service fetches a remote database and saves it to the local file system.

```
php think geoip:update

```

Clearing Cached Locations Some cache drivers offer the ability to clear stored location.

```
php think geoip:clear

```

Methods
=======

[](#methods)

When the geoip() helper function is used without arguments it will return the \\Torann\\GeoIP\\GeoIP instance, and with this we can do all types of amazing things.

```
getLocation($ip = null)

```

Get the location from the provided IP.

Arguments:

$ip - The Ip to look up. If not set the application default to the remote address.

```
geoip()->getLocation('27.974.399.65');

```

getService() Will return the default service used for determining location.

```
getClientIP()

```

Will return the user IP address.

Services
========

[](#services)

Service Prerequisites Before using the MaxMind driver, you will need to install the appropriate package via Composer:

MaxMind: geoip2/geoip2 ~2.1 IP-API (default) They offer a free and pro service ip-api.com

```
'service' => 'ipapi',

```

MaxMind Database The database location to used is specified in the config file in the services section under maxmind\_database. Along with the URL of where to download the database from when running the php artisan geoip:update. Note: The geoip:update command will need to be ran before the package will work.

```
'service' => 'maxmind_database',

```

Optimization Tip: When using the database option I don't like having the downloaded database in my git repository, so I have my deploy system run the geoip:update during the build process before it's deployed to the servers.

MaxMind API Register for a license key and user ID at [www.maxmind.com](http://www.maxmind.com)

```
'service' => 'maxmind_api',

```

IPGEOLOCATION API Register at ipgeolocation.io to get api key and add it into your env file as: IPGEOLOCATION\_KEY = YOUR\_API\_KEY

```
'service' => 'ipgeolocation',

```

IPFINDER API Register at ipfinder.io to get api key and add it into your env file as: IPFINDER\_API\_KEY = YOUR\_API\_KEY

```
'service' => 'ipfinder',

```

IPDATA API Register at ipdata.co to get api key and add it into your env file as: IPDATA\_API\_KEY = YOUR\_API\_KEY

```
'service' => 'ipdata',

```

Custom Service Services are stored in the GeoIP's config file config/geoip.php. Simply update the service with the name of your custom service and add it to the services specific configuration section with the class value as the custom classname.

Example service

```
