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

簡(jiǎn)介

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)你可以配置所有的「硬盤」。每個(gè)硬盤代表一種保存方式和地點(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ù)量的硬盤配置文件，甚至配置多個(gè)硬盤都使用同一種保存方式。

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

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

基本用法

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

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

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

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

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

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

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

取得文件內(nèi)容

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

配置文件內(nèi)容

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

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

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

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

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)心，它沒有那么復(fù)雜！

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

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

注意： $config 變量已經(jīng)包含了定義在 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()
    {
        //    }}