# `naisi_country_get_info`

按 ISO 3166-1 代码、数字代码或标准英文短名查询离线国家信息。

Alpha-2、Alpha-3 和英文名忽略 ASCII 大小写，但输入必须原样完整匹配，不自动移除
首尾空白；标准英文名自身包含的空格不受影响。数字代码可传三位字符串或 0 到 999
的整数。民间简称和正式全称不作为别名。

## 函数签名

```php
function naisi_country_get_info(string|int $country): ?array
```

## 调用前提

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

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

## 参数

### `$country`

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

ISO 3166-1 Alpha-2、Alpha-3、Numeric 或内置标准英文短名。

## 返回值

类型：`array{alpha2:string,alpha3:string,numeric:string,name_en:string,name_zh:string,official_name_en:string,official_name_zh:string,primary_language:string,native_names:array<string,array{short_name:string,full_name:string}>,calling_code:string,calling_prefix:string}|null`

匹配时返回国家标准信息，输入无效、国家不存在或未授权时返回 null。
native_names 筛选国家级官方或事实官方语言，排除仅地区官方语言；
CLDR 状态由已核实的国家级例外表修正。保留项顺序不变，不代表全部法定语言均有译名。
primary_language 从筛选结果中按 CLDR 使用人口比例选择；比例相同保留数据顺序，
没有语言资料时为空字符串。语言选择不依赖译名是否齐全。每项名称包含 short_name 和 full_name；
名称优先采用 CLDR 短名和同语言 ISO 全称译文；缺项由已记录来源的同语言资料补充。
名称已在数据源中补齐：同语言短名与全称互补，两者均无译文时存入已有 ISO 英文名称。
填充值用于显示，不表示已核实该语言译文；运行时与生成器不自动执行名称兜底。
所有缺失标量子项均为空字符串，缺少集合为 []；不返回 null 子项。
语言 code 使用 BCP 47（如 zh-Hans、ko、en），非空主语言必定对应其中一项。
ISO 国家代码不等于语言代码；zh-Hans 是语言和文字标记，zh-CN 是带地区的语言标签。

## 调用示例

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

```php
$country = 'CHN';

$result = naisi_country_get_info($country);
var_export($result);
```

## 版本信息

- 自版本：`1.0.6`
- 实现模块：`country`
- 授权类别：`LICENSE` / `PROOF`
- 失败回退：`null`
- 文档同步：`2026-10-18`