# Naisi Lib 扩展下载

当前版本：`1.0.6`　　文档更新时间：`2026年10月18日`

本页提供 Naisi Lib PHP 原生扩展的版本、兼容性与安装说明。当前仅支持 PHP 8.4 及以上，并提供 PHP 8.4 和 PHP 8.5 构建。各 Linux 版本提供相同的 Naisi Lib 公开函数与常量；版本区别主要是 PHP API/ABI，二进制不能跨版本混用。Linux 和 Windows 扩展均不再提供公开下载，如需获取请联系耐撕网络：[fangsong@naisitech.com](mailto:fangsong@naisitech.com)。

> 许可文件必需：扩展二进制不能脱离有效的 Naisi Lib 许可和匹配的运行服务独立使用。申请许可、正式部署包或技术支持，请联系耐撕网络：[fangsong@naisitech.com](mailto:fangsong@naisitech.com)。

> 当前在线文档与 IDE 包已同步当前规范：153 个函数、145 个公开整数常量。文档同步不表示扩展二进制已重新发布；获取部署包时须确认包含新增 decimal、日期差、HEX、ASCII 标识接口、版本比较参数及序列化长度新入口，并按目标 PHP API/ABI 验收。

## 下载前必须确认

- 使用 `php -v` 确认 PHP 主次版本、操作系统和线程安全模式。
- 使用 `php -i` 查看 `PHP API`、`Thread Safety`、`Architecture` 和 `extension_dir`。
- PHP 版本必须为 8.4 或更高版本；PHP 8.3 及以下版本不受支持。
- PHP 8.4 的扩展不能加载到 PHP 8.5；即使文件名相同，不同 PHP API 的二进制也不能互换。
- Linux 当前构建为 `x86-64 NTS`；Windows 版本不再提供公开下载。
- 获取的扩展不包含客户许可文件、私有安装材料或 Agent。正式部署时，扩展、Agent、构建材料和许可必须属于同一受控交付版本。

## Windows 下载 {#windows-download}

### 当前不支持公开下载

Windows 扩展不再在本页面提供下载。需要 Windows 版本、匹配的运行库、许可文件或部署支持，请联系耐撕网络：[fangsong@naisitech.com](mailto:fangsong@naisitech.com)。

## Linux 下载 {#linux-download}

Linux 版本均为 `x86-64 NTS` 构建。它们提供相同的 PHP 函数和常量，必须根据 PHP 主次版本选择对应 SO。当前接口文档版本为 `1.0.6`；Build ID 与实际构建日期以对应客户的受控交付包为准。升级应保留既有编译身份与材料，并核对二进制、Agent 和许可配套关系。

Linux `.so` 文件不再在本页面提供下载。请确认所需 PHP 版本后，联系耐撕网络获取：[fangsong@naisitech.com](mailto:fangsong@naisitech.com)。

### PHP 8.4 NTS

- 版本区别：针对 PHP 8.4 Zend Module API 构建；二进制尺寸因 PHP 8.4 适配与链接布局略有变化，公开 Naisi Lib API 不变。
- 获取方式：联系 [fangsong@naisitech.com](mailto:fangsong@naisitech.com)，申请与 PHP 8.4 匹配的 `php_naisi_lib.so`。

### PHP 8.5 NTS

- 版本区别：当前最新验证的 PHP 分支，针对 PHP 8.5 Zend Module API 构建；不能加载到 PHP 8.4 或更早版本。
- 获取方式：联系 [fangsong@naisitech.com](mailto:fangsong@naisitech.com)，申请与 PHP 8.5 匹配的 `php_naisi_lib.so`。

Linux 受控交付包包含配套的 OpenSSL、SQLCipher 和 curl 运行库，由安装脚本部署到 `/etc/naisilib/bin`；操作系统基础运行库仍由系统提供。SQLCipher 只从固定路径加载，缺失或损坏时不会回退到系统搜索路径，不能用系统包管理器安装的任意版本替代配套依赖。扩展、Agent 和依赖应使用同一份已验证的交付包；更新依赖后须重启相关 PHP/Agent 进程并核对实际加载路径。将匹配 PHP API/ABI 的扩展放入实际 PHP 扩展目录，并在对应配置中启用：

```ini
extension=php_naisi_lib.so
```

## 版本选择总结

- Linux PHP 8.4：当前最低支持版本，只能用于 PHP 8.4。
- Linux PHP 8.5：只能用于 PHP 8.5。
- 所有版本包含相同的 Naisi Lib 业务功能；差异不代表函数更多或更少，而是为了匹配不同 PHP 二进制接口。
- PHP 8.3 及以下版本不提供，也不属于当前文档的支持范围。

## IDE 代码提示文件 {#ide-download}

PhpStorm 或其他静态分析工具可使用完整 IDE stub：

- 下载：[naisi-lib-ide.zip](/downloads/naisi-lib-ide.zip)
- ZIP 大小：`41523 bytes`
- ZIP SHA-256：`51e8d735d8825663522557c062b14be6865f45d35324ec2a8178f10bddb3710a`
- 压缩包内容：`ide/naisi-lib-ide.php`
- 内容：2026年10月18日同步快照，包含 153 个函数签名和 145 个常量；与当前 `stubs/ide/naisi-lib-ide.php` 逐字节一致。
- 使用限制：仅用于 IDE 建立索引和代码提示，禁止在 PHP 运行时 `include` 或 `require`。

## 许可文件与正式部署

获取扩展二进制不等于完成授权。Naisi Lib 在运行时会校验许可、匹配构建和运行环境。需要扩展文件、许可文件、Agent、正式安装材料或部署协助，请联系耐撕网络：[fangsong@naisitech.com](mailto:fangsong@naisitech.com)。

当前数据版本、指纹与地区功能需要匹配版本的扩展、Agent、材料、许可及 region.db。IDE 仅供静态索引，不代表二进制已在全部平台发布；运行报告最新选择器和采样规则以本站正文为准。