イントロダクションIntroduction
LaravelはFrank de Jongeが作成した、ありがたく素晴らしい抽象ファイルシステムであるFlysystem PHPパッケージを提供しています。LaravelとFlysystemの統合により、ローカルのファイルシステム、Amazon S3、Rackspaceクラウドストレージを操作する、シンプルなドライバーを提供しています。更に良いことに、それぞれのシステムに対し同じAPIを使用しているため、これらのストレージの選択肢を素晴らしく簡単に変更できるのです！Laravel provides a wonderful filesystem abstraction thanks to the 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, Amazon S3, and Rackspace Cloud Storage. 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 is included in the configuration file. So, simply modify the configuration to reflect your storage preferences and credentials!
S3とRackspaceドライバーを使用する場合は、それに適合するパッケージをComposerでインストールする必要があります。Before using the S3 or Rackspace drivers, you will need to install the appropriate package via Composer:
- Amazon S3:
league/flysystem-aws-s3-v2 ~1.0Amazon S3:league/flysystem-aws-s3-v2 ~1.0 - Rackspace:
league/flysystem-rackspace ~1.0Rackspace:league/flysystem-rackspace ~1.0
もちろん、好きなだけディスクを設定できますし、同じドライバーに対し複数のディスクを持つことも可能です。Of course, you may configure as many disks as you like, and may even have multiple disks that use the same driver.
localドライバーを使用する場合、設定ファイルで定義されている、rootディレクトリーからの相対位置として、全ファイルは操作されます。デフォルトでは、この値はstorage/appディレクトリーになっています。ですから、次のコードはstorage/app/file.txtへファイルを保存します。When using the local driver, note that all file operations are relative to the root directory defined in your 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');
基本的な使用法Basic Usage
Storageファサードを使い、設定済みのディスクへの操作ができます。IoCコンテナにより依存解決が行われるクラスで、Illuminate\Contracts\Filesystem\Factory契約をタイプヒントで指定することもできます。The Storage facade may be used to interact with any of your configured disks. Alternatively, you may type-hint the Illuminate\Contracts\Filesystem\Factory contract on any class that is resolved via the IoC container[/docs/master/container].
特定のディスクの取得Retrieving A Particular Disk
$disk = Storage::disk('s3');
$disk = Storage::disk('local');
デフォルトディスクのメソッド呼び出しCalling Methods On The Default Disk
$exists = Storage::disk('s3')->exists('file.jpg');
ファイルの存在判定Determining If A File Exists
if (Storage::exists('file.jpg'))
{
//
}
ファイルの内容の取得Retrieving A File's Contents
$contents = Storage::get('file.jpg');
ファイルへ内容を保存Setting A File's Contents
Storage::put('file.jpg', $contents);
ファイルの先頭に追加Prepend To A File
Storage::prepend('file.log', 'Prepended Text');
ファイルの最後に追加Append To A File
Storage::append('file.log', 'Appended Text');
ファイル削除Delete A File
Storage::delete('file.jpg');
Storage::delete(['file1.jpg', 'file2.jpg']);
ファイルを新しい場所へコピーCopy A File To A New Location
Storage::copy('old/file1.jpg', 'new/file1.jpg');
ファイルを新しい場所へ移動Move A File To A New Location
Storage::move('old/file1.jpg', 'new/file1.jpg');
ファイルサイズの取得Get File Size
$size = Storage::size('file1.jpg');
最後の修正時間の取得(Unix)Get The Last Modification Time (UNIX)
$time = Storage::lastModified('file1.jpg');
ディレクトリー中の全ファイル取得Get All Files Within A Directory
$files = Storage::files($directory);
// 再帰的…
$files = Storage::allFiles($directory);
ディレクトリー中の全ディレクトリー取得Get All Directories Within A Directory
$directories = Storage::directories($directory);
// Recursive...
$directories = Storage::allDirectories($directory);
ディレクトリー作成Create A Directory
Storage::makeDirectory($directory);
ディレクトリー削除Delete A Directory
Storage::deleteDirectory($directory);