naisi_currency_get_info

按 ISO 4217 字母代码查询当前货币及资金代码的离线标准信息。

代码忽略 ASCII 大小写，但输入必须原样完整匹配，不自动移除首尾空白。数据来自 ISO 4217 Maintenance Agency 的当前 List One；历史代码不作为有效输入。

函数签名

function naisi_currency_get_info(string $currency_code): ?array

调用前提

应用入口先调用 naisi_is_ext_license_valid 并确认返回 true。只验证同一请求内已有的有效 FULL/BASIC 证明；没有证明或证明失效时立即返回失败值，不现场补做完整校验。

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

参数

$currency_code

• 类型：string
• 必填：是
• 默认值：无
• 方向：输入参数。

三位 ISO 4217 字母代码，例如 CNY、USD、JPY、EUR 或 GBP。

返回值

类型：array{code:string,numeric:string,name_en:string,name_zh:string,native_names:array<string,string>,minor_unit:int|string}|null

匹配时返回标准货币信息；代码无效、属于历史清单或未授权时返回 null。 minor_unit 为 ISO 标记的标准小数位整数（0 是有效值）；ISO 标记为 N.A. 时返回空字符串。 语言键与国家接口共用国家级语言筛选和 BCP 47 编码；机构记账单位另用发行方资料补充。 缺失译名已在补充数据源中填入已有 ISO 英文名称；native_names 无条目时为 []。 没有货币记录时整体返回 null；记录存在而缺少集合或属性，不视为主体缺失。 输入为货币代码，不是国家或语言代码；numeric 是 ISO 4217 货币数字代码。

调用示例

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

$currency_code = 'USD';

$result = naisi_currency_get_info($currency_code);
var_export($result);

版本信息

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