Laravel提供了一套很好用的文件系统 方便于管理文件夹和文件,支持Amazon S3和Rackspace云存储等驱动。
1 配置
文件系统的配置文件在 config/filesyetems.php 中,且它的注释写的很清楚了,此外你可以在disks数组中创建新的disk:
<?php return [ /* |-------------------------------------------------------------------------- | Default Filesystem Disk |-------------------------------------------------------------------------- | | Here you may specify the default filesystem disk that should be used | by the framework. A "local" driver, as well as a variety of cloud | based drivers are available for your choosing. Just store away! | | Supported: "local", "ftp", "s3", "rackspace" | */ 'default' => 'local', /* |-------------------------------------------------------------------------- | Default Cloud Filesystem Disk |-------------------------------------------------------------------------- | | Many applications store files both locally and in the cloud. For this | reason, you may specify a default "cloud" driver here. This driver | will be bound as the Cloud disk implementation in the container. | */ 'cloud' => 's3', /* |-------------------------------------------------------------------------- | Filesystem Disks |-------------------------------------------------------------------------- | | Here you may configure as many filesystem "disks" as you wish, and you | may even configure multiple disks of the same driver. Defaults have | been setup for each driver as an example of the required options. | */ 'disks' => [ 'local' => [ 'driver' => 'local', 'root' => storage_path('app'), ], 'ftp' => [ 'driver' => 'ftp', 'host' => 'ftp.example.com', 'username' => 'your-username', 'password' => 'your-password', // Optional FTP Settings... // 'port' => 21, // 'root' => '', // 'passive' => true, // 'ssl' => true, // 'timeout' => 30, ], 's3' => [ 'driver' => 's3', 'key' => 'your-key', 'secret' => 'your-secret', 'region' => 'your-region', 'bucket' => 'your-bucket', ], 'rackspace' => [ 'driver' => 'rackspace', 'username' => 'your-username', 'key' => 'your-key', 'container' => 'your-container', 'endpoint' => 'https://identity.api.rackspacecloud.com/v2.0/', 'region' => 'IAD', 'url_type' => 'publicURL', ], ], ];
一般情况下最常用的是local(本地)存储,所以特别说下,我们可以通过修改'root'来修改我们的root路径:
'local' => [ 'driver' => 'local', // 'root' => storage_path('app'), 在/storage/app/目录 'root' => public_path('uploads'), // 在public/uploads/ 目录 ],
2 获取硬盘实例
要进行文件管理需要那到硬盘实例,我们可以通过 Storage 门面的 disk 方法来获取,之后就可以进行我们想要的操作了:
public function index() { $disk = Storage::disk('local'); // 创建一个文件 $disk->put('file1.txt', 'Laravel Storage'); }
3 文件操作
3.1 获取文件
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 取出文件 $file = $disk->get('test.txt'); dd($file); }
我们可以使用get()方法获取到文件 以字符串的形式传入文件名就行,但是需要主意:如果你要取到子目录以下的文件时需要传入路径,比如:$disk->get('subpath/.../.../.../file.txt');
3.2 判断文件是否存在
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 取出文件 $exists = $disk->exists('image.png'); dd($exists); // false }
3.3 获取文件信息
文件大小:
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 取出文件 $size = Storage::size('/home/test.txt'); dd($size); // 4 }
最后修改时间:
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 取出文件 $time = Storage::lastModified('file1.txt'); // 1507701271 $time = Carbon::createFromTimestamp($time); echo $time; // 2017-10-11 05:54:31 }
3.4 储存文件
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 储存文件 $disk->put('file2.txt', 'file2 content'); // 新建一个文件 }
3.5 Copy文件
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 拷贝文件 第一个参数是要拷贝的文件,第二个参数是拷贝到哪里 $disk->copy('home/test.txt','rename.txt'); }
3.6 移动文件
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 拷贝文件 第一个参数是要移动的文件,第二个参数是移动到哪里 $disk->move('file2.txt', 'home/file.txt'); }
3.7 在文件开头/结尾添加内容
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 在文件开头添加 $disk->prepend('file1.txt', 'test prepend'); // 在文件末尾添加 $disk->append('file1.txt', 'test append'); }
3.8 删除文件
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 删除单条文件 $disk->delete('test.txt'); // 删除多条文件 $disk->delete(['test22.txt', 'icon.jpg']); }
4 目录操作
4.1 取到目录下的文件
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); $directory = '/'; // 获取目录下的文件 $files = $disk->files($directory); // 获取目录下的所有文件(包括子目录下的文件) $allFiles = $disk->allFiles($directory); dd($files, $allFiles); }
4.2 取到子目录
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); $directory = '/'; // 获取目录下的子目录 $directories = $disk->directories($directory); // 获取目录下的所有子目录(包括子目录下的子目录) $allDirectories = $disk->allDirectories($directory); dd($directories, $allDirectories); }
4.3 创建目录
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 创建目录 $disk->makeDirectory('test'); $disk->makeDirectory('test1/test2'); }
4.4 删除目录
public function index() { // 取到磁盘实例 $disk = Storage::disk('local'); // 删除目录 $disk->deleteDirectory('test'); $disk->deleteDirectory('test1/test2'); }