文件
fenleixinxi/application/common/library/NationalArea.php
MiAn 133d425ec0 feat: 新增阿里云OSS适配器及分类图标优化
- 新增阿里云OSS SDK核心类库文件
- 新增OSS插件配置文件及钩子监听
- 新增分类图标SVG资源并优化为轻量化格式
- 替换定位接口为天地图逆地理编码接口
- 新增OSS图片缩略处理工具方法
2026-11-20 11:11:03 +08:00

163 行
5.0 KiB
PHP

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?php
namespace app\common\library;
use think\Db;
/**
* 服务区域工具类
*
* 唯一数据源:fa_fc_area 数据库表。后台手动增/删/改,enabled 控制显隐。
* national_areas.json 仅作为"恢复全国默认"时的种子数据源(误删或重装时一键灌入)。
*/
class NationalArea
{
/** @var array|null 内存级缓存 */
protected static $allCache = null;
/**
* 获取全部可选省/市/区县平铺列表
* 只查 fa_fc_area WHERE enabled=1 ORDER BY sort asc, id asc。
*/
public static function all()
{
if (self::$allCache !== null) {
return self::$allCache;
}
$list = [];
try {
$rows = Db::name('fc_area')
->where('enabled', 1)
->order('sort asc, id asc')
->select();
foreach ($rows as $r) {
$list[] = [
'id' => (int)$r['id'],
'province' => (string)$r['province'],
'city' => (string)$r['city'],
'district' => (string)$r['district'],
'lat' => $r['lat'] !== null && $r['lat'] !== '' ? (float)$r['lat'] : null,
'lng' => $r['lng'] !== null && $r['lng'] !== '' ? (float)$r['lng'] : null,
];
}
} catch (\Throwable $e) {
// 数据库异常返回空
}
self::$allCache = $list;
return self::$allCache;
}
/**
* 按区域 ID 查找单条省/市/区县记录
*/
public static function findById($areaId)
{
$areaId = (int)$areaId;
if ($areaId <= 0) {
return null;
}
foreach (self::all() as $row) {
if ((int)$row['id'] === $areaId) {
return $row;
}
}
return null;
}
/**
* 按区县名称(及可选省/市)查找匹配记录
*/
public static function findByName($district, $city = '', $province = '')
{
$district = trim((string)$district);
$city = trim((string)$city);
$province = trim((string)$province);
if ($district === '') {
return null;
}
foreach (self::all() as $row) {
if ($row['district'] === $district) {
if ($city !== '' && $row['city'] !== $city) {
continue;
}
if ($province !== '' && $row['province'] !== $province) {
continue;
}
return $row;
}
}
return null;
}
/**
* 清内存缓存
*/
public static function invalidate()
{
self::$allCache = null;
}
/**
* 从 national_areas.json 导入全国默认数据到 fa_fc_area
*
* 操作:先 TRUNCATE 清空现有覆盖层,再把 json 全量 INSERT 进去,全部 enabled=1。
* 相当于把"覆盖层"重置为全国默认状态。
*
* @return int 导入条数
*/
public static function importFromJson()
{
$jsonFile = APP_PATH . 'extra' . DS . 'national_areas.json';
if (!is_file($jsonFile)) {
throw new \RuntimeException('national_areas.json 不存在');
}
$decoded = json_decode((string)file_get_contents($jsonFile), true);
if (!is_array($decoded)) {
throw new \RuntimeException('national_areas.json 解析失败');
}
// 清空现有覆盖层
Db::execute('TRUNCATE TABLE `' . Db::getConfig('prefix') . 'fc_area`');
// 按 省→市→区县 自然排序后再入库,保证 id 自增顺序就是行政区顺序
usort($decoded, function ($a, $b) {
$cmp = strcmp((string)$a['province'], (string)$b['province']);
if ($cmp !== 0) return $cmp;
$cmp = strcmp((string)$a['city'], (string)$b['city']);
if ($cmp !== 0) return $cmp;
return strcmp((string)$a['district'], (string)$b['district']);
});
$now = time();
$chunk = [];
$chunkSize = 200;
$sort = 0;
foreach ($decoded as $item) {
$sort++;
$chunk[] = [
'province' => (string)$item['province'],
'city' => (string)$item['city'],
'district' => (string)$item['district'],
'lat' => isset($item['lat']) && $item['lat'] !== null ? (float)$item['lat'] : null,
'lng' => isset($item['lng']) && $item['lng'] !== null ? (float)$item['lng'] : null,
'sort' => $sort,
'enabled' => 1,
'createtime' => $now,
'updatetime' => $now,
];
if (count($chunk) >= $chunkSize) {
Db::name('fc_area')->insertAll($chunk);
$chunk = [];
}
}
if (!empty($chunk)) {
Db::name('fc_area')->insertAll($chunk);
}
self::invalidate();
return count($decoded);
}
}