Laravel上传文件时如何自定义文件名（如product-code_product-name.jpg）

核心实现方式 #

要生成product-code_product-name.jpg这类格式的文件名，关键是自定义名称前缀 + 原文件的正确扩展名，直接通过storeAs方法即可实现：

1. 已知产品信息的场景 #

假设你已有产品编码（如$productCode = '111'）和产品名称（如$productName = 'instant-noodle'），可按以下方式拼接文件名：

// 获取上传文件的扩展名（如jpg、png）
$extension = $request->file('the_file')->getClientOriginalExtension();

// 拼接自定义格式的文件名
$fileName = "{$productCode}_{$productName}.{$extension}";

// 执行文件存储
$path = $request->file('the_file')->storeAs('the_path', $fileName, 'public');

return $path;

2. 动态生成唯一前缀的场景 #

如果没有固定产品信息，可通过时间戳、随机字符串生成唯一前缀，避免文件名重复：

use Illuminate\Support\Str;

$extension = $request->file('the_file')->getClientOriginalExtension();
// 生成时间戳+8位随机字符串的前缀
$prefix = time() . '_' . Str::random(8);
$fileName = "{$prefix}.{$extension}";

$path = $request->file('the_file')->storeAs('the_path', $fileName, 'public');

其他实现方式 #

方式一：基于hashName自定义命名 #

利用Laravel自带的hashName生成唯一哈希串，再替换为自定义前缀：

$file = $request->file('the_file');
// 获取原文件扩展名
$extension = $file->getClientOriginalExtension();
// 自定义文件名
$fileName = "111_instant-noodle.{$extension}";

$path = $file->storeAs('the_path', $fileName, 'public');

方式二：全局自定义存储规则 #

如果需要全局统一命名规则，可创建自定义存储类：

1. 编写自定义存储类：

namespace App\Services;

use Illuminate\Filesystem\FilesystemAdapter;

class CustomStorage extends FilesystemAdapter
{
    protected function getFilename($name)
    {
        // 在这里定义全局命名规则，示例用固定产品信息
        $productCode = '111';
        $productName = 'instant-noodle';
        $extension = pathinfo($name, PATHINFO_EXTENSION);
        return "{$productCode}_{$productName}.{$extension}";
    }
}

2. 在config/filesystems.php中配置public磁盘使用该类：

'disks' => [
    'public' => [
        'driver' => 'local',
        'root' => storage_path('app/public'),
        'url' => env('APP_URL').'/storage',
        'visibility' => 'public',
        'adapter' => App\Services\CustomStorage::class,
    ],
],

3. 使用时直接调用store方法即可自动应用规则：

$path = $request->file('the_file')->store('the_path', 'public');

注意事项 #

• 若产品名称含特殊字符（中文、空格等），可使用Str::slug处理为安全格式：

$productName = Str::slug('方便面'); // 转换为instant-noodle（根据语言配置）
$fileName = "{$productCode}_{$productName}.{$extension}";

• 为避免文件名重复，可在名称后添加递增数字或UUID等唯一标识。

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