Laravel中Storage::put始终生成哈希文件名而非指定名称求助

问题原因 #

当调用Storage::disk("uploads")->put("my_image.jpg", $file)时，因为第二个参数是Illuminate\Http\UploadedFile实例，Laravel会默认把第一个参数my_image.jpg当作存储目录，自动生成哈希文件名存入该目录，最终出现my_image.jpg/哈希文件名.jpg的结构。

解决方案 #

1. 保留指定文件名存储到根目录 #

使用putFileAs方法，明确指定存储目录（空字符串表示磁盘根目录）和目标文件名：

$full_path = Storage::disk("uploads")->putFileAs('', $file, 'my_image.jpg');

执行后文件会直接存入storage/app/uploads/my_image.jpg，返回路径为my_image.jpg。

2. 自定义文件名规则 #

如果需要自定义命名（比如原文件名加时间戳、自定义哈希等），先生成目标文件名再传入putFileAs：

// 示例：原文件名前缀+时间戳+原扩展名
$customFilename = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME) . '_' . time() . '.' . $file->getClientOriginalExtension();
$full_path = Storage::disk("uploads")->putFileAs('', $file, $customFilename);

3. 使用文件内容调用put方法 #

若坚持使用put方法，可先获取文件内容字符串传入第二个参数，此时Laravel会把第一个参数当作文件名而非目录：

$full_path = Storage::disk("uploads")->put('my_image.jpg', $file->getContent());

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