Laravel中图片/文件上传、获取与更新的正确方法及示例问询

1. Filesystems 磁盘配置 #

打开config/filesystems.php，配置用于公开访问文件的磁盘（以public磁盘为例，可直接存储到项目public目录下的uploads文件夹）：

'disks' => [
    // 保留原有磁盘配置...

    'public' => [
        'driver' => 'local',
        'root' => public_path('uploads'), // 文件存储根目录
        'url' => env('APP_URL').'/uploads', // 访问文件的基础URL
        'visibility' => 'public', // 公开可见
    ],
],

如果选择使用Laravel默认的public磁盘（文件存储在storage/app/public），则需执行以下命令创建软链接，让外部能访问存储的文件：

php artisan storage:link

此时默认public磁盘的配置为：

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],

2. 控制器中的上传与更新方法 #

以下是包含上传、更新逻辑的示例控制器代码（假设存在Post模型，需存储图片路径到数据库）：

use Illuminate\Http\Request;
use App\Models\Post;
use Illuminate\Support\Facades\Storage;

class PostController extends Controller
{
    // 上传图片并创建新记录
    public function store(Request $request)
    {
        // 验证上传文件
        $request->validate([
            'image' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048', // 限制图片类型和大小
            'title' => 'required|string|max:255',
            // 其他字段验证规则...
        ]);

        // 将文件存储到public磁盘的posts子目录，自动生成唯一文件名
        $imagePath = $request->file('image')->store('posts', 'public');

        // 保存记录到数据库
        Post::create([
            'title' => $request->title,
            'image_path' => $imagePath, // 存储相对路径（如posts/abc123.jpg）
            // 其他字段赋值...
        ]);

        return redirect()->back()->with('success', '图片上传成功');
    }

    // 更新已有记录的图片
    public function update(Request $request, Post $post)
    {
        $request->validate([
            'image' => 'nullable|image|mimes:jpeg,png,jpg,gif|max:2048', // 图片可选
            'title' => 'required|string|max:255',
            // 其他字段验证规则...
        ]);

        // 如果有新图片上传
        if ($request->hasFile('image')) {
            // 删除旧图片（若存在）
            if ($post->image_path) {
                Storage::disk('public')->delete($post->image_path);
            }

            // 存储新图片
            $imagePath = $request->file('image')->store('posts', 'public');
            $post->image_path = $imagePath;
        }

        // 更新其他字段
        $post->title = $request->title;
        $post->save();

        return redirect()->back()->with('success', '图片更新成功');
    }
}

3. 获取图片完整URL #

方式1：直接使用Storage门面获取 #

通过磁盘的url()方法传入存储的相对路径，生成完整访问URL：

$post = Post::find(1);
$fullImageUrl = Storage::disk('public')->url($post->image_path);
// 输出示例：http://your-app-domain/uploads/posts/abc123.jpg

方式2：在模型中定义访问器 #

在Post模型中添加访问器，简化URL获取：

// app/Models/Post.php
public function getImageUrlAttribute()
{
    return Storage::disk('public')->url($this->image_path);
}

使用时直接调用模型属性：

echo $post->image_url; // 直接输出完整URL

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