更新日志

最后更新时间：2026年10月18日 12:29

1.0.6（2026-10-18 文档同步）

按当前源码同步 153 个函数、145 个公开整数常量及 IDE 下载包，更新签名、参数、返回值、授权策略、检索摘要和导航分类。
新增 naisi_decimal_is_valid、naisi_date_diff_days、naisi_hex_is_valid 和 naisi_ascii_identifier_is_valid。
naisi_serialized_string_length_is_valid() 更名为 naisi_serialized_length_is_valid，参数和字节上限语义保持不变；旧名称不再导出。
移除 naisi_color_is_valid()、naisi_openid_is_valid()、naisi_landline_number_is_valid()；改用 naisi_value_is_valid 或 naisi_string_is_valid 搭配 NAISI_VALIDATOR_COLOR_HEX、NAISI_VALIDATOR_OPENID、NAISI_VALIDATOR_LANDLINE_NUMBER。naisi_string_byte_length_is_valid() 已移除；原始字节长度可用 PHP strlen() 显式检查，业务空值和上限规则由调用方确认。
新增信用代码格式、颜色、OpenID、座机和 ASCII 标识五个选择器；全串验证拒绝附加换行，不自动去除空白。
naisi_version_is_valid 增加比较版本与五种整数运算符，按十进制段比较并将缺失尾段视为 0。
修正字符串长度边界说明：综合校验只有 0 关闭限制，负数无效；单独长度校验要求非空且上限至少为 1。
本次为在线文档和 IDE 元数据同步，不表示扩展二进制重新发布。

本次只读同步 naisi-lib-c 当前规范，包含 153 个函数、135 个常量、21 个功能分组；其中指纹、版本与客户端标识升级规则来自 2026-10-03 的维护与开发文档。

新增 naisi_string_version，生成独立的 10 位小写 Base36 数据版本；IP 名单、实体键映射和字典版本改用此函数。
naisi_string_fingerprint 改为 12 位大小写敏感 Base62；旧指纹必须从原始输入重算，不能补位。
客户端标识使用 11+6+1 的 18 位 [a-z0-9] 格式，随机段允许重复，不再使用项目盐或内部指纹材料；旧 mark、关联会话和令牌需按业务流程重新建立。
naisi_region_code_to_name 增加名称格式参数与 4 个 NAISI_REGION_NAME_FORMAT_* 常量；国内名称缺失不兜底。地区五接口同步国际名称、region_kind、numeric 与父链字段规则。
AES 派生材料明确 GCM 返回 44 字符 Base64，CBC 返回 32 字节 key 与 25 字节 iv；不可直接把后者作为标准 AES-CBC IV。
全部函数签名、参数、返回值、授权模式、常量说明与 IDE 下载包对齐规范来源。旧构建固定输出不再作为当前算法或地区数据的输出保证。
BASIC/FULL/PROOF/NONE 规则对齐请求级授权文档；生产二进制须另外完成匹配构建、许可和业务验证。

新增 naisi_tree_get_descendant_ids、naisi_generate_order_code、naisi_phone_e164_is_valid、naisi_country_get_info、naisi_currency_get_info、naisi_accept_language_parse、naisi_language_tag_is_valid、naisi_timezone_get_info。
AES、RSA、Access Token 和 Login Credential 共 8 个接口的参数已调整；请按各函数页面的新签名迁移。
接口按用途整理为 21 个分组；国家、货币、语言和时区接口位于“国际化与本地化”。
当前源码契约为 152 个函数、131 个常量；部署时须确认扩展与 Agent 包含对应实现。

新增 naisi_amount_to_scaled_int、naisi_scaled_int_to_amount 和三个金额舍入常量；naisi_format_amount 改用十进制字符串，支持 0～6 位小数。
经纬度校验统一为 naisi_coordinates_is_valid，支持完整坐标、仅经度或仅纬度。
下架已移除的 naisi_normalize_amount()、naisi_longitude_is_valid()、naisi_latitude_is_valid()；迁移方式见新接口文档。
按用途整理为 20 个分组，统一新接口的签名、参数、返回值、调用示例和版本来源格式；修正地区接口的参数类型失败规则。
当前源码契约：144 个函数、131 个常量；文档示例参考测试站的 C 实现实际输入与输出。

新增 naisi_string_is_valid()，补齐 24 个内置验证器、Unicode 码点长度、上下限及失败示例。
Access Token 与 Login Credential 在 SaaS 模式支持整数 tenant_code = 0 平台作用域；正整数仍须获租户许可，严格区分整数、数字字符串及其他类型。
更新 Access Token、JWT、租户/用户签名、会话复核及权限解析的失败清理和引用输出规则，补充平台租户读取方式。
同步常量关联、IDE 提示包和首页统计：139 个公开函数、125 个常量、26 个功能模块，公开版本为 1.0.3。
本次为接口文档同步；具体平台的新增功能须使用已完成相应构建与授权验收的交付包。

新增 naisi_create_login_credential() 和 naisi_verify_login_credential()，说明 10～120 秒短期凭证、Code 映射、scope、代理字段及业务消费流程。
naisi_get_current_user_code() 新增可选引用参数 ?int &$act_user_code = null，保留原有无参调用和 UID 返回值。
更新 Access Token 的库内 AES 键名要求、租户说明和旧令牌重新签发说明；公开函数签名不变。
公开函数总数由 136 增至 138，版本为 1.0.2。