README

此扩展允许您通过IP地址获取地理数据。

当前可用

• Maxmind数据库的所有字段

安装

运行

$ php composer.phar require coderius/yii2-geo-ip "~1.0"

或等于

$ composer require coderius/yii2-geo-ip "~1.0"

或者

将其添加到您的 composer.json

{
    "require": {
        "coderius/yii2-geo-ip": "~1.0"
    }
}

然后运行

$ php composer update

用法

在应用配置中注册组件

<?php

$config = [
    ...
    'components' => [
        'geoip' => ['class' => 'coderius\geoIp\GeoIP'],
    ]
    ...
];

在代码的某处

$ip = Yii::$app->geoip->ip(); // current user ip
$ip = Yii::$app->geoip->ip(null, false);// current user ip without catche

$ip = Yii::$app->geoip->ip("208.113.83.165");

$ip = Yii::$app->geoip->ip("208.113.83.165")//or Yii::$app->geoip->ip() for current user


$ip->city; // "San Francisco"
$ip->country; // "United States"
$ip->location->lng; // 37.7898
$ip->location->lat; // -122.3942
$ip->isoCode;

//etc.

提供自定义数据库（例如，如果您拥有许可证）

<?php

$config = [
    ...
    'components' => [
        'geoip' => [
            'class' => 'coderius\geoIp\GeoIP',
            'dbPath' => Yii::getAlias('@example/maxmind/database/city.mmdb')
        ],
    ]
    ...
];

高级用法

To see all the available properties, you need to do the following:

```php
var_dump($ip->city);
var_dump($ip->continent);
var_dump($ip->country);
var_dump($ip->location);
var_dump($ip->postal);
var_dump($ip->registeredCountry);
var_dump($ip->subdivisions);
die;

结果可能如下所示

object(coderius\geoIp\City)#196 (2) {
  ["_geoname_id":"coderius\geoIp\City":private]=>
  int(5099836)
  ["_names":"coderius\geoIp\City":private]=>
  array(4) {
    ["en"]=>
    string(11) "Jersey City"
    ["ja"]=>
    string(24) "ジャージーシティ"
    ["ru"]=>
    string(21) "Джерси-Сити"
    ["zh-CN"]=>
    string(9) "泽西市"
  }
}
object(coderius\geoIp\Continent)#197 (3) {
  ["_code":"coderius\geoIp\Continent":private]=>
  string(2) "NA"
  ["_geoname_id":"coderius\geoIp\Continent":private]=>
  int(6255149)
  ["_names":"coderius\geoIp\Continent":private]=>
  array(8) {
    ["de"]=>
    string(11) "Nordamerika"
    ["en"]=>
    string(13) "North America"
    ["es"]=>
    string(13) "Norteamérica"
    ["fr"]=>
    string(17) "Amérique du Nord"
    ["ja"]=>
    string(15) "北アメリカ"
    ["pt-BR"]=>
    string(17) "América do Norte"
    ["ru"]=>
    string(31) "Северная Америка"
    ["zh-CN"]=>
    string(9) "北美洲"
  }
}
object(coderius\geoIp\Country)#198 (3) {
  ["_iso_code":"coderius\geoIp\Country":private]=>
  string(2) "US"
  ["_geoname_id":"coderius\geoIp\Country":private]=>
  int(6252001)
  ["_names":"coderius\geoIp\Country":private]=>
  array(8) {
    ["de"]=>
    string(3) "USA"
    ["en"]=>
    string(13) "United States"
    ["es"]=>
    string(14) "Estados Unidos"
    ["fr"]=>
    string(11) "États-Unis"
    ["ja"]=>
    string(21) "アメリカ合衆国"
    ["pt-BR"]=>
    string(14) "Estados Unidos"
    ["ru"]=>
    string(6) "США"
    ["zh-CN"]=>
    string(6) "美国"
  }
}
object(coderius\geoIp\Location)#199 (5) {
  ["_accuracy_radius":"coderius\geoIp\Location":private]=>
  int(1000)
  ["_latitude":"coderius\geoIp\Location":private]=>
  float(40.7209)
  ["_longitude":"coderius\geoIp\Location":private]=>
  float(-74.0468)
  ["_metro_code":"coderius\geoIp\Location":private]=>
  int(501)
  ["_time_zone":"coderius\geoIp\Location":private]=>
  string(16) "America/New_York"
}
object(coderius\geoIp\Postal)#200 (3) {
  ["_code":"coderius\geoIp\Postal":private]=>
  string(5) "07302"
  ["_geoname_id":"coderius\geoIp\Postal":private]=>
  NULL
  ["_names":"coderius\geoIp\Postal":private]=>
  array(0) {
  }
}
object(coderius\geoIp\RegisteredCountry)#201 (3) {
  ["_iso_code":"coderius\geoIp\RegisteredCountry":private]=>
  string(2) "US"
  ["_geoname_id":"coderius\geoIp\RegisteredCountry":private]=>
  int(6252001)
  ["_names":"coderius\geoIp\RegisteredCountry":private]=>
  array(8) {
    ["de"]=>
    string(3) "USA"
    ["en"]=>
    string(13) "United States"
    ["es"]=>
    string(14) "Estados Unidos"
    ["fr"]=>
    string(11) "États-Unis"
    ["ja"]=>
    string(21) "アメリカ合衆国"
    ["pt-BR"]=>
    string(14) "Estados Unidos"
    ["ru"]=>
    string(6) "США"
    ["zh-CN"]=>
    string(6) "美国"
  }
}
array(1) {
  [0]=>
  object(coderius\geoIp\Subdivision)#202 (3) {
    ["_iso_code":"coderius\geoIp\Subdivision":private]=>
    string(2) "NJ"
    ["_geoname_id":"coderius\geoIp\Subdivision":private]=>
    int(5101760)
    ["_names":"coderius\geoIp\Subdivision":private]=>
    array(7) {
      ["en"]=>
      string(10) "New Jersey"
      ["es"]=>
      string(12) "Nueva Jersey"
      ["fr"]=>
      string(10) "New Jersey"
      ["ja"]=>
      string(27) "ニュージャージー州"
      ["pt-BR"]=>
      string(12) "Nova Jérsia"
      ["ru"]=>
      string(19) "Нью-Джерси"
      ["zh-CN"]=>
      string(12) "新泽西州"
    }
  }
}

当尝试将对象转换为字符串如下时，来自相等类对象的方法 _toString 返回的数据

echo $ip->city;
echo "\n";
echo $ip->continent;
echo "\n";
echo $ip->country;
echo "\n";
echo $ip->location;
echo "\n";
echo $ip->postal;
echo "\n";
echo $ip->registeredCountry;
echo "\n";
echo $ip->subdivisions[0];
echo "\n";

输出

Jersey City
North America
United States
-74.0468 40.7209
07302
United States
New Jersey

例如，从城市对象获取更多信息

$ip->city->GeonameId;
$lang = Yii::$app->language;

echo $ip->hasCity("names") ? $ip->city->names->$lang : "empty result...";
//or
echo $ip->hasCity() ? $ip->city : "empty result...";//from _toString return $ip->city->names->en

本产品包含MaxMind创建的GeoLite2数据，可在 http://www.maxmind.com 获取