# `naisi_currency_get_info`

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

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

## 函数签名

```php
function naisi_currency_get_info(string $currency_code): ?array
```

## 调用前提

应用入口先调用 [naisi_is_ext_license_valid](/web/developers/naisilib/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 货币数字代码。

## 调用示例

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

```php
$currency_code = 'USD';

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

## 版本信息

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