Laravel 有很棒的文件系統(tǒng)抽象層，是基于 Frank de Jonge 的 Flysystem 擴(kuò)展包。 Laravel 集成的 Flysystem 提供了簡(jiǎn)單的接口，可以操作本地端空間、 Amazon S3 、 Rackspace Cloud Storage 。更好的是，它可以非常簡(jiǎn)單的切換不同保存方式，但仍使用相同的 API 操作！

配置文件

文件系統(tǒng)的配置文件放在 config/filesystems.php 。在這個(gè)文件內(nèi)你可以配置所有的「硬盤(pán)」。每個(gè)硬盤(pán)代表一種保存方式和地點(diǎn)。默認(rèn)的配置文件內(nèi)已經(jīng)包含了所有保存方式的例子。所以只要修改保存配置和認(rèn)證即可！

在使用 S3 或 Rackspace 之前，你必須先用 Composer 安裝相對(duì)應(yīng)的擴(kuò)展包：

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

當(dāng)然，你可以加入任意數(shù)量的硬盤(pán)配置文件，甚至配置多個(gè)硬盤(pán)都使用同一種保存方式。

使用本地端空間時(shí)，要注意所有的操作路徑都是相對(duì)于配置文件里 local 的 root ，默認(rèn)的路徑是 storage/app 。因此下列的操作將會(huì)保存一個(gè)文件在 storage/app/file.txt ：

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

基本用法

可以用 Storage facade 操作所有寫(xiě)在配置文件里的硬盤(pán)?；蛘呤?，你也可以將 IlluminateContractsFilesystemFactory 類型提示寫(xiě)到任何類里，經(jīng)由 Laravel 的服務(wù)容器解析。

取得一個(gè)特定硬盤(pán)

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

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

確認(rèn)文件是否存在

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

使用默認(rèn)硬盤(pán)調(diào)用方法

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

取得文件內(nèi)容

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

配置文件內(nèi)容

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

附加內(nèi)容到文件結(jié)尾

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

加入內(nèi)容到文件開(kāi)頭

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

刪除文件

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

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

復(fù)制文件到新的路徑

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

移動(dòng)文件到新的路徑

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

取得文件大小

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

取得最近修改時(shí)間 (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);

自定義文件系統(tǒng)

Laravel 的文件系統(tǒng)默認(rèn)已經(jīng)集成了不少驅(qū)動(dòng)。不過(guò)，文件系統(tǒng)并不僅限于這些，還有針對(duì)其他存儲(chǔ)系統(tǒng)的一些適配器。如果你想使用這些適配器，你可以創(chuàng)建一個(gè)自定義的驅(qū)動(dòng)。不用擔(dān)心，它沒(méi)有那么復(fù)雜！

如果要?jiǎng)?chuàng)建一個(gè)自定義的文件系統(tǒng)，你需要?jiǎng)?chuàng)建一個(gè)服務(wù)提供者，比如 DropboxFilesystemServiceProvider。在提供者的 boot 方法中，你可以注入一個(gè)實(shí)現(xiàn)了 IlluminateContractsFilesystemFactory 接口的實(shí)例并且調(diào)用注入實(shí)例的 extend 方法。或者你也可以使用 Disk facade 的 extend 方法。

extend 方法的第一個(gè)參數(shù)是驅(qū)動(dòng)的名字，第二個(gè)參數(shù)是一個(gè)閉包，接受 $app 和 $config 變量。這個(gè)閉包的返回值必須是 LeagueFlysystemFilesystem 的一個(gè)實(shí)例。

注意： $config 變量已經(jīng)包含了定義在 config/filesystems.php 中特定硬盤(pán)的配置。

Dropbox 示例

<?php namespace App\Providers;

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

class DropboxFilesystemServiceProvider {

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

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

}

文件系統(tǒng) / 云存儲(chǔ)

簡(jiǎn)介