Laravel 7.x ファイルストレージ

イントロダクションIntroduction

LaravelはFrank de Jongeさんが作成した拝みたいほど素晴らしい、抽象ファイルシステムであるFlysystem PHPパッケージを提供しています。Laravel Flysystem統合は、ローカルのファイルシステムとAmazon S3をシンプルに操作できるドライバを提供しています。さらに素晴らしいことにそれぞれのシステムに対し同じAPIを使用しているため、ストレージをとても簡単に変更できるのです。Laravel provides a powerful filesystem abstraction thanks to the wonderful Flysystem[https://github.com/thephpleague/flysystem] PHP package by Frank de Jonge. The Laravel Flysystem integration provides simple to use drivers for working with local filesystems and Amazon S3. Even better, it's amazingly simple to switch between these storage options as the API remains the same for each system.

設定Configuration

ファイルシステムの設定ファイルは、config/filesystems.phpです。このファイルの中に全「ディスク」の設定があります。それぞれのディスクは特定のストレージドライバと保存場所を表します。設定ファイルにはサポート済みのドライバそれぞれの設定例を用意しています。ですからストレージの設定と認証情報を反映するように、設定オプションを簡単に修正できます。The filesystem configuration file is located at config/filesystems.php. Within this file you may configure all of your "disks". Each disk represents a particular storage driver and storage location. Example configurations for each supported driver are included in the configuration file. So, modify the configuration to reflect your storage preferences and credentials.

好きなだけディスクを設定できますし、同じドライバに対し複数のディスクを持つことも可能です。You may configure as many disks as you like, and may even have multiple disks that use the same driver.

パブリックディスクThe Public Disk

publicディスクは一般公開へのアクセスを許すファイルを意味しています。デフォルトのpublicディスクは、localドライバを使用しており、storage/app/public下に存在しているファイルです。Webからのアクセスを許すには、public/storageからstorage/app/publicへシンボリックリンクを張る必要があります。この手法により、公開ファイルを一つのディレクトリへ留め、Envoyerのようなリリース時のダウンタイムが起きない開発システムを使っている場合、各リリース間でファイルを簡単に共有できます。The public disk is intended for files that are going to be publicly accessible. By default, the public disk uses the local driver and stores these files in storage/app/public. To make them accessible from the web, you should create a symbolic link from public/storage to storage/app/public. This convention will keep your publicly accessible files in one directory that can be easily shared across deployments when using zero down-time deployment systems like Envoyer[https://envoyer.io].

シンボリックリンクを張るには、storage:link Artisanコマンドを使用します。To create the symbolic link, you may use the storage:link Artisan command:

php artisan storage:link

ファイルを保存し、シンボリックリンクを張ったら、assetヘルパを使いファイルへのURLを生成できます。Once a file has been stored and the symbolic link has been created, you can create a URL to the files using the asset helper:

echo asset('storage/file.txt');

filesystems設定ファイルで追加のシンボリックリンクを設定可能です。各設定リンクはstorage:linkコマンドを実行し、生成可能です。You may configure additional symbolic links in your filesystems configuration file. Each of the configured links will be created when you run the storage:link command:

'links' => [
    public_path('storage') => storage_path('app/public'),
    public_path('images') => storage_path('app/images'),
],

ローカルディスクThe Local Driver

localドライバを使う場合、filesystems設定ファイルで指定したrootディレクトリからの相対位置で全ファイル操作が行われることに注意してください。デフォルトでこの値はstorage/appディレクトリに設定されています。そのため次のメソッドでファイルはstorage/app/file.txtとして保存されます。When using the local driver, all file operations are relative to the root directory defined in your filesystems configuration file. By default, this value is set to the storage/app directory. Therefore, the following method would store a file in storage/app/file.txt:

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

パーミッションPermissions

public下のパーミッションは、ディレクトリへ0755、ファイルへ0664を設定します。パーミッションはfilesystems設定ファイルで変更可能です。The public visibility[#file-visibility] translates to 0755 for directories and 0644 for files. You can modify the permissions mappings in your filesystems configuration file:

'local' => [
    'driver' => 'local',
    'root' => storage_path('app'),
    'permissions' => [
        'file' => [
            'public' => 0664,
            'private' => 0600,
        ],
        'dir' => [
            'public' => 0775,
            'private' => 0700,
        ],
    ],
],

ドライバ要件Driver Prerequisites

ComposerパッケージComposer Packages

SFTPかS3ドライバを使う前に、Composerで適切なパッケージをインストールしておく必要があります。Before using the SFTP or S3 drivers, you will need to install the appropriate package via Composer:

• SFTP: league/flysystem-sftp ~1.0SFTP: league/flysystem-sftp ~1.0
• Amazon S3: league/flysystem-aws-s3-v3 ~1.0Amazon S3: league/flysystem-aws-s3-v3 ~1.0

パフォーマンスを上げるため、絶対に必要なのはキャッシュアダプタです。そのためには、追加のパッケージが必要です。An absolute must for performance is to use a cached adapter. You will need an additional package for this:

• CachedAdapter: league/flysystem-cached-adapter ~1.0CachedAdapter: league/flysystem-cached-adapter ~1.0

S3ドライバ設定S3 Driver Configuration

S3ドライバの設定情報は、config/filesystems.php設定ファイルにあります。このファイルはS3ドライバの設定配列のサンプルを含んでいます。この配列を自由に、自分のS3設定と認証情報に合わせて、変更してください。使いやすいように、環境変数はAWSで使用されている命名規約に合わせてあります。The S3 driver configuration information is located in your config/filesystems.php configuration file. This file contains an example configuration array for an S3 driver. You are free to modify this array with your own S3 configuration and credentials. For convenience, these environment variables match the naming convention used by the AWS CLI.

FTPドライバ設定FTP Driver Configuration

Laravelのファイルシステム統合はFTPでも動作します。しかし、デフォルトでは、フレームワークのfilesystems.php設定ファイルに、サンプルの設定を含めていません。FTPファイルシステムを設定する必要がある場合は、以下の設定例を利用してください。Laravel's Flysystem integrations works great with FTP; however, a sample configuration is not included with the framework's default filesystems.php configuration file. If you need to configure a FTP filesystem, you may use the example configuration below:

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

    // FTP設定のオプション
    // 'port' => 21,
    // 'root' => '',
    // 'passive' => true,
    // 'ssl' => true,
    // 'timeout' => 30,
],

SFTPドライバ設定SFTP Driver Configuration

Laravelのファイルシステム統合はSFTPできちんと動作します。しかし、デフォルトでは、フレームワークのfilesystems.php設定ファイルに、サンプルの設定を含めていません。SFTPファイルシステムを設定する必要がある場合は、以下の設定例を利用してください。Laravel's Flysystem integrations works great with SFTP; however, a sample configuration is not included with the framework's default filesystems.php configuration file. If you need to configure a SFTP filesystem, you may use the example configuration below:

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

    // SSH keyベースの認証の設定
    // 'privateKey' => '/path/to/privateKey',
    // 'password' => 'encryption-password',

    // FTP設定のオプション
    // 'port' => 22,
    // 'root' => '',
    // 'timeout' => 30,
],

キャッシュCaching

特定のディスクでキャッシュを有効にするには、ディスクの設定オプションに、cacheディレクティブを追加してください。cacheオプションは、disk名、expire期間を秒数、キャッシュのprefixを含むオプションの配列です。To enable caching for a given disk, you may add a cache directive to the disk's configuration options. The cache option should be an array of caching options containing the disk name, the expire time in seconds, and the cache prefix:

's3' => [
    'driver' => 's3',

    // 他のディスクの設定…

    'cache' => [
        'store' => 'memcached',
        'expire' => 600,
        'prefix' => 'cache-prefix',
    ],
],

ディスクインスタンス取得Obtaining Disk Instances

Storageファサードを使い設定済みのディスクへの操作ができます。たとえばこのファサードのputメソッドを使用し、デフォルトディスクにアバターを保存できます。Storageファサードのメソッド呼び出しで最初にdiskメソッドを呼び出さない場合、そのメソッドの呼び出しは自動的にデフォルトディスクに対し実行されます。The Storage facade may be used to interact with any of your configured disks. For example, you may use the put method on the facade to store an avatar on the default disk. If you call methods on the Storage facade without first calling the disk method, the method call will automatically be passed to the default disk:

use Illuminate\Support\Facades\Storage;

Storage::put('avatars/1', $fileContents);

複数ディスクを使用する場合、Storageファサードのdiskメソッドを使用し特定のディスクへアクセスできます。If your application interacts with multiple disks, you may use the disk method on the Storage facade to work with files on a particular disk:

Storage::disk('s3')->put('avatars/1', $fileContents);

ファイル取得Retrieving Files

getメソッドは指定したファイルの内容を取得するために使用します。ファイル内容がそのまま、メソッドより返されます。ファイルパスはすべて、ディスクに設定した「ルート(root)」からの相対位置で指定することを思い出してください。The get method may be used to retrieve the contents of a file. The raw string contents of the file will be returned by the method. Remember, all file paths should be specified relative to the "root" location configured for the disk:

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

existsメソッドは指定したディスクにファイルが存在しているかを判定するために使用します。The exists method may be used to determine if a file exists on the disk:

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

missingメソッドは、そのディスクにファイルが存在しないことを判定するために使用します。The missing method may be used to determine if a file is missing from the disk:

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

ファイルのダウンロードDownloading Files

downloadメソッドは、指定したパスへファイルをダウンロードするように、ユーザーのブラウザへ強制するレスポンスを生成するために使用します。downloadメソッドはファイル名を第２引数として受け取り、ダウンロード先のファイル名を指定します。最後に第３引数として、HTTPヘッダの配列を渡せます。The download method may be used to generate a response that forces the user's browser to download the file at the given path. The download method accepts a file name as the second argument to the method, which will determine the file name that is seen by the user downloading the file. Finally, you may pass an array of HTTP headers as the third argument to the method:

return Storage::download('file.jpg');

return Storage::download('file.jpg', $name, $headers);

ファイルURLFile URLs

指定したファイルのURLを取得するには、urlメソッドを使います。localドライバを使用している場合、通常このメソッドは指定したパスの先頭に/storageを付け、そのファイルへの相対パスを返します。s3ドライバを使用している場合、完全なリモートURLを返します。You may use the url method to get the URL for the given file. If you are using the local driver, this will typically just prepend /storage to the given path and return a relative URL to the file. If you are using the s3 driver, the fully qualified remote URL will be returned:

use Illuminate\Support\Facades\Storage;

$url = Storage::url('file.jpg');

Note: note localドライバを使用する場合、一般公開するファイルはすべて、storage/app/publicディレクトリへ設置する必要があることを忘れないでください。さらに、public/storageからstorage/app/publicディレクトリへシンボリックリンクを張る必要もあります。{note} Remember, if you are using the local driver, all files that should be publicly accessible should be placed in the storage/app/public directory. Furthermore, you should create a symbolic link[#the-public-disk] at public/storage which points to the storage/app/public directory.

一時的なURLTemporary URLs

s3ドライバを使用して保存したファイルに対し、指定ファイルの一時的なURLを作成する場合は、temporaryUrlメソッドを使用します。このメソッドはパスとURLの有効期限を指定する、DateTimeインスタンスを引数に取ります。For files stored using the s3 you may create a temporary URL to a given file using the temporaryUrl method. This method accepts a path and a DateTime instance specifying when the URL should expire:

$url = Storage::temporaryUrl(
    'file.jpg', now()->addMinutes(5)
);

追加のS3リクエストパラメータを指定する必要がある場合は、temporaryUrlメソッドの第３引数へリクエストパラメータの配列を渡してください。If you need to specify additional S3 request parameters[https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html#RESTObjectGET-requests], you may pass the array of request parameters as the third argument to the temporaryUrl method:

$url = Storage::temporaryUrl(
    'file.jpg',
    now()->addMinutes(5),
    ['ResponseContentType' => 'application/octet-stream']
);

URLホストカスタマイズURL Host Customization

Storageファサードを使用し生成したファイルURLに対するホストを事前定義したい場合は、ディスク設定配列へurlオプションを追加してください。If you would like to pre-define the host for file URLs generated using the Storage facade, you may add a url option to the disk's configuration array:

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],

ファイルメタ情報File Metadata

ファイルの読み書きに加え、Laravelはファイル自体に関する情報も提供します。たとえば、sizeメソッドはファイルサイズをバイトで取得するために、使用します。In addition to reading and writing files, Laravel can also provide information about the files themselves. For example, the size method may be used to get the size of the file in bytes:

use Illuminate\Support\Facades\Storage;

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

lastModifiedメソッドは最後にファイルが更新された時のUnixタイムスタンプを返します。The lastModified method returns the UNIX timestamp of the last time the file was modified:

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

ファイル保存Storing Files

putメソッドはファイル内容をディスクへ保存するために使用します。putメソッドにはPHPのresourceも渡すことができ、Flysystemの裏で動いているストリームサポートを使用します。すべてのファイルパスは、ディスクの"root"として設定した場所からの相対位置で指定する必要があることを忘ないでください。The put method may be used to store raw file contents on a disk. You may also pass a PHP resource to the put method, which will use Flysystem's underlying stream support. Remember, all file paths should be specified relative to the "root" location configured for the disk:

use Illuminate\Support\Facades\Storage;

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

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

自動ストリーミングAutomatic Streaming

指定したファイル位置のファイルのストリーミングを自動的にLaravelに管理させたい場合は、putFileかputFileAsメソッドを使います。このメソッドは、Illuminate\Http\FileかIlluminate\Http\UploadedFileのインスタンスを引数に取り、希望する場所へファイルを自動的にストリームします。If you would like Laravel to automatically manage streaming a given file to your storage location, you may use the putFile or putFileAs method. This method accepts either a Illuminate\Http\File or Illuminate\Http\UploadedFile instance and will automatically stream the file to your desired location:

use Illuminate\Http\File;
use Illuminate\Support\Facades\Storage;

// 自動的に一意のIDがファイル名として指定される
Storage::putFile('photos', new File('/path/to/photo'));

// ファイル名を指定する
Storage::putFileAs('photos', new File('/path/to/photo'), 'photo.jpg');

putFileメソッドにはいくつか重要な注意点があります。ファイル名ではなく、ディレクトリ名を指定することに注意してください。putFileメソッドは一意のIDを保存ファイル名として生成します。ファイルの拡張子は、MIMEタイプの検査により決まります。putFileメソッドからファイルへのパスが返されますので、生成されたファイル名も含めたパスをデータベースへ保存できます。There are a few important things to note about the putFile method. Note that we only specified a directory name, not a file name. By default, the putFile method will generate a unique ID to serve as the file name. The file's extension will be determined by examining the file's MIME type. The path to the file will be returned by the putFile method so you can store the path, including the generated file name, in your database.

putFileとputFileAsメソッドはさらに、保存ファイルの「視認性」を指定する引数も受け付けます。これはとくにS3などのクラウドディスクにファイルを保存し、一般公開の視認性を設定したい場合に便利です。The putFile and putFileAs methods also accept an argument to specify the "visibility" of the stored file. This is particularly useful if you are storing the file on a cloud disk such as S3 and would like the file to be publicly accessible:

Storage::putFile('photos', new File('/path/to/photo'), 'public');

ファイルの先頭／末尾への追加Prepending & Appending To Files

prependとappendメソッドで、ファイルの初めと終わりに内容を追加できます。The prepend and append methods allow you to write to the beginning or end of a file:

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

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

ファイルコピーと移動Copying & Moving Files

copyメソッドは、存在するファイルをディスク上の新しい場所へコピーするために使用します。一方のmoveメソッドはリネームや存在するファイルを新しい場所へ移動するために使用します。The copy method may be used to copy an existing file to a new location on the disk, while the move method may be used to rename or move an existing file to a new location:

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

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

ファイルアップロードFile Uploads

Webアプリケーションで、ファイルを保存する一般的なケースは、ユーザーがプロファイル画像や写真、ドキュメントをアップロードする場合でしょう。アップロードファイルインスタンスにstoreメソッドを使えば、アップロードファイルの保存はLaravelで簡単に行なえます。アップロードファイルを保存したいパスを指定し、storeメソッドを呼び出してください。In web applications, one of the most common use-cases for storing files is storing user uploaded files such as profile pictures, photos, and documents. Laravel makes it very easy to store uploaded files using the store method on an uploaded file instance. Call the store method with the path at which you wish to store the uploaded file:

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;

class UserAvatarController extends Controller
{
    /**
     * ユーザーのアバターの更新
     *
     * @param  Request  $request
     * @return Response
     */
    public function update(Request $request)
    {
        $path = $request->file('avatar')->store('avatars');

        return $path;
    }
}

この例には重要な点が含まれています。ファイル名ではなく、ディレクトリ名を指定している点に注目です。デフォルトでstoreメソッドは、一意のIDをファイル名として生成します。ファイルの拡張子は、MIMEタイプの検査により決まります。storeメソッドからファイルパスが返されますので、生成されたファイル名を含めた、そのファイルパスをデータベースに保存できます。There are a few important things to note about this example. Note that we only specified a directory name, not a file name. By default, the store method will generate a unique ID to serve as the file name. The file's extension will be determined by examining the file's MIME type. The path to the file will be returned by the store method so you can store the path, including the generated file name, in your database.

上の例と同じ操作を行うため、StorageファサードのputFileメソッドを呼び出すこともできます。You may also call the putFile method on the Storage facade to perform the same file manipulation as the example above:

$path = Storage::putFile('avatars', $request->file('avatar'));

ファイル名の指定Specifying A File Name

保存ファイルが自動的に命名されたくなければ、ファイルパスとファイル名、（任意で）ディスクを引数に持つstoreAsメソッドを使ってください。If you would not like a file name to be automatically assigned to your stored file, you may use the storeAs method, which receives the path, the file name, and the (optional) disk as its arguments:

$path = $request->file('avatar')->storeAs(
    'avatars', $request->user()->id
);

上記の例と同じファイル操作を行う、StorageファサードのputFileAsメソッドも使用できます。You may also use the putFileAs method on the Storage facade, which will perform the same file manipulation as the example above:

$path = Storage::putFileAs(
    'avatars', $request->file('avatar'), $request->user()->id
);

Note: note 印刷できない、または無効なユニコードは自動的にファイルパスから削除されます。そのため、Laravelのファイルストレージメソッドに渡す前に、ファイルパスをサニタライズしましょう。ファイルパスのノーマライズは、League\Flysystem\Util::normalizePathメソッドを使います。{note} Unprintable and invalid unicode characters will automatically be removed from file paths. Therefore, you may wish to sanitize your file paths before passing them to Laravel's file storage methods. File paths are normalized using the League\Flysystem\Util::normalizePath method.

ディスクの指定Specifying A Disk

デフォルトで、storeメソッドはデフォルトディスクを使用します。他のディスクを指定したい場合は第２引数として、ディスク名を渡してください。By default, this method will use your default disk. If you would like to specify another disk, pass the disk name as the second argument to the store method:

$path = $request->file('avatar')->store(
    'avatars/'.$request->user()->id, 's3'
);

storeAsメソッドを使う場合は、ディスク名を第３引数としてメソッドに渡してください。If you are using the storeAs method, you may pass the disk name as the third argument to the method:

$path = $request->file('avatar')->storeAs(
    'avatars',
    $request->user()->id,
    's3'
);

他のファイル情報Other File Information

アップロードしたファイルの元の名前を知りたい場合は、getClientOriginalNameメソッドを使います。If you would like to get original name of the uploaded file, you may do so using the getClientOriginalName method:

$name = $request->file('avatar')->getClientOriginalName();

アップロードしたファイルの拡張子を知りたい場合は、extensionメソッドを使います。The extension method may be used to get the file extension of the uploaded file:

$extension = $request->file('avatar')->extension();

ファイル視認性File Visibility

LaravelのFlysystem統合では、複数のプラットフォームにおけるファイルパーミッションを「視認性」として抽象化しています。ファイルはpublicかprivateのどちらかとして宣言します。ファイルをpublicとして宣言するのは、他からのアクセスを全般的に許可することを表明することです。たとえば、S3ドライバ使用時には、publicファイルのURLを取得することになります。In Laravel's Flysystem integration, "visibility" is an abstraction of file permissions across multiple platforms. Files may either be declared public or private. When a file is declared public, you are indicating that the file should generally be accessible to others. For example, when using the S3 driver, you may retrieve URLs for public files.

putメソッドでファイルをセットする時に、視認性を設定できます。You can set the visibility when setting the file via the put method:

use Illuminate\Support\Facades\Storage;

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

もし、ファイルがすでに保存済みであるなら、getVisibilityとsetVisibilityにより、視認性を取得／設定できます。If the file has already been stored, its visibility can be retrieved and set via the getVisibility and setVisibility methods:

$visibility = Storage::getVisibility('file.jpg');

Storage::setVisibility('file.jpg', 'public');

アップロード済みファイルを取り扱うときは、publicの視認性を付け保存するために、storePubliclyかstorePubliclyAsメソッドを使ってください。When interacting with uploaded files, you may use the storePublicly and storePubliclyAs methods to store the uploaded file with public visibility:

$path = $request->file('avatar')->storePublicly('avatars', 's3');

$path = $request->file('avatar')->storePubliclyAs(
    'avatars',
    $request->user()->id,
    's3'
);

ファイル削除Deleting Files

deleteメソッドはディスクから削除するファイルを単独、もしくは配列で受け付けます。The delete method accepts a single filename or an array of files to remove from the disk:

use Illuminate\Support\Facades\Storage;

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

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

必要であれば、削除先のディスクを指定できます。If necessary, you may specify the disk that the file should be deleted from:

use Illuminate\Support\Facades\Storage;

Storage::disk('s3')->delete('folder_path/file_name.jpg');

ディレクトリDirectories

ディレクトリの全ファイル取得Get All Files Within A Directory

filesメソッドは指定したディレクトリの全ファイルの配列を返します。指定したディレクトリのサブディレクトリにある全ファイルのリストも取得したい場合は、allFilesメソッドを使ってください。The files method returns an array of all of the files in a given directory. If you would like to retrieve a list of all files within a given directory including all subdirectories, you may use the allFiles method:

use Illuminate\Support\Facades\Storage;

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

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

ディレクトリの全ディレクトリ取得Get All Directories Within A Directory

directoriesメソッドは指定したディレクトリの全ディレクトリの配列を返します。指定したディレクトリ下の全ディレクトリと、サブディレクトリ下の全ディレクトリも取得したい場合は、allDirectoriesメソッドを使ってください。The directories method returns an array of all the directories within a given directory. Additionally, you may use the allDirectories method to get a list of all directories within a given directory and all of its subdirectories:

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

// 再帰的
$directories = Storage::allDirectories($directory);

ディレクトリ作成Create A Directory

makeDirectoryメソッドは必要なサブディレクトリを含め、指定したディレクトリを作成します。The makeDirectory method will create the given directory, including any needed subdirectories:

Storage::makeDirectory($directory);

ディレクトリ削除Delete A Directory

最後に、deleteDirectoryメソッドは、ディレクトリと中に含まれている全ファイルを削除するために使用されます。Finally, the deleteDirectory method may be used to remove a directory and all of its files:

Storage::deleteDirectory($directory);

カスタムファイルシステムCustom Filesystems

LaravelのFlysystem統合には、最初からさまざまな「ドライバ」が含まれています。しかしFlysystemはこれらのドライバに限定されず、他の保存領域システムにも適用できます。皆さんのLaravelアプリケーションに適した保存システムに対するカスタムドライバを作成できます。Laravel's Flysystem integration provides drivers for several "drivers" out of the box; however, Flysystem is not limited to these and has adapters for many other storage systems. You can create a custom driver if you want to use one of these additional adapters in your Laravel application.

カスタムファイルシステムを準備するには、Flysystemアダプタが必要です。プロジェクトへコミュニティによりメンテナンスされているDropboxアダプタを追加してみましょう。In order to set up the custom filesystem you will need a Flysystem adapter. Let's add a community maintained Dropbox adapter to our project:

composer require spatie/flysystem-dropbox

次に、たとえばDropboxServiceProviderのような、サービスプロバイダを用意してください。プロバイダのbootメソッドの中でStorageファサードのextendメソッドを使い、カスタムドライバを定義できます。Next, you should create a service provider[/docs/{{version}}/providers] such as DropboxServiceProvider. In the provider's boot method, you may use the Storage facade's extend method to define the custom driver:

<?php

namespace App\Providers;

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

class DropboxServiceProvider extends ServiceProvider
{
    /**
     * 全アプリケーションサービスの登録
     *
     * @return void
     */
    public function register()
    {
        //
    }

    /**
     * 全アプリケーションサービスの初期起動
     *
     * @return void
     */
    public function boot()
    {
        Storage::extend('dropbox', function ($app, $config) {
            $client = new DropboxClient(
                $config['authorization_token']
            );

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

extendメソッドの最初の引数はドライバの名前で、２つ目は$appと$config変数を受け取るクロージャです。このリゾルバークロージャはLeague\Flysystem\Filesystemのインスタンスを返す必要があります。$config変数はconfig/filesystems.phpで定義したディスクの値を含んでいます。The first argument of the extend method is the name of the driver and the second is a Closure that receives the $app and $config variables. The resolver Closure must return an instance of League\Flysystem\Filesystem. The $config variable contains the values defined in config/filesystems.php for the specified disk.

次に、config/app.php設定ファイルで、サービスプロバイダを登録します。Next, register the service provider in your config/app.php configuration file:

'providers' => [
    // ...
    App\Providers\DropboxServiceProvider::class,
];

拡張のサービスプロバイダを作成し、登録し終えたら、config/filesystems.php設定ファイルで、dropboxドライバを使用します。Once you have created and registered the extension's service provider, you may use the dropbox driver in your config/filesystems.php configuration file.