Laravel头像处理：实现图片缩放与旧文件删除的正确姿势

public function avatarUpdate(Request $r)
{
    Storage::delete('users'.'/'.Auth::user()->avatar); // 问题1: 删除逻辑可能不正确
    if ($r->hasFile('avatar')) {
        $thumbnailImage = Image::make($r->avatar);
        $filename = $thumbnailImage->resize(50, 50); // 问题2: 这里只是对图片对象进行操作，返回的是图片实例
        $filename = $r->avatar->getClientOriginalName(); // 问题3: $filename 被原始文件名覆盖，之前的缩放操作结果被丢弃
        $r->avatar->storeAs('users', $filename, 'public'); // 问题4: 存储的是原始文件，而不是缩放后的文件
        $url = 'users/';
        User::where('id', Auth::id())->update([
            'avatar' => $url . $filename
        ]);
    }
    return redirect()->back();
}

use Intervention\Image\Facades\Image;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str; // For unique filename

// ... 在控制器方法内部
if ($request->hasFile('avatar')) {
    $avatarFile = $request->file('avatar');

    // 1. 生成唯一文件名
    $filename = 'users/' . Str::uuid() . '.' . $avatarFile->getClientOriginalExtension();

    // 2. 使用 Intervention Image 处理图片
    $img = Image::make($avatarFile->getRealPath()); // 从临时路径加载图片

    // 缩放并裁剪图片到指定尺寸 (例如 50x50)，保持纵横比，并避免放大过小的图片
    $img->fit(50, 50, function ($constraint) {
        $constraint->upsize(); // 如果图片小于指定尺寸，则不放大
    });

    // 3. 将处理后的图片内容保存到 public 磁盘
    // encode() 方法将图片转换为指定格式的二进制数据，默认是原始格式或JPEG
    Storage::disk('public')->put($filename, $img->encode());

    // 此时，$filename 包含了存储在 'public' 磁盘中的处理后图片的路径
    // ... 之后可以将 $filename 存储到数据库
}

use Illuminate\Support\Facades\Storage;
use App\Models\User; // 假设你的用户模型

// ... 在控制器方法内部，在处理新头像之前
$user = Auth::user();
$oldAvatarPath = $user->avatar; // 获取当前用户的旧头像路径，例如 'users/old_avatar.jpg'

// 确保旧头像路径存在，并且文件确实存在于 public 磁盘中
if ($oldAvatarPath && Storage::disk('public')->exists($oldAvatarPath)) {
    Storage::disk('public')->delete($oldAvatarPath);
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Storage;
use Intervention\Image\Facades\Image;
use Illuminate\Support\Str; // 用于生成唯一文件名
use App\Models\User; // 确保引入你的 User 模型

class UserController extends Controller
{
    /**
     * 更新用户头像。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\RedirectResponse
     */
    public function avatarUpdate(Request $request)
    {
        // 1. 验证上传文件
        $request->validate([
            'avatar' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048', // 必须是图片，支持常见格式，最大2MB
        ], [
            'avatar.required' => '请选择一个头像文件。',
            'avatar.image' => '上传的文件必须是图片。',
            'avatar.mimes' => '图片格式必须是 JPEG、PNG、JPG 或 GIF。',
            'avatar.max' => '图片大小不能超过 2MB。',
        ]);

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

        // 2. 处理新头像
        if ($request->hasFile('avatar')) {
            $avatarFile = $request->file('avatar');
            // 生成唯一文件名，防止文件冲突
            $filename = 'users/' . Str::uuid() . '.' . $avatarFile->getClientOriginalExtension();

            try {
                // 使用 Intervention Image 加载并处理图片
                $img = Image::make($avatarFile->getRealPath());

                // 缩放并裁剪图片到指定尺寸（例如 50x50），保持纵横比
                // upsize() 确保如果原图小于目标尺寸，不会被放大
                $img->fit(50, 50, function ($constraint) {
                    $constraint->upsize();
                });

                // 将处理后的图片内容保存到 public 磁盘
                // encode() 方法可以将图片转换为指定格式，例如 $img->encode('webp', 80)
                Storage::disk('public')->put($filename, $img->encode());

                // 3. 删除旧头像文件
                // 确保旧头像路径存在，且不是默认头像（如果你的系统有默认头像），并且文件确实存在于存储中
                if ($oldAvatarPath && Storage::disk('public')->exists($oldAvatarPath)) {
                    Storage::disk('public')->delete($oldAvatarPath);
                }

                // 4. 更新用户数据库记录
                $user->update([
                    'avatar' => $filename, // 存储相对路径
                ]);

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

            } catch (\Exception $e) {
                // 捕获图片处理或文件存储的异常
                \Log::error('头像更新失败: ' . $e->getMessage());
                return redirect()->back()->with('error', '头像更新失败，请稍后再试。');
            }
        }

        return redirect()->back()->with('error', '未选择头像文件。');
    }
}