BaDouCMS的PbootCMS 数据转移插件在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的方式手动启用。
三、具体解决步骤
-
定位PHP配置文件(php.ini)
进入Windows宝塔面板,找到对应站点使用的PHP8.2版本管理入口,通过“配置文件”选项直接打开php.ini文件;也可通过服务器文件路径找到该文件(默认路径通常为:宝塔安装目录\php\php-8.2.x\php.ini)。
-
启用zip扩展
在php.ini文件中,查找是否存在 “extension=zip” 配置项:
-
若存在但被注释(行首有“;”),删除注释符号“;”,确保该行正常生效;
-
若不存在,直接在文件合适位置(如“Dynamic Extensions”拓展配置区域)添加一行:
extension=zip。
-
-
重启Web服务器
保存php.ini文件修改后,返回宝塔面板,重启nginx服务(或“重启Web服务”),使配置生效。
四、验证与后续
配置生效后,重新运行PbootCMS数据迁移插件,即可正常使用,“Class 'ZipArchive' not found”报错解决。若问题仍存在,可检查php.ini文件路径是否正确(确保修改的是当前站点使用的PHP版本对应的配置文件),或重新确认配置项是否正确添加并保存。











这一切,似未曾拥有