# `naisi_region_code_to_name`

将共用编码转为名称；可包含真实父级链，默认使用国内简称且不加分隔符。
name_format 仅影响国际名称：NAISI_REGION_NAME_FORMAT_ZH=1 取 zh_name（默认），
LOCAL=2 取 name，LOCAL_ZH=3 逐级输出 name（zh_name），EN=4 取 en_name；常量均有 NAISI_REGION_NAME_FORMAT_ 前缀。
混合格式中两种名称完全相同时只显示一次。国际无简称，忽略 use_short_name。
国内直接按 use_short_name 选择 short_name/name；缺少所选名称返回 false，不用其他字段兜底。
任一级所选名称为空、格式值无效、不存在、未授权或读取失败返回 false。
当前地区已删除时在最终字符串外包一层 <del>...</del>。

## 函数签名

```php
function naisi_region_code_to_name(int $region_code, bool $with_hierarchy = true, bool $use_short_name = true, string $delimiter = '', int $name_format = NAISI_REGION_NAME_FORMAT_ZH): string|false
```

## 调用前提

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

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

## 参数

### `$region_code`

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

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

### `$with_hierarchy`

- 类型：`bool`
- 必填：否
- 默认值：`true`
- 方向：输入参数。

是否包含完整真实父级链，默认为 true。

### `$use_short_name`

- 类型：`bool`
- 必填：否
- 默认值：`true`
- 方向：输入参数。

国内地区是否选用 short_name；false 选择 name。所选字段为空返回 false，不回退到其他字段；国际地区忽略此参数。

### `$delimiter`

- 类型：`string`
- 必填：否
- 默认值：`''`
- 方向：输入参数。

各级地区名称之间的分隔符，默认为空字符串。

### `$name_format`

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

国际名称格式：`NAISI_REGION_NAME_FORMAT_ZH`（中文）、`NAISI_REGION_NAME_FORMAT_LOCAL`（当地官方语言）、`NAISI_REGION_NAME_FORMAT_LOCAL_ZH`（当地名称加中文）、`NAISI_REGION_NAME_FORMAT_EN`（英文）。仅影响国际地区；非法值失败。

## 返回值

成功返回 UTF-8 名称字符串，包含所选真实父级名称；当前记录已删除时外包 `<del>...</del>`。任一级所选名称为空、格式值无效、未命中、未授权或读取失败返回 `false`，不使用其他名称字段兜底。

## 关联常量

- [`NAISI_REGION_NAME_FORMAT_ZH`](/web/developers/naisilib/const#naisi-region-name-format-zh) = `1` — 国际地区中文名称（zh_name），默认格式。
- [`NAISI_REGION_NAME_FORMAT_LOCAL`](/web/developers/naisilib/const#naisi-region-name-format-local) = `2` — 国际地区官方语言名称（name）。
- [`NAISI_REGION_NAME_FORMAT_LOCAL_ZH`](/web/developers/naisilib/const#naisi-region-name-format-local-zh) = `3` — 国际地区逐级显示官方语言名称（中文名称），两种名称相同时只显示一次。
- [`NAISI_REGION_NAME_FORMAT_EN`](/web/developers/naisilib/const#naisi-region-name-format-en) = `4` — 国际地区英文名称（en_name）。

## 调用示例

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

```php
$region_code = 361104;
$with_hierarchy = true;
$use_short_name = false;
$delimiter = '/';

$result = naisi_region_code_to_name($region_code, $with_hierarchy, $use_short_name, $delimiter, NAISI_REGION_NAME_FORMAT_ZH);
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`