# `naisi_region_get`

按共用编码获取地区及完整父级链，包含数据库保留的删除记录。
region_type 是国内/国际数据集整数标识；region_kind、level 直接读取数据库，不根据编码或树深度推断。
国内编码使用行政区划记录；籍贯复用这些编码。name 为对应源表原始名称，国际 name 为官方语言名称。
国内另含 short_name、pinyin、pinyin_short；国际另含 en_name、zh_name、numeric，不返回不存在的简称。
numeric 为三位数字字符串（例如 "004"），只在国际顶层返回。国内不返回 is_extension。
parents 从最上级到直接父级排列，含 region_code、parent_code、region_kind、level、name 和对应名称/拼音字段；
不含 region_type、numeric、is_deleted 或嵌套 parents；根节点 parents=[]。空名称原样返回，不替换字段。
使用 UTF-8 数据；调用前须建立本请求有效许可状态。

## 函数签名

```php
function naisi_region_get(int $region_code): array|false
```

## 调用前提

应用入口先调用 [naisi_is_ext_license_valid](/web/developers/naisilib/naisi-is-ext-license-valid) 并确认返回 `true`。只验证同一请求内已有的有效 FULL/BASIC 证明；没有证明或证明失效时立即返回失败值，不现场补做完整校验。

授权类别：`LICENSE`；执行模式：`PROOF`。许可不代替登录、租户或权限上下文；身份与数据要求见本页参数及用途说明。

## 参数

### `$region_code`

- 类型：`int`
- 必填：是
- 默认值：无
- 方向：输入参数。

地区共用整数编码；国内按行政区划查询。

## 返回值

类型：`array{region_code:int,parent_code:int,region_type:int,region_kind:string,level:int,name:string,is_deleted:bool,parents:array}|false`

不存在、未授权或加载失败返回 false。

## 调用示例

当前请求须满足上方调用前提；请检查实际返回值和引用输出，随机结果及数据包内容以运行环境为准。

```php
$region_code = 361104;

$result = naisi_region_get($region_code);
var_export($result);
```

## 编码与异常

籍贯与国内行政区划共用编码。get/code_to_name 不增加类型参数，国内编码使用行政区划名称和父链；列表、搜索、名称解析按传入类型选择数据。get/code_to_name 可读取库中仍保留的软删除记录，其余接口过滤软删除记录；物理删除的历史记录无法查询。

参数必须与签名声明的原始 PHP 类型一致，不做弱类型转换；类型不匹配返回 `false`。参数数量错误仍遵循 PHP 标准异常规则。文本使用 UTF-8，地区文本及分隔符最多 4096 字节，不允许 NUL。没有引用输出参数。

## 版本信息

- 实现模块：`region`
- 授权类别：`LICENSE` / `PROOF`
- 失败回退：`false`
- 文档同步：`2026-10-18`