Laravel中使用putFileAs方法时如何让文件保存路径全部使用反斜杠？

兄弟，我太懂你这种被混合斜杠搞糟心的感觉了！你已经精准定位到问题根源了——就是Laravel核心里FilesystemAdapter.php那行用正斜杠硬拼接路径的代码，把你前面的反斜杠路径给“污染”了。咱们来几个实用的解决办法：

为啥会出现混合斜杠？ #

你看到的源码这行就是罪魁祸首：

$result = $this->put($path = trim($path.'/'.$name, '/'), $stream, $options);

不管你传入的$path用的是啥斜杠，这里都会强制用/来拼接文件名，最后就出现了\some_folder\2023/document.pdf这种半正半反的路径。

解决办法 #

方法一：手动拼完整路径，绕过putFileAs的拼接逻辑（最直接）

既然它非要硬插正斜杠，那咱们自己把包含文件名的完整反斜杠路径拼好，直接用put方法上传，完全绕开它的拼接逻辑：

// 先构建好全反斜杠的完整目标路径
$fullFilePath = "\some_folder\\$year\\document.$extension";
// 用put方法上传文件内容
Storage::disk('disk')->put($fullFilePath, $request->file('document')->get());

这个方法简单粗暴，一次见效，完全符合你要的全反斜杠路径需求。

方法二：自定义适配器，永久解决（适合全局需要的场景）

如果你的项目很多地方都需要统一用反斜杠路径，那可以重写Laravel的文件系统适配器，把拼接逻辑换成系统原生的分隔符：

1. 新建一个自定义适配器类，继承原有的FilesystemAdapter：

class CustomFilesystemAdapter extends \Illuminate\Filesystem\FilesystemAdapter
{
    public function putFileAs($path, $file, $name, $options = [])
    {
        $file = is_string($file) ? $this->getDriver()->readStream($file) : $file;

        if (is_resource($file)) {
            $options = is_string($options) ? ['visibility' => $options] : $options;

            // 把原来的 '/' 换成 PHP 原生的目录分隔符（Windows下就是反斜杠）
            $result = $this->put($path = trim($path . DIRECTORY_SEPARATOR . $name, DIRECTORY_SEPARATOR), $file, $options);

            fclose($file);

            return $result ? $path : false;
        }

        return false;
    }
}

2. 然后在Laravel里注册这个自定义适配器（具体可以在文件系统配置或者服务提供者里设置），之后所有调用putFileAs的地方都会自动用对应系统的分隔符，不用再手动操心。

方法三：临时应急重命名（不推荐）

如果只是临时用一次，也可以先按原来的方式上传，再把混合斜杠的路径改成全反斜杠并重命名文件，但这个方法有并发风险，而且步骤繁琐，除非万不得已不建议用。

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