1、简介 laravel 基于 frank de jonge 开发的 php 包 flysystem提供了强大的文件系统抽象。laravel文件系统集成提供了使用驱动处理本地文件系统的简单使用,这些驱动包括amazon s3,以及rackspace 云存储。此外在这些存储选项间切换非常简单,因为对每个系统而言,api 是一样的。
2、配置 文件系统配置文件位于 config/filesystems.php。在该文件中可以配置所有”硬盘“,每个硬盘描述了特定的存储驱动和存储位置。为每种支持的驱动的示例配置包含在该配置文件中,所以,简单编辑该配置来反映你的存储参数和认证信息。
当然,你想配置磁盘多少就配置多少,多个磁盘也可以共用同一个驱动。
本地驱动
使用 local驱动的时候,注意所有文件操作相对于定义在配置文件中的 root目录,默认情况下,该值设置为 storage/app目录,因此,下面的方法将会存储文件到 storage/app/file.txt:
storage::disk('local')->put('file.txt', 'contents');
其它驱动预备知识
在使用amazon s3或rackspace驱动之前,需要通过composer安装相应的包:
amazon s3: league/flysystem-aws-s3-v3 ~1.0 rackspace: league/flysystem-rackspace ~1.0 3、基本使用 3.1 获取硬盘实例 storage门面用于和你配置的所有磁盘进行交互,例如,你可以使用该门面上的put方法来存储头像到默认磁盘,如果你调用 storage门面上的方法却先调用 disk方法,该方法调用自动传递到默认磁盘:
id, file_get_contents($request->file('avatar')->getrealpath()) ); }}
使用多个磁盘时,可以使用 storage门面上的 disk方法访问特定磁盘。当然,可以继续使用方法链执行该磁盘上的方法:
$disk = storage::disk('s3');$contents = storage::disk('local')->get('file.jpg')
3.2 获取文件 get方法用于获取给定文件的内容,该方法将会返回该文件的原生字符串内容:
$contents = storage::get('file.jpg');
exists方法用于判断给定文件是否存在于磁盘上:
$exists = storage::disk('s3')->exists('file.jpg');
文件元信息
size方法以字节方式返回文件大小:
$size = storage::size('file1.jpg');
lastmodified方法以unix时间戳格式返回文件最后一次修改时间:
$time = storage::lastmodified('file1.jpg');
3.3 存储文件 put方法用于存储文件到磁盘。可以传递一个php资源到 put方法,该方法将会使用flysystem底层的流支持。在处理大文件的时候推荐使用文件流:
storage::put('file.jpg', $contents);storage::put('file.jpg', $resource);
copy方法将磁盘中已存在的文件从一个地方拷贝到另一个地方:
storage::copy('old/file1.jpg', 'new/file1.jpg');
move方法将磁盘中已存在的文件从一定地方移到到另一个地方:
storage::move('old/file1.jpg', 'new/file1.jpg');
添加内容到文件开头/结尾
prepend和 append方法允许你轻松插入内容到文件开头/结尾:
storage::prepend('file.log', 'prepended text');storage::append('file.log', 'appended text');
3.4 删除文件 delete方法接收单个文件名或多个文件数组并将其从磁盘移除:
storage::delete('file.jpg');storage::delete(['file1.jpg', 'file2.jpg']);
3.5 目录 获取一个目录下的所有文件
files方法返回给定目录下的所有文件数组,如果你想要获取给定目录下包含子目录的所有文件列表,可以使用 allfiles方法:
$files = storage::files($directory);$files = storage::allfiles($directory);
获取一个目录下的所有子目录
directories方法返回给定目录下所有目录数组,此外,可以使用 alldirectories方法获取嵌套的所有子目录数组:
$directories = storage::directories($directory);// 递归...$directories = storage::alldirectories($directory);
创建目录
makedirectory方法将会创建给定目录,包含子目录(递归):
storage::makedirectory($directory);
删除目录
最后, deletedirectory方法用于移除目录,包括该目录下的所有文件:
storage::deletedirectory($directory);
4、自定义文件系统 laravel 的 flysystem 集成支持自定义驱动,为了设置自定义的文件系统你需要创建一个服务提供者如 dropboxserviceprovider。在该提供者的 boot方法中,你可以使用 storage门面的 extend方法定义自定义驱动:
extend方法的第一个参数是驱动名称,第二个参数是获取 $app和 $config变量的闭包。该解析器闭包必须返回一个 league\flysystem\filesystem实例。$config变量包含了定义在配置文件 config/filesystems.php中为特定磁盘定义的选项。
创建好注册扩展的服务提供者后,就可以使用配置文件 config/filesystem.php中的 dropbox驱动了。