Laravel 基于 Frank de Jonge 开发的 PHP 包 Flysystem 提供了强大的文件系统抽象。Laravel 文件系统集成对使用驱动处理本地文件系统进行了简化,这些驱动包括Amazon S3,以及 Rackspace 云存储。此外,在这些存储选项间切换非常简单,因为对不同系统而言,API 是一致的。
文件系统配置文件位于 config/filesystems.php。在该文件中可以配置所有“磁盘”,每个磁盘描述了特定的存储驱动和存储位置。该配置文件为每种支持的驱动提供了示例配置,所以,简单编辑该配置来应用你的存储参数和认证信息即可。
当然,你想配置多少磁盘就配置多少,多个磁盘也可以共用同一个驱动。
public 磁盘用于存储可以被公开访问的文件,默认情况下, public 磁盘使用 local 驱动并将文件存储在 storage/app/public ,要让这些文件可以通过web 访问到,需要创建一个软链 public/storage 指向 storage/app/public ,这种方式可以将公开访问的文件保存在一个可以很容易被不同部署环境共享的目录,在使用零停机时间部署系统如Envoyer 的时候尤其方便。
要创建这个软链,可以使用 Artisan 命令 storage:link :
php artisan storage:link
文件被存储并且软链已经被创建的情况下,就可以使用辅助函数 asset 创建一个指向该文件的URL:
echo asset('storage/file.txt');
使用 local 驱动的时候,所有的文件操作都相对于定义在配置文件中的 root 目录,默认情况下,该值设置为 storage/app 目录,因此,下面的方法将会存储文件到storage/app/file.txt:
Storage::disk('local')->put('file.txt', 'Contents');
Composer包
在使用 Amazon S3 或 Rackspace 驱动之前,需要通过Composer 安装相应的包:
Amazon S3: league/flysystem-aws-s3-v3 ~1.0
Rackspace: league/flysystem-rackspace ~1.0
S3驱动配置
S3 驱动配置信息位于配置文件 config/filesystems.php ,该文件包含 S3 驱动的示例配置数组。你可以使用自己的 S3 配置和认证信息自由编辑该数组。
FTP驱动配置
Laravel 的文件系统集成了 FTP 操作,不过,框架默认的配置文件 filesystems.php 并没有提供示例配置。如果你需要配置一个FTP文件系统,可以使用以下示例配置:
'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, ],
Rackspace驱动配置
Laravel 的 Flysystem 还集成了 Rackspace ,同样,默认配置文件 filesystems.php 也没有提供对应的示例配置,如果你需要配置Rackspace 文件系统,可以使用以下示例配置:
'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', ],
Storage 门面用于和你配置的任意磁盘进行交互,例如,你可以使用该门面上的 put 方法来存储头像到默认磁盘,如果你调用 Storage 门面上的方法而没有调用 disk 方法,则调用的方法会自动被传递到默认磁盘:
use Illuminate\Support\Facades\Storage; Storage::put('avatars/1', $fileContents);
与多个磁盘进行交互时,可以使用Storage 门面上的 disk 方法访问特定磁盘:
Storage::disk('s3')->put('avatars/1', $fileContents);
get 方法用于获取给定文件的内容,该方法将会返回该文件的原生字符串内容。需要注意的是,所有文件路径都是相对于配置文件中指定的磁盘默认根目录:
$contents = Storage::get('file.jpg');
exists 方法用于判断给定文件是否存在于磁盘上:
$exists = Storage::disk('s3')->exists('file.jpg');
使用 local 或 s3 驱动时,可以使用 url 方法获取给定文件的URI。如果你使用的是 local 驱动,通常会在给定路径前加上 /storage,并返回该文件的相对URL;如果使用的是 s3 驱动,则会返回完整的远程URL:
use Illuminate\Support\Facades\Storage; $url = Storage::url('file1.jpg');
注:记住,如果你在使用 local 驱动,所有需要公开访问的文件都应该存放在 storage/app/public 目录下,此外,你还需要为 storage/app/public 创建一个软链接。
自定义本地主机URL
如果你想要预定义使用 local 驱动磁盘存放文件的主机,可以添加 url 选项到磁盘配置数组:
'public' => [ 'driver' => 'local', 'root' => storage_path('app/public'), 'url' => env('APP_URL').'/storage', 'visibility' => 'public', ],
除了读写文件之外,Laravel 还可以提供文件本身的信息。例如,size 方法可用于以字节方式返回文件大小:
use Illuminate\Support\Facades\Storage; $size = Storage::size('file1.jpg');
lastModified 方法以 UNIX 时间戳
格式返回文件最后一次修改时间:
$time = Storage::lastModified('file1.jpg');
put 方法可用于存储原生文件内容到磁盘。此外,还可以传递一个PHP资源到 put 方法,该方法将会使用 Flysystem 底层的流支持。在处理大文件的时候推荐使用文件流:
use Illuminate\Support\Facades\Storage; Storage::put('file.jpg', $contents); Storage::put('file.jpg', $resource);
自动文件流
如果你想要 Laravel 自动将给定文件流输出到对应存储路径,可以使用putFile 或 putFileAs 方法,该方法接收 Illuminate\Http\File 或 Illuminate\Http\UploadedFile 实例,然后自动将文件流保存到期望的路径:
use Illuminate\Http\File; // 自动计算文件名的MD5值... Storage::putFile('photos', new File('/path/to/photo')); // 手动指定文件名... Storage::putFileAs('photos', new File('/path/to/photo'), 'photo.jpg');
这里有一些关于 putFile 方法的重要注意点,注意到我们只指定了目录名,默认情况下,putFile 方法会基于文件内容自动生成文件名。实现原理是对文件内容进行MD5哈希运算。putFile 方法会返回文件路径,包括文件名,以便于在数据库中进行存储。
putFile 和 putFileAs 方法还接收一个用于指定存储文件“能见度”的参数,这在你将文件存储到云存储(如S3)平台并期望文件可以被公开访问时很有用:
Storage::putFile('photos', new File('/path/to/photo'), 'public');
添加内容到文件开头/结尾
prepend 和 append 方法允许你轻松插入内容到文件开头/结尾:
Storage::prepend('file.log', 'Prepended Text'); Storage::append('file.log', 'Appended Text');
拷贝 & 移动文件
copy 方法将磁盘中已存在的文件从一个地方拷贝到另一个地方,而move 方法将磁盘中已存在的文件从一定地方移到到另一个地方:
Storage::copy('old/file1.jpg', 'new/file1.jpg'); Storage::move('old/file1.jpg', 'new/file1.jpg');
在 Web 应用中,最常见的存储文件案例就是存储用户上传的文件,如用户头像、照片和文档等。Laravel 通过使用上传文件实例上的 store 方法让存储上传文件变得简单。你只需要传入上传文件保存的路径并调用 store 方法即可:
<?php namespace App\Http\Controllers; use Illuminate\Http\Request; use App\Http\Controllers\Controller; class UserAvatarController extends Controller { /** * 更新用户头像. * * @param Request $request * @return Response * @translator laravelacademy.org */ public function update(Request $request) { $path = $request->file('avatar')->store('avatars'); return $path; } }
这里有一些需要注意的重要事项,在这里我们只指定了目录名,而不是文件名。默认情况下,store 方法会基于文件内容自动生成文件名,这通过对文件内容进行MD5实现。store 方法会返回文件路径以便在数据库中保存文件路径和文件名。
本文由:xiaoshu168 作者:xiaoshu发表,转载请注明来源!