### 上传头像
在 Laravel 中，我们可直接通过 [请求对象（Request）](https://learnku.com/docs/laravel/5.8/requests#retrieving-uploaded-files) 来获取用户上传的文件，如以下两种方法：
```php
// 第一种方法
$file = $request->file('avatar');
// 第二种方法，可读性更高
$file = $request->avatar;
```
为表单添加 `enctype="multipart/form-data"` 声明了。请记住，在图片或者文件上传时，为表单添加此句声明是必须的。
Laravel 的『用户上传文件对象』底层使用了 Symfony 框架的 [UploadedFile](http://api.symfony.com/3.0/Symfony/Component/HttpFoundation/File/UploadedFile.html) 对象进行渲染，为我们提供了便捷的文件读取和管理接口，我们将在后面使用这些方法。
### 存储用户上传图片
本项目中，我们不止上传头像需要用到『图片上传功能』，在后面发布帖子功能中，我们也将会允许用户上传图片，所以此处我们需要预先设计一下图片上传相关的逻辑，我们可以将『图片上传』核心操作做成一个工具类（注意顶部 `use Illuminate\Support\Str;`）：
*app/Handlers/ImageUploadHandler.php*
```php
<?php
namespace App\Handlers;
use Illuminate\Support\Str;
class ImageUploadHandler
{
// 只允许以下后缀名的图片文件上传
protected $allowed_ext = ["png", "jpg", "gif", 'jpeg'];
public function save($file, $folder, $file_prefix)
{
// 构建存储的文件夹规则，值如：uploads/images/avatars/201709/21/
// 文件夹切割能让查找效率更高。
$folder_name = "uploads/images/$folder/" . date("Ym/d", time());
// 文件具体存储的物理路径，`public_path()` 获取的是 `public` 文件夹的物理路径。
// 值如：/home/vagrant/Code/larabbs/public/uploads/images/avatars/201709/21/
$upload_path = public_path() . '/' . $folder_name;
// 获取文件的后缀名，因图片从剪贴板里黏贴时后缀名为空，所以此处确保后缀一直存在
$extension = strtolower($file->getClientOriginalExtension()) ?: 'png';
// 拼接文件名，加前缀是为了增加辨析度，前缀可以是相关数据模型的 ID
// 值如：1_1493521050_7BVc9v9ujP.png
$filename = $file_prefix . '_' . time() . '_' . Str::random(10) . '.' . $extension;
// 如果上传的不是图片将终止操作
if ( ! in_array($extension, $this->allowed_ext)) {
return false;
}
// 将图片移动到我们的目标存储路径中
$file->move($upload_path, $filename);
return [
'path' => config('app.url') . "/$folder_name/$filename"
];
}
}
```
我们将使用 `app/Handlers` 文件夹来存放本项目的工具类，『工具类（utility class）』是指一些跟业务逻辑相关性不强的类，`Handlers` 意为 **处理器** ，ImageUploadHandler 意为图片上传处理器，简单易懂。
```
`public_path()` 获取的是 `public` 文件夹的物理路径。
```
### 裁剪图片
我们个人空间里显示区域最大也就 208px，即使要兼容 [视网膜屏幕（Retina Screen）](https://baike.baidu.com/item/视网膜屏幕) 的话，最多也就需要 208px * 2 = 416px 。图片太大会拖慢页面的加载速度，所以接下来我们将对此进行优化。
我们将使用备受欢迎的 [Intervention/image](https://github.com/Intervention/image) 扩展包来处理图片裁切的逻辑，接下来我们需要先安装此扩展包；
#### 1.安装扩展包
1. composer安装
```
$ composer require intervention/image
```
2. 配置信息
执行以下命令获取配置信息：
```
$ php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravel5"
```
#### 2.开始裁剪
我们将裁切的逻辑写在 `ImageUploadHandler` 中，请将以下代码替换：
*app/Handlers/ImageUploadHandler.php*
```php
<?php
namespace App\Handlers;
use Image;
class ImageUploadHandler
{
protected $allowed_ext = ["png", "jpg", "gif", 'jpeg'];
public function save($file, $folder, $file_prefix, $max_width = false)
{
// 构建存储的文件夹规则，值如：uploads/images/avatars/201709/21/
// 文件夹切割能让查找效率更高。
$folder_name = "uploads/images/$folder/" . date("Ym/d", time());
// 文件具体存储的物理路径，`public_path()` 获取的是 `public` 文件夹的物理路径。
// 值如：/home/vagrant/Code/larabbs/public/uploads/images/avatars/201709/21/
$upload_path = public_path() . '/' . $folder_name;
// 获取文件的后缀名，因图片从剪贴板里黏贴时后缀名为空，所以此处确保后缀一直存在
$extension = strtolower($file->getClientOriginalExtension()) ?: 'png';
// 拼接文件名，加前缀是为了增加辨析度，前缀可以是相关数据模型的 ID
// 值如：1_1493521050_7BVc9v9ujP.png
$filename = $file_prefix . '_' . time() . '_' . str_random(10) . '.' . $extension;
// 如果上传的不是图片将终止操作
if ( ! in_array($extension, $this->allowed_ext)) {
return false;
}
// 将图片移动到我们的目标存储路径中
$file->move($upload_path, $filename);
// 如果限制了图片宽度，就进行裁剪
if ($max_width && $extension != 'gif') {
// 此类中封装的函数，用于裁剪图片
$this->reduceSize($upload_path . '/' . $filename, $max_width);
}
return [
'path' => config('app.url') . "/$folder_name/$filename"
];
}
public function reduceSize($file_path, $max_width)
{
// 先实例化，传参是文件的磁盘物理路径
$image = Image::make($file_path);
// 进行大小调整的操作
$image->resize($max_width, null, function ($constraint) {
// 设定宽度是 $max_width，高度等比例双方缩放
$constraint->aspectRatio();
// 防止裁图时图片尺寸变大
$constraint->upsize();
});
// 对图片修改后进行保存
$image->save();
}
}
```
以上的 `save()` 方法中，我们新增了 `$max_width` 参数，用来指定最大图片宽度，我们修改 UsersController 的 `update()` 方法中的调用，修改为：
```php
$result = $uploader->save($request->avatar, 'avatars', $user->id, 416);
```
