加密与可信
从数据保密到签名核验，将不同安全职责分别组织。
- 加密与摘要
- 数据签名
- 动态验证码（TOTP）
Naisi Lib · PHP 8.4+ NATIVE EXTENSION
纯 C 核心。
把通用能力做深。
将加密、身份校验、数据处理与 ERP 通用能力，组织为清晰的功能分组。让项目复用底层实现，把精力留给业务本身。
153公开函数
21功能分组
131关联常量
公开版本 1.0.6 · 完整函数列表见开发文档
Naisi Lib / naisi_*()
01加密与可信AES-GCM · RSA · 签名
02业务数据金额 · 校验 · 编码
03应用运行字典 · 缓存 · 路由
按职责分类，以公开函数调用。
01 / FUNCTION CATEGORIES
分类清楚，复用才有方向。
将文档的 21 个功能分组归入六类使用场景。
从业务问题出发，找到对应的底层能力。
身份与访问
许可、会话、权限和客户端标识各有入口，调用边界更清楚。
- 许可与运行环境
- 身份、令牌与会话
- 权限与登录身份
- 客户端标识
数据处理与校验
覆盖输入检查、金额精度、编码转换和常见数据整理。
- 数据校验
- 金额处理
- 编码与序列化
- 字符串处理
- 数组与数据处理
业务基础能力
把编号、时间、地区和国际化等常用工作沉淀为公共函数。
- 编号与随机标识
- 日期、时间与历法
- 地区查询
- 国际化与本地化
字典与文件
提供平台及租户字典查询，以及文件读写、缓存与摘要能力。
- 数据字典
- 文件与缓存
网络与应用
从 IP 名单到配置解析、路由编译与分页，衔接应用运行。
- 网络与 IP
- XML 与配置
- 请求、路由与分页
完整函数列表、签名、参数与返回约定见开发文档。
02 / ENCRYPTION & TRUST
安全能力，讲清机制与边界。
加密、签名、摘要和密钥派生分别承担职责。
既说明能力，也保留接入时需要遵守的约定。
加密，也校验完整性。
使用随机 nonce 生成认证密文；解密时同时核验身份、密钥与认证标签，认证失败不会返回部分明文。
AES 密文绑定 Customer ID、Build ID、底层密钥与业务盐；更换 Build ID 时，持久化密文需要迁移。
混合加密，分工清楚。
RSA 与 AES-GCM 组合封装数据，每次生成新的内容密钥和 nonce，将非对称密钥保护与内容加密衔接起来。
跨设备解密需要相同客户身份、密钥标识与 RSA 密钥对；更换密钥前需迁移旧密文。
统一签名与验签约定。
规范化请求字段并按稳定规则排序，配套客户端、租户和用户签名接口，减少各项目重复拼装签名规则。
签名用于核验请求数据，不替代加密；客户端、租户与用户接口按各自上下文调用。
摘要与密钥材料，各司其职。
密码接口生成不可逆存储摘要；密钥派生接口结合项目私有盐和输入盐生成材料，将摘要、派生与可逆加密分开使用。
密码摘要不检查密码强度；业务层仍需拒绝空密码和弱密码，密钥与构建材料按文档管理。
03 / ENGINEERING ADVANTAGES
优势，落在实现细节里。
从执行路径到数据精度，
为重复出现的工程问题建立一致的处理方式。
纯 C 的底层实现
将高频处理下沉到原生扩展，减少语言层重复组合调用。当前公开适配为 PHP，实际性能按业务数据与运行环境验证。
金额精度有明确约定
金额使用十进制字符串处理，支持 0～6 位精度与缩放整数转换，检查整数范围，避免先经浮点数转换引入偏差。
认证结果在请求中复用
Agent 验证并发布许可、心跳与密钥快照；PHP 请求消费认证后的内存结果，部分数据函数复用请求证明，快照缺失则失败关闭。
类型、返回与失败可查
接口按原始 PHP 类型匹配，明确参数边界与失败值。配套函数签名、常量和 IDE stub，接入时能区分合法的 0、空字符串与失败。