Laravel头像管理：图片缩放与旧文件删除的最佳实践

use Illuminate\Support\Str;
use Intervention\Image\Facades\Image;
use Illuminate\Support\Facades\Storage;

// ... 在 avatarUpdate 方法内部
if ($r->hasFile('avatar')) {
    // 1. 生成唯一文件名，避免冲突
    $originalExtension = $r->avatar->getClientOriginalExtension();
    $uniqueFilename = Str::random(20) . '.' . $originalExtension;
    $directory = 'users'; // 存储目录

    // 2. 使用 intervention/image 处理图片
    $img = Image::make($r->avatar);

    // 调整图片大小，例如：宽高都为50px
    $img->resize(50, 50, function ($constraint) {
        $constraint->aspectRatio(); // 保持宽高比
        $constraint->upsize();      // 防止图片放大
    });

    // 3. 将处理后的图片保存到指定磁盘和路径
    // 注意：save() 方法可以直接接受路径，并写入文件内容
    // Storage::disk('public')->put() 也可以，但需要获取图片二进制内容
    $path = public_path('storage/' . $directory . '/' . $uniqueFilename); // 构建完整路径
    if (!file_exists(dirname($path))) {
        mkdir(dirname($path), 0777, true); // 确保目录存在
    }
    $img->save($path); // 保存到 public 磁盘对应的实际路径

    // 4. 更新用户头像路径到数据库
    $url = $directory . '/' . $uniqueFilename;
    User::where('id', Auth::id())->update([
        'avatar' => $url
    ]);
}

// ... 在 avatarUpdate 方法内部，文件上传处理之前
// 获取当前用户的旧头像路径
$oldAvatar = Auth::user()->avatar;

// 检查旧头像是否存在且不为空，然后从 'public' 磁盘删除
if ($oldAvatar && Storage::disk('public')->exists($oldAvatar)) {
    Storage::disk('public')->delete($oldAvatar);
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Intervention\Image\Facades\Image;
use App\Models\User; // 确保引入 User 模型

class UserController extends Controller
{
    public function avatarUpdate(Request $r)
    {
        // 1. 验证请求，确保上传的是图片文件
        $r->validate([
            'avatar' => 'required|image|mimes:jpeg,png,jpg,gif,svg|max:2048', // 2MB限制
        ]);

        // 获取当前用户的旧头像路径
        $oldAvatar = Auth::user()->avatar;

        // 2. 处理新头像上传
        if ($r->hasFile('avatar')) {
            // 生成唯一文件名和存储目录
            $originalExtension = $r->avatar->getClientOriginalExtension();
            $uniqueFilename = Str::random(20) . '.' . $originalExtension;
            $directory = 'users'; // 存储目录，例如：storage/app/public/users/

            // 使用 intervention/image 处理图片
            $img = Image::make($r->avatar);

            // 调整图片大小，例如：宽高都为50px
            $img->resize(50, 50, function ($constraint) {
                $constraint->aspectRatio(); // 保持宽高比
                $constraint->upsize();      // 防止图片放大
            });

            // 3. 将处理后的图片保存到 'public' 磁盘
            // 注意：这里直接使用 put 方法，传入图片二进制内容
            // 或者使用 $img->save(Storage::disk('public')->path($directory . '/' . $uniqueFilename));
            // 但为了简洁和避免路径问题，直接获取图片二进制内容并put更常见
            Storage::disk('public')->put($directory . '/' . $uniqueFilename, $img->encode());

            // 4. 更新用户头像路径到数据库
            $newAvatarPath = $directory . '/' . $uniqueFilename;
            User::where('id', Auth::id())->update([
                'avatar' => $newAvatarPath
            ]);

            // 5. 新头像上传成功并更新数据库后，再删除旧头像
            if ($oldAvatar && Storage::disk('public')->exists($oldAvatar)) {
                Storage::disk('public')->delete($oldAvatar);
            }
        }

        return redirect()->back()->with('success', '头像更新成功！');
    }
}