在 laravel 中实现用户头像上传需完成数据库迁移添加 avatar 字段、配置 public 磁盘并创建 storage 链接、表单设置 enctype="multipart/form-data"、控制器校验上传文件、缩放裁剪、删除旧头像、保存唯一路径至数据库，最后通过 storage::url() 安全输出图片地址。
在 Laravel 项目中为用户添加头像上传功能，同时支持文件管理器浏览、删除旧头像、自动缩放并确保路径一致可访问，需要打通表单、验证、存储、处理与清理全链路。跳过任一环节都可能导致头像不显示、旧文件残留或 404 报错。
数据库准备：添加 avatar 字段并迁移
打开终端，进入项目根目录，执行迁移命令生成新字段：
php artisan make:migration add_avatar_to_users_table --table=users
编辑刚生成的迁移文件，在 up() 方法中插入 avatar 字段定义：
$table->string('avatar')->nullable();
运行迁移使字段生效：php artisan migrate。这一步必须完成，否则后续更新头像时会抛出 【SQLSTATE[42S22]: Column not found】 异常。
配置 public 磁盘与符号链接
确认 config/filesystems.php 中 'public' 磁盘已启用且 root 指向 storage_path('app/public')，url 配置为 env('APP_URL').'/storage'。
执行命令创建 Web 可访问链接：php artisan storage:link。这一步不可跳过，否则前端无法通过 /storage/xxx.jpg 访问图片。
若提示 The "public/storage" directory already exists.，说明链接已存在，无需重复操作。
表单构建：必须带 enctype 属性
在头像上传页面（如 resources/views/users/edit_avatar.blade.php）中，写入标准表单结构：
<form method="POST" action="%7B%7B%20route('users.update_avatar')%20%7D%7D" enctype="multipart/form-data"></form>
@csrf
<input type="file" name="avatar" accept="image/*">
<button type="submit">更新头像</button>
注意：enctype="multipart/form-data" 是硬性要求，漏掉会导致 $request->file('avatar') 始终返回 null，且 Laravel 不报错，排查极其困难。
控制器逻辑：上传→缩放→存盘→删旧→入库
第一步：在 app/Http/Controllers/UsersController.php 中添加 updateAvatar 方法，并注入 Request 和 Storage 门面；
第二步：调用 $request->validate() 校验文件类型与大小：
'avatar' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048'
第三步：检查当前用户是否已有头像，若有则从 public 盘安全删除旧文件：
if (!empty($user->avatar)) { Storage::disk('public')->delete($user->avatar); }
第四步：使用 Intervention Image 加载上传文件，缩放为 200×200 像素并保持比例裁剪：
$image = Image::make($request->file('avatar'))->fit(200, 200);
第五步：生成唯一文件名（避免覆盖），保存到 public 盘的 avatars/ 子目录：
$filename = 'avatars/' . uniqid() . '.' . $request->file('avatar')->getClientOriginalExtension();
Storage::disk('public')->put($filename, (string) $image->encode());
第六步：将相对路径（不含 /storage 前缀）写入数据库：
$user->avatar = $filename;
$user->save();
视图渲染：安全输出头像 URL
在用户资料页（如 resources/views/users/show.blade.php）中，使用 Laravel 的 Storage::url() 动态拼接完整可访问地址：
<img src="%7B%7B%20Storage::url(%24user->avatar)%20%7D%7D" style="max-width:90%" style="max-width:90%" alt="头像">
该方法会自动补上前缀 /storage，最终生成类似 https://yoursite.com/storage/avatars/5f3a1b2c.png 的合法 URL。直接拼接 asset() 或硬编码路径会导致 404。
