文件系统 / 云存储


简介

Laravel 有很棒的文件系统抽象层,是基于 Frank de Jonge 的 Flysystem 扩展包。 Laravel 集成的 Flysystem 提供了简单的接口,可以操作本地端空间、 Amazon S3 、 Rackspace Cloud Storage 。更好的是,它可以非常简单的切换不同保存方式,但仍使用相同的 API 操作!

配置文件

文件系统的配置文件放在 config/filesystems.php 。在这个文件内你可以配置所有的“硬盘”。每个硬盘代表一种保存方式和地点。默认的配置文件内已经包含了所有保存方式的例子。所以只要修改保存配置和认证即可!

在使用 S3 或 Rackspace 之前,你必须先用 Composer 安装相对应的扩展包:

  • Amazon S3: league/flysystem-aws-s3-v2 ~1.0
  • Rackspace: league/flysystem-rackspace ~1.0

当然,你可以加入任意数量的硬盘配置文件,甚至配置多个硬盘都使用同一种保存方式。

使用本地端空间时,要注意所有的操作路径都是相对于配置文件里 localroot ,默认的路径是 storage/app 。因此下列的操作将会保存一个文件在 storage/app/file.txt

Storage::disk('local')->put('file.txt', 'Contents');

基本用法

可以用 Storage facade 操作所有写在配置文件里的硬盘。或者是,你也可以将 Illuminate\Contracts\Filesystem\Factory 类型提示写到任何类里,经由 Laravel 的 服务容器 解析。

取得一个特定硬盘

$disk = Storage::disk('s3');

$disk = Storage::disk('local');

确认文件是否存在

$exists = Storage::disk('s3')->exists('file.jpg');

使用默认硬盘调用方法

if (Storage::exists('file.jpg'))
{
    //
}

取得文件内容

$contents = Storage::get('file.jpg');

配置文件内容

Storage::put('file.jpg', $contents);

加入内容到文件开头

Storage::prepend('file.log', 'Prepended Text');

附加内容到文件结尾

Storage::append('file.log', 'Appended Text');

删除文件

Storage::delete('file.jpg');

Storage::delete(['file1.jpg', 'file2.jpg']);

复制文件到新的路径

Storage::copy('old/file1.jpg', 'new/file1.jpg');

移动文件到新的路径

Storage::move('old/file1.jpg', 'new/file1.jpg');

取得文件大小

$size = Storage::size('file1.jpg');

取得最近修改时间 (UNIX)

$time = Storage::lastModified('file1.jpg');

取得目录下所有文件

$files = Storage::files($directory);

// Recursive...
$files = Storage::allFiles($directory);

取得目录下所有子目录

$directories = Storage::directories($directory);

// Recursive...
$directories = Storage::allDirectories($directory);

建立目录

Storage::makeDirectory($directory);

删除目录

Storage::deleteDirectory($directory);

自定义文件系统

Laravel 的文件系统默认已经集成了不少驱动。不过,文件系统并不仅限于这些,还有针对其他存储系统的一些适配器。如果你想使用这些适配器,你可以创建一个自定义的驱动。不用担心,它没有那么复杂!

如果要创建一个自定义的文件系统,你需要创建一个服务提供者,比如 DropboxFilesystemServiceProvider。在提供者的 boot 方法中,你可以注入一个实现了 Illuminate\Contracts\Filesystem\Factory 接口的实例并且调用注入实例的 extend 方法。 或者你也可以使用 Disk facade 的 extend 方法。

extend 方法的第一个参数是驱动的名字,第二个参数是一个闭包,接受 $app$config 变量。这个闭包的返回值必须是 League\Flysystem\Filesystem 的一个实例。

注意: $config 变量已经包含了定义在 config/filesystems.php 中特定硬盘的配置。

Dropbox 示例

<?php namespace App\Providers;

use Storage;
use League\Flysystem\Filesystem;
use Dropbox\Client as DropboxClient;
use League\Flysystem\Dropbox\DropboxAdapter;
use Illuminate\Support\ServiceProvider;

class DropboxFilesystemServiceProvider extends ServiceProvider {

    public function boot()
    {
        Storage::extend('dropbox', function($app, $config)
        {
            $client = new DropboxClient($config['accessToken'], $config['clientIdentifier']);

            return new Filesystem(new DropboxAdapter($client));
        });
    }

    public function register()
    {
        //
    }

}