71. 请求 文件资源

获取上传文件

你可以使用 Illuminate\Http\Request 实例中的 file 方法获取上传的文件。file 方法返回的对象是 Symfony\Component\HttpFoundation\File\UploadedFile 类的实例，该类继承了 PHP 的 SplFileInfo 类，并提供了许多和文件交互的方法：

$file = $request->file('photo');

$file = $request->photo;

你可以使用请求的 hasFile 方法确认上传的文件是否存在：

if ($request->hasFile('photo')) {
    //
}

确认上传的文件是否有效

除了检查上传的文件是否存在外，你也可以通过 isValid 方法验证上传的文件是否有效：

if ($request->file('photo')->isValid()) {
    //
}

文件路径 & 扩展

UploadedFile 这个类也包含了访问文件完整路径和扩展的方法。extension 方法会尝试根据文件内容猜测文件的扩展名。猜测结果可能不同于客户端原始的扩展名：

$path = $request->photo->path();

$extension = $request->photo->extension();

其它上传文件的方法

UploadedFile
的实例还有许多可用的方法，可以到该对象的 API 文档 了解这些方法的详细信息。

储存上传文件

在设置好 文件系统 的配置信息后，你可以使用 UploadedFile 的 store 方法把上传文件储存到本地磁盘。

store 方法允许存储文件到相对于文件系统根目录配置的路径。这个路径不能包含文件名，名称将使用 MD5 散列文件内容自动生成。

store 方法还接受一个可选的第二个参数，用于文件存储到磁盘的名称。这个方法会返回文件相对于磁盘根目录的路径：

$path = $request->photo->store('images');

$path = $request->photo->store('images', 's3');

如果你不想自动生成文件名，那么可以使用 storeAs 方法去设置路径，文件名和磁盘名作为方法参数：

$path = $request->photo->storeAs('images', 'filename.jpg');

$path = $request->photo->storeAs('images', 'filename.jpg', 's3');