Laravel中file_put_contents保存文件到网络共享盘报错

该报错和laravel-snappy的PDF生成逻辑无关，本地磁盘可正常写入已经排除代码、扩展层面的问题，故障核心是Windows环境下PHP服务的运行上下文无网络共享资源访问权限：

• 手动在资源管理器挂载的Z:盘符属于当前登录用户的私有映射，PHP以系统服务身份运行时，无法读取用户级的盘符挂载配置，因此触发No such file or directory报错
• 直接写UNC路径\\x.x.x.x\test触发Invalid argument报错，一是PHP字符串中反斜杠属于转义字符，未转义的路径格式非法；二是PHP运行账号未获得共享目录的读写授权，且Local System等内置系统账号默认无网络资源访问权限。

按以下优先级依次验证，不要用登录用户身份在命令行测试，所有测试必须通过Web访问PHP脚本执行，避免账号上下文不一致导致的误判：

• 优先使用标准UNC路径，弃用挂载盘符
  代码中书写UNC路径时所有反斜杠必须双写转义，禁止正斜杠反斜杠混用，写入前提前校验目录权限：

  // 路径中每个反斜杠转义为两个反斜杠，末尾拼接完整文件名
  $savePath = "\\\\x.x.x.x\\共享目录名\\test\\" . $fileName;
  $saveDir = dirname($savePath);
  // 目录不存在则递归创建
  if (!is_dir($saveDir)) {
      mkdir($saveDir, 0775, true);
  }
  // 直接调用snappy的save方法写入即可
  $pdf->save($savePath);
  

• 配置共享目录访问权限
  • 确认Web服务运行账号：IIS默认关联IUSR账号与IIS_IUSRS用户组，Apache/Nginx/集成环境（phpstudy/宝塔Windows版）可在服务属性面板查看「登录身份」对应的账号
  • 不要使用Local System内置账号运行Web服务，单独创建一个普通本地账号，将Web服务的运行身份修改为该账号，同时在共享盘所在服务器创建同用户名、同密码的同名账号
  • 在共享盘服务器上给目标目录配置两层权限：
    • 共享权限：添加上述账号，授予读取、写入、修改权限
    • 本地安全权限：文件夹「属性-安全」选项卡中添加上述账号，授予列出文件夹内容、读取、写入、修改权限
• 若必须使用盘符映射，配置系统级永久挂载
  不要在用户登录后手动映射盘符，以管理员身份打开命令提示符，分别在64位C:\Windows\System32\cmd.exe和32位C:\Windows\SysWOW64\cmd.exe中执行以下命令，实现全上下文的盘符挂载：

  net use Z: \\x.x.x.x\共享目录名 /persistent:yes /user:有权限的账号名 账号密码
  

• 排查边缘问题
  • 检查php.ini中open_basedir配置，将共享路径加入允许访问列表，或临时关闭该配置验证
  • 确认Web服务器与共享服务器之间445端口连通，SMB协议版本匹配，无防火墙/安全组拦截
  • 先写最小测试脚本验证写入能力，排除业务代码干扰：

    <?php
    $testPath = "\\\\x.x.x.x\\共享目录名\\test\\test.txt";
    var_dump(file_put_contents($testPath, "test content"));
    

    若该脚本能正常写入，再逐步集成PDF生成逻辑。

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