NaisiNaisi Lib Docs

naisi_region_code_to_name

查看 Markdown

将共用编码转为名称；可包含真实父级链，默认使用国内简称且不加分隔符。 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>。

函数签名

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 并确认返回 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，不使用其他名称字段兜底。

关联常量

调用示例

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

$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