Windows 宝塔环境下报错：Class 'ZipArchive' not found

一、问题背景

本地搭建Windows宝塔环境（采用nginx+PHP8.2+MYSQL5.7，Linux宝塔环境可忽略），在使用PbootCMS数据迁移插件时，出现 “Class 'ZipArchive' not found” 报错。经检测，核心原因是PHP的zip拓展未安装/启用。

二、关键说明

与Linux宝塔不同，Windows宝塔面板的拓展列表中通常没有独立的ZIP拓展安装选项。实际上，Windows宝塔的PHPZip扩展默认是启用状态；若未启用，可通过直接修改PHP配置文件php.ini的方式手动启用。

三、具体解决步骤

1. 定位PHP配置文件（php.ini）
   进入Windows宝塔面板，找到对应站点使用的PHP8.2版本管理入口，通过“配置文件”选项直接打开php.ini文件；也可通过服务器文件路径找到该文件（默认路径通常为：宝塔安装目录\php\php-8.2.x\php.ini）。

2. 启用zip扩展
   在php.ini文件中，查找是否存在 “extension=zip” 配置项：

   • 若存在但被注释（行首有“;”），删除注释符号“;”，确保该行正常生效；
   • 若不存在，直接在文件合适位置（如“Dynamic Extensions”拓展配置区域）添加一行：extension=zip。
3. 重启Web服务器

保存php.ini文件修改后，返回宝塔面板，重启nginx服务（或“重启Web服务”），使配置生效。

四、验证与后续

配置生效后，重新运行PbootCMS数据迁移插件，即可正常使用，“Class 'ZipArchive' not found”报错解决。若问题仍存在，可检查php.ini文件路径是否正确（确保修改的是当前站点使用的PHP版本对应的配置文件），或重新确认配置项是否正确添加并保存。