引言
如果我们的应用程序接收用户提交的许多静态文件，文档，图片等等，需要将其上传到服务器并进行有效地管理。
然而，文件类型繁多，文件用途不同；还有可能我们使用第三方的对象存储服务，需要像访问本地文件一样地读取远端的文件。
如果有一套统一的API，或者操作风格，那样会节省很多不必要的差异化代码。laravel提供的Storage文档存储管理正式因此产生的，本期我们就来说一说。
代码时间
首先在配置文件内声明各个磁盘配置，可以设置驱动，配置目录等差异化信息。在 config/filesystem.php 文件内添加如下配置代码：
代码语言：javascript复制'disks' => [
'local' => [
'driver' => 'local',
'root' => storage_path('app'),
],
'public' => [
'driver' => 'local',
'root' => storage_path('app/public'),
'visibility' => 'public',
],
's3' => [
'driver' => 's3',
'key' => 'your-key',
'secret' => 'your-secret',
'region' => 'your-region',
'bucket' => 'your-bucket',
],
],其中 driver 为 local 时，表示本地的文件系统驱动。
如果要把 storage 目录下的公用目录 public 公开到网络可访问位置，我们为其创建一个软连接：
代码语言：javascript复制php artisan storage:link这样就把目录 public 指向了 storage/app/public 目录。那么位于该目录下的所有文件，可通过web服务器的根目录直接访问。
文件操作
laravel提供的Storage文件操作类，封装了非常方便的文件读写和高级的功能操作。比如读取一个文件的内容：
代码语言：javascript复制Storage::disk('s3')->get('file.jpg');上述代码，读取s3服务上的一个图片文件。
覆盖性写入一个文件，或者创建一个新的不存在的文件，使用 put 方式：
代码语言：javascript复制Storage::disk('local')->put('file.jpg', $contentsOrStream)或者把上传的文件，直接放入到某个指定的目录：
代码语言：javascript复制Storage::putFile('myDir', $file)其中 $file 是一个 IlluminateHttpFile or IlluminateHttpUploadedFile 对象的实例。我们通过表单上传的file字段文件，可以使用
代码语言：javascript复制request()->file('file_field')方便地获取。还有常用的判断文件是否存在：
代码语言：javascript复制Storage::exists('file.jpg')避免了我们写 file_exists 这样还有传入绝对路径，或者相对路径的麻烦，使用对象方法操作，使得代码风格更为统一。
还有常用的一些方法，我们不一一解释了，罗列在下方：
- 文件复制 copy('file.jpg', 'newfile.jpg')
- 文件重命名 move('file.jpg', 'newfile.jpg')
- 文件头部追加内容 prepend('my.log', 'log text')
- 文件尾部追加内容 append('my.log', 'log text')
- 删除文件 delete('file.jpg')
等等等等，读者可以自定查看文档或在源码中研读。
如果我们引入了一个第三方的文件存储服务，且有其一套API操作方式，而laravel系统并未提供该服务的驱动，能否自定义一套呢？完全可以。
框架的文件系统驱动使用了 Flysystem 库用于统一化管理。我们只需要扩展Storage，并将第三方的驱动API实现Storage接口方法即可在程序内无差别地使用了。
在 AppServiceProvider 的 boot 方法内实现该扩展。比如我们引入 dropbox 存储服务：
代码语言：javascript复制Storage::extend('dropbox', function ($app, $config) {
$client = new DropboxClient(
$config['accessToken'], $config['clientIdentifier']
);
return new Filesystem(new DropboxAdapter($client));
});我们使用Dropbox公司提供的 PHP SDK，或者使用composer安装相关包，在扩展方法中注册该驱动引擎即可。
写在最后
本文初步介绍了laravel中是如何使用Storage对象无差别地执行文件操作，用户只需关注文件操作逻辑，而不用在意底层的驱动方式，这样非常便于统一化。最后简介了引入自定义文件驱动的方法。
Happy coding :-)
