naisi_country_get_info

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

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

函数签名

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

调用前提

应用入口先调用 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 是带地区的语言标签。

调用示例

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

$country = 'CHN';

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

版本信息

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