使用Maatwebsite/Excel导入Excel文件时出现Class "ZipArchive" not found错误的求助

兄弟，我之前踩过一模一样的坑！这个错误跟Maatwebsite/Excel包本身没啥关系，核心问题是你的PHP环境没安装Zip扩展——毕竟Excel文件（尤其是xlsx格式）本质是压缩包，Maatwebsite底层依赖ZipArchive类来解析它。

给你分不同环境说下解决办法：

本地开发环境（XAMPP/WAMP） #

• 找到你PHP目录下的php.ini文件，打开后搜索extension=zip，把这行前面的分号（;）删掉，保存文件。
• 重启你的Apache/Nginx服务器，再重新跑导入代码试试。如果搜不到这行，可能需要手动添加，或者确认你的PHP安装包自带了Zip扩展（大部分主流集成环境都有，只是默认没开启）。

Linux服务器（Ubuntu/Debian系列） #

• 直接用包管理器安装对应PHP版本的Zip扩展：

  # 通用版本（自动匹配当前PHP）
  sudo apt-get install php-zip
  # 特定版本比如PHP8.1
  sudo apt-get install php8.1-zip
  

• 安装完成后重启Web服务：

  sudo systemctl restart apache2
  # 如果用Nginx就是
  sudo systemctl restart nginx
  

Linux服务器（CentOS/RHEL系列） #

• 用yum安装：

  # 通用版本
  sudo yum install php-zip
  # 特定版本比如PHP7.4
  sudo yum install php7.4-zip
  

• 重启服务：

  sudo systemctl restart httpd
  

Docker/Laravel Sail环境 #

• 如果是用Docker容器部署，需要在项目的Dockerfile里添加安装Zip扩展的步骤，比如：

  RUN apt-get update && apt-get install -y \
      php-zip \
      && rm -rf /var/lib/apt/lists/*
  

• 然后重建容器：

  sail build --no-cache
  sail up -d
  

最后可以验证下扩展是否安装成功：执行php -m命令，看看输出里有没有zip；或者写个简单的phpinfo页面，搜索zip相关的配置项确认。

备注：内容来源于stack exchange，提问作者AldiState