イントロダクション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);