Laravel如何将图片存储到public/images而非storage/app/public/images

问题现象 #

在Laravel 8.83.27项目中，尝试将图片直接存入public/images目录，但实际图片自动存入storage/app/public/images，无任何报错。此前在另一项目执行php artisan storage:link后存储路径变为storage/app/public/images，将核心文件（控制器、视图、路由、模型等）复制到新项目后问题依旧。已修改filesystems.php配置，将public磁盘的root设为public_path()，并确认默认磁盘为public，但问题未解决。

相关代码 #

控制器store方法 #

public function store(CreateStoryRequest $request)
{
    $validatedData = $request->validated();

    if ($request->hasFile('image')) {
        $image = $request->file('image');
        $imageName = $image->getClientOriginalName(); // 获取文件原始名称
        $image->storeAs('public/images', $imageName); // 尝试存储到public/images
        $validatedData['image'] = $imageName; // 将图片名称加入验证数据
    }

    // 创建新的Story记录
    $story = Story::create($validatedData);

    // 重定向到列表页并提示成功
    return redirect()->route('story.index')->with('success', 'histoire créée avec succès');
}

filesystems.php配置 #

<?php

return [

    /*
    |--------------------------------------------------------------------------
    | 默认文件系统磁盘
    |--------------------------------------------------------------------------
    |
    | 这里可以指定框架默认使用的文件系统磁盘，支持本地磁盘及多种云存储磁盘。
    |
    */

    'default' => env('FILESYSTEM_DRIVER', 'local'),

    /*
    |--------------------------------------------------------------------------
    | 文件系统磁盘配置
    |--------------------------------------------------------------------------
    |
    | 你可以配置任意数量的文件系统磁盘，甚至可以为同一驱动配置多个磁盘。
    | 以下为各驱动的默认配置示例，包含必要选项。
    |
    | 支持的驱动："local", "ftp", "sftp", "s3"
    |
    */

    'disks' => [

        'local' => [
            'driver' => 'local',
            'root' => storage_path('app'),
        ],

        'public' => [
            'driver' => 'local',
            'root' => public_path(),
            'url' => env('APP_URL').'/images',
            'visibility' => 'public',
        ],

        's3' => [
            'driver' => 's3',
            'key' => env('AWS_ACCESS_KEY_ID'),
            'secret' => env('AWS_SECRET_ACCESS_KEY'),
            'region' => env('AWS_DEFAULT_REGION'),
            'bucket' => env('AWS_BUCKET'),
            'url' => env('AWS_URL'),
            'endpoint' => env('AWS_ENDPOINT'),
        ],

    ],

    /*
    |--------------------------------------------------------------------------
    | 符号链接配置
    |--------------------------------------------------------------------------
    |
    | 这里配置执行`storage:link` Artisan命令时创建的符号链接，数组键为链接位置，值为目标路径。
    |
    */

    'links' => [
        public_path('storage') => storage_path('app/public'),
    ],

];

问题原因及解决办法 #

核心原因 #

1. 默认磁盘配置被.env覆盖：尽管filesystems.php中默认磁盘设为public，但如果.env文件存在FILESYSTEM_DRIVER=local，会优先使用local磁盘，而local磁盘的根目录是storage/app，加上代码中指定的public/images路径，最终会存入storage/app/public/images。
2. storeAs方法路径参数错误：当前代码中storeAs('public/images', $imageName)的路径参数，会基于当前使用的磁盘根目录拼接，若使用local磁盘，自然会指向storage目录下的路径。

解决步骤 #

1. 确认.env配置：打开.env文件，确保存在FILESYSTEM_DRIVER=public，若无则添加；添加或修改后执行php artisan config:clear清除配置缓存。
2. 修正storeAs调用：
   • 方式一：明确指定使用public磁盘，修改存储代码：

     $image->storeAs('images', $imageName, 'public');
     

     由于public磁盘的根目录是public_path()，images会直接拼接为public/images，符合需求。
   • 方式二：若默认磁盘已设为public，可简化为：

     $image->storeAs('images', $imageName);
     

     此时无需指定磁盘，默认使用public磁盘存储。

额外建议 #

• 避免使用文件原始名称存储，易出现重名覆盖问题，建议生成唯一文件名，例如：

  $imageName = Str::random(10) . '.' . $image->getClientOriginalExtension();
  

• 此前创建的storage:link符号链接无需删除，该链接指向storage/app/public，与直接存储到public/images的逻辑互不影响。

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