Laravel用户头像管理：实现图片缩放、存储与旧文件安全删除的最佳实践

use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\Auth;

// ...

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

// 检查旧头像是否存在且有效，避免尝试删除空路径
if ($oldAvatarPath) {
    // 假设头像存储在 'users/' 目录下，且使用 'public' 盘符
    // 注意：Auth::user()->avatar 应该只存储相对路径，例如 'users/avatar_filename.jpg'
    // 如果数据库中只存储了文件名，则需要拼接 'users/'
    // 示例：如果数据库存储 'avatar_filename.jpg'，则需要拼接 'users/'
    // $fullOldAvatarPath = 'users/' . $oldAvatarPath;

    // 推荐：数据库中直接存储完整的相对路径，例如 'users/unique_avatar_name.jpg'
    Storage::disk('public')->delete($oldAvatarPath);
}

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Str; // 用于生成唯一文件名
use Image; // Intervention/Image 门面

// ...

public function avatarUpdate(Request $request)
{
    // 1. 验证请求
    $request->validate([
        'avatar' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048', // 2MB
    ]);

    // 获取当前用户的旧头像路径并尝试删除
    $oldAvatarPath = Auth::user()->avatar;
    if ($oldAvatarPath) {
        Storage::disk('public')->delete($oldAvatarPath);
    }

    // 检查是否有文件上传
    if ($request->hasFile('avatar')) {
        $avatarFile = $request->file('avatar');

        // 2. 生成唯一文件名
        // 避免文件名冲突，并保留原始文件扩展名
        $filename = Str::random(40) . '.' . $avatarFile->getClientOriginalExtension();
        $directory = 'users'; // 存储头像的子目录

        // 3. 使用 Intervention/Image 缩放图片
        // 从上传的文件创建 Image 实例
        $image = Image::make($avatarFile);

        // 调整图片大小为 50x50 像素
        // fit() 方法会裁剪并调整图片大小，保持纵横比
        $image->fit(50, 50);

        // 4. 保存缩放后的图片到存储盘符
        // save() 方法将图片内容保存到指定路径
        // 注意：这里不再使用 $request->avatar->storeAs()，因为我们要保存的是处理过的图片
        $fullPath = $directory . '/' . $filename;
        Storage::disk('public')->put($fullPath, (string) $image->encode());

        // 5. 更新数据库中的头像路径
        Auth::user()->update([
            'avatar' => $fullPath // 存储相对路径
        ]);
    }

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

// 在上述代码中已包含
Auth::user()->update([
    'avatar' => $fullPath // 存储相对路径，例如 'users/unique_avatar_name.jpg'
]);

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Image; // 引入 Intervention/Image 门面

class ProfileController extends Controller
{
    /**
     * 更新用户头像。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    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();

        // 2. 删除旧头像
        // 确保数据库中存储的是完整的相对路径，例如 'users/old_avatar.jpg'
        if ($user->avatar && Storage::disk('public')->exists($user->avatar)) {
            Storage::disk('public')->delete($user->avatar);
        }

        // 3. 处理新头像上传与缩放
        if ($request->hasFile('avatar')) {
            $avatarFile = $request->file('avatar');

            // 生成唯一文件名，避免冲突
            $filename = Str::random(40) . '.' . $avatarFile->getClientOriginalExtension();
            $directory = 'users'; // 存储头像的子目录

            // 使用 Intervention/Image 处理图片
            $image = Image::make($avatarFile);
            $image->fit(50, 50); // 裁剪并缩放图片到 50x50 像素

            // 构造完整存储路径
            $fullPath = $directory . '/' . $filename;

            // 将处理后的图片保存到 public 盘符
            // encode() 方法将图片转换为指定格式的字符串，默认是JPEG
            Storage::disk('public')->put($fullPath, (string) $image->encode());

            // 4. 更新数据库中的头像路径
            $user->update([
                'avatar' => $fullPath
            ]);
        }

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