LocationModel Location 地区信息服务模块类

⚠️ 要使用 Azalea\LocationModel 必须在配置中声明使用 $config['node-beauty']['location'] = 1

⚠️ LocationModel 构造函数已私有，无法通过 new 方式实例化，仅通过 控制器 或 模块 的 getModel 方法获得

// in controller-action
$locationModel = $this->getModel('location');
$info = $locationModel->ip();  // get current ip info

LocationModel::get

---

获取地区信息

array LocationModel::get ( string ...$id )

• 参数
  $id - 地区代码，可一次传入多个地区代码

• 返回值
  地区信息数组

• 范例

$result = $locationModel->get('440106', '440100', '000000');
// 返回
[
    '000000' => null,  // 不存在返回 null
    '440100' => [
      'name' => '广州市',
      'fullname' => '广东省广州市'
      'post' => '',
      'tele' => '',
    ],
    '440106' => [
      'name' => '天河区',
      'fullname' => '广东省广州市天河区',
      'post' => '510000',
      'tele' => '020',
    ]
]

LocationModel::children

---

获取下级地区

array LocationModel::children ( string $id = null )

• 参数
  $id - 地区代码，默认为 null，即返回省份列表

• 返回值
  子地区数组

• 范例

$result = $locationModel->children();
// 返回
[
    '110000' => '北京市',
    '120000' => '天津市',
    ...
    '810000' => '香港特别行政区',
    '820000' => '澳门特别行政区'
]
$result = $locationModel->children('440100');
// 返回
[
    '440101' => '市辖区',
    '440102' => '东山区',
    ...
    '440183' => '增城市',
    '440184' => '从化市'
]

LocationModel::ip

---

获取 IP 信息

array LocationModel::ip ( string $ip = null )

• 参数
  $ip - IP，默认为 当前 IP 地址

• 返回值
  IP 信息

• 范例

$result = $locationModel->ip();  // 返回当前 IP 信息
$result = $locationModel->ip('183.61.215.98');
// 返回
[
    'int' => '3074283362',
    'ip' => '183.61.215.98',
    'country' => '广东省广州市',
    'area' => '电信',
    'province' => '440000'
]