使用 Laravel 5.1 的文件系统对文件进行存储、移动和删除操作

Laravel 基于 Flysystem 提供了强大的文件系统对文件进行存储和删除，该文件系统和缓存一样，支持多种驱动，这些驱动包括本地驱动、FTP、Amazon S3以及 Rackspace，在这些驱动之上提供了统一的API方便随时切换驱动而不需要修改任何业务逻辑代码。

既然API方法一致，那么这里作为示例，我们使用本地驱动来演示如何使用文件系统API对文件进行存储和删除。

1、配置

文件系统配置位于config/filesystems.php，默认配置如下：

return [

    'default' => 'local',
    'cloud' => 's3',
    'disks' => [

        'local' => [
            'driver' => 'local',
            'root' => storage_path('app'),
        ],

        'ftp' => [
            'driver' => 'ftp',
            'host' => 'ftp.example.com',
            'username' => 'your-username',
            'password' => 'your-password',
        ],

        's3' => [
            'driver' => 's3',
            'key' => 'your-key',
            'secret' => 'your-secret',
            'region' => 'your-region',
            'bucket' => 'your-bucket',
        ],

        'rackspace' => [
            'driver' => 'rackspace',
            'username' => 'your-username',
            'key' => 'your-key',
            'container' => 'your-container',
            'endpoint' => 'https://identity.api.rackspacecloud.com/v2.0/',
            'region' => 'IAD',
            'url_type' => 'publicURL',
        ],

    ],

];

从配置文件可以看出，Laravel默认的文件系统驱动是local，也就是本地驱动，默认的云存储是Amazon S3。我们可以修改这些默认配置。

所有支持的驱动及驱动详细配置定义在disks配置项中，在local驱动中使用root配置指定文件系统的根路径，即storage/app，这意味着如果使用local驱动，所有文件都会存放在该目录下。如果使用ftp驱动需要指定FTP主机、用户名和登录密码，此外还有一些额外配置，比如端口号、超时时间、加密方式等。同理使用s3或者rackspace也要填写相应的配置项。

由于我们使用local驱动，所以这里我们保持该配置文件不变即可。

2、基本使用

下面我们使用文件系统演示如何上传文件、获取文件、以及删除文件，我们将使用Storage门面提供的方法进行操作。

上传文件/获取文件

这里我们基于 HTTP 请求实例教程#上传文件这篇教程并对其上传方法postFileupload进行修改：

public function postFileupload(Request $request){
    //判断请求中是否包含name=file的上传文件
    if(!$request->hasFile('file')){
        exit('上传文件为空！');
    } 
    $file = $request->file('file');
    //判断文件上传过程中是否出错
    if(!$file->isValid()){
        exit('文件上传出错！');
    }
    $newFileName = md5(time().rand(0,10000)).'.'.$file->getClientOriginalExtension();
    $savePath = 'test/'.$newFileName;
    $bytes = Storage::put(
        $savePath,
        file_get_contents($file->getRealPath())
    );
    if(!Storage::exists($savePath)){
        exit('保存文件失败！');
    }
    header("Content-Type: ".Storage::mimeType($savePath));
    echo Storage::get($savePath);
}

在上传处理逻辑中我们先保存文件到指定位置，然后判断保存后的文件是否存在，如果不存在则表明上传失败，否则显示上传文件内容。

比如我们测试上传图片，访问http://laravel.app:8000/request/fileupload，点击“选择文件”上传一张图片：

点击“提交”，页面显示出刚刚上传的图片：

好吧，插播一条广告：你可以扫上面这张图片二维码加入Laravel学院开设的Laravel学习交流群。

还可以上传文本文件：

点击“提交“，页面显示出文本文件内容：

test local storage

针对文本文件，你可以使用Storage门面提供的prepend/append方法在文本文件头部/尾部追加内容：

$filePath = 'test/ef5e49967bf4a5e2f386a3726f9213d2.txt';
Storage::prepend($filePath,'###');
Storage::append($filePath,'###');
echo Storage::get($filePath);

执行上述代码后，文本文档内容变为：

### test local storage ###

移动/删除文件

如果我们想要将某个文件复制/移动到别的目录下，可以使用Storage门面提供的copy/move方法：

Storage::copy('test/xxx.txt','files/xxx.txt ');
Storage::move('test/xxx,jpg','images/xxx.jpg');

如果想要删除某个文件，可以使用delete方法：

$filePath = 'test/ef5e49967bf4a5e2f386a3726f9213d2.txt';
if(Storage::delete($filePath)){
    exit('删除成功！');
}else{
    exit('删除失败！');
}

获取指定目录下所有文件/子目录

如果要获取某个目录下的所有文件，可以使用Storage门面提供的files或allFiles方法，两者的区别在于allFiles会返回所有嵌套子目录下的文件：

$filePath = 'test';
$files = Storage::Files($filePath);
dd($files);

如果要获取子目录，可以使用directories或者allDirectories方法，同理，两者的区别在于后者可以返回嵌套的子目录：

$dirPath = 'test';
$directories = Storage::directories($dirPath);
dd($directories);

由于test目录下没有子目录，所以打印结果为一个空数组。下面我们来看如何创建目录。

创建目录/删除目录

创建目录可以使用Storage门面提供的makeDirectory方法：

$dirPath = 'test/abc';
Storage::makeDirectory($dirPath);
$directories = Storage::directories('test');
dd($directories);

这样就可以打印出子目录数组，如果要删除这个子目录，可以使用deleteDirectory方法，该方法会递归删除子目录下所有文件及文件夹：

$dirPath = 'test/abc';
Storage::deleteDirectory($dirPath);
$directories = Storage::directories('test');
dd($directories);

这样打印出来的结果又为空了，说明子目录已经被删除。

想要了解更多Storage提供的方法，可查看该门面对应的底层Illuminate\Filesystem\Filesystem类。