Laravel Docker容器中解压Zip文件出现异常报错求助

在Laravel 9、PHP 8.1.7的Docker容器环境中，控制器执行ZipArchive解压代码时，文件已成功复制到目标目录，但抛出如下异常：

ErrorException
ZipArchive::extractTo(/var/www/html/public/my_folder/my_file.xml): Operation failed: Operation not permitted

相同代码在php artisan tinker中运行正常，目标文件夹权限为777，文件所属为1000:1000。

• 检查PHP-FPM与CLI的运行用户差异
  Docker中Laravel通常以www-data用户运行PHP-FPM，而tinker以执行命令的用户（如root）运行。即使文件夹权限为777，若容器与宿主机的用户ID（UID/GID）映射不匹配，可能触发文件系统安全限制：

  1. 查看PHP-FPM运行用户：ps aux | grep php-fpm
  2. 对比文件的UID/GID（如补充信息中的1000:1000），若二者不一致，可调整容器运行用户（通过Dockerfile的USER指令），或修改宿主机文件的UID/GID匹配容器内的www-data。

• 排查open_basedir限制
  PHP-FPM与CLI可能使用不同的php.ini配置，若FPM的open_basedir未包含解压目标目录，会触发权限报错：

  1. 查看FPM的open_basedir设置：在容器内执行php-fpm -i | grep open_basedir
  2. 对比CLI的设置：php -i | grep open_basedir
  3. 若存在差异，修改FPM的php.ini，将目标目录加入open_basedir列表。

• 调整ZipArchive解压参数
  部分Zip包内文件带有特殊属性，解压时ZipArchive尝试设置这些属性失败导致异常（即使文件已复制），可尝试指定解压参数跳过属性设置：

  $zip = new ZipArchive();
  $result = $zip->open("/var/www/html/public/my_archive.zip");
  if ($result === TRUE) {
      // 跳过文件属性设置，强制覆盖已存在文件
      $zip->extractTo("/var/www/html/public/my_folder", null, ZipArchive::FL_OVERWRITE | ZipArchive::FL_NO_ATTR);
  }
  $zip->close();
  

• 验证Docker挂载目录权限
  若public目录是宿主机挂载目录，宿主机文件系统的权限或特性（如Windows NTFS挂载到Linux容器）可能影响容器内操作：

  1. 将归档文件和解压目录移至容器内部非挂载目录（如/tmp）测试，若不再报错，说明是挂载目录的权限问题，需调整宿主机目录权限或挂载参数。

• 捕获详细错误信息
  控制器的错误报告级别可能高于CLI，导致警告被抛出为异常，可通过try-catch捕获详细错误：

  try {
      $zip = new ZipArchive();
      $result = $zip->open("/var/www/html/public/my_archive.zip");
      if ($result === TRUE) {
          $zip->extractTo("/var/www/html/public/my_folder");
      }
      $zip->close();
  } catch (\Exception $e) {
      dd($e->getMessage(), $e->getTraceAsString());
  }
  

内容的提问来源于stack exchange，提问作者cesare