文件存储
简介
Laravel 借助 Frank de Jonge 编写的出色的 Flysystem PHP 包,提供了强大的文件系统抽象层。Laravel Flysystem 集成提供了简单的驱动程序,用于处理本地文件系统、SFTP 和 Amazon S3。更棒的是,在本地开发机器和生产服务器之间切换这些存储选项非常简单,因为每个系统的 API 保持不变。
配置
Laravel 的文件系统配置文件位于 config/filesystems.php
。在此文件中,您可以配置所有文件系统“磁盘”。每个磁盘代表一个特定的存储驱动程序和存储位置。配置文件中包含了每个支持的驱动程序的配置示例,您可以修改配置以反映您的存储偏好和凭据。
local
驱动程序与存储在运行 Laravel 应用程序的服务器本地的文件进行交互,而 s3
驱动程序用于写入 Amazon 的 S3 云存储服务。
您可以配置任意数量的磁盘,甚至可以拥有多个使用相同驱动程序的磁盘。
本地驱动
当使用 local
驱动程序时,所有文件操作都相对于您的 filesystems
配置文件中定义的 root
目录。默认情况下,此值设置为 storage/app/private
目录。因此,以下方法将写入 storage/app/private/example.txt
1use Illuminate\Support\Facades\Storage;2 3Storage::disk('local')->put('example.txt', 'Contents');
公共磁盘
应用程序的 filesystems
配置文件中包含的 public
磁盘旨在用于将要公开访问的文件。默认情况下,public
磁盘使用 local
驱动程序,并将其文件存储在 storage/app/public
中。
如果您的 public
磁盘使用 local
驱动程序,并且您希望从 Web 访问这些文件,则应创建从源目录 storage/app/public
到目标目录 public/storage
的符号链接
要创建符号链接,您可以使用 storage:link
Artisan 命令
1php artisan storage:link
一旦文件被存储并且符号链接被创建,您可以使用 asset
辅助函数创建指向文件的 URL
1echo asset('storage/file.txt');
您可以在 filesystems
配置文件中配置其他符号链接。当您运行 storage:link
命令时,将创建每个配置的链接
1'links' => [2 public_path('storage') => storage_path('app/public'),3 public_path('images') => storage_path('app/images'),4],
storage:unlink
命令可用于销毁您配置的符号链接
1php artisan storage:unlink
驱动先决条件
S3 驱动配置
在使用 S3 驱动程序之前,您需要通过 Composer 包管理器安装 Flysystem S3 包
1composer require league/flysystem-aws-s3-v3 "^3.0" --with-all-dependencies
S3 磁盘配置数组位于您的 config/filesystems.php
配置文件中。通常,您应该使用以下环境变量配置您的 S3 信息和凭据,这些环境变量由 config/filesystems.php
配置文件引用
1AWS_ACCESS_KEY_ID=<your-key-id>2AWS_SECRET_ACCESS_KEY=<your-secret-access-key>3AWS_DEFAULT_REGION=us-east-14AWS_BUCKET=<your-bucket-name>5AWS_USE_PATH_STYLE_ENDPOINT=false
为方便起见,这些环境变量与 AWS CLI 使用的命名约定匹配。
FTP 驱动配置
在使用 FTP 驱动程序之前,您需要通过 Composer 包管理器安装 Flysystem FTP 包
1composer require league/flysystem-ftp "^3.0"
Laravel 的 Flysystem 集成与 FTP 配合良好;但是,框架的默认 config/filesystems.php
配置文件中未包含示例配置。如果您需要配置 FTP 文件系统,可以使用以下配置示例
1'ftp' => [ 2 'driver' => 'ftp', 3 'host' => env('FTP_HOST'), 4 'username' => env('FTP_USERNAME'), 5 'password' => env('FTP_PASSWORD'), 6 7 // Optional FTP Settings... 8 // 'port' => env('FTP_PORT', 21), 9 // 'root' => env('FTP_ROOT'),10 // 'passive' => true,11 // 'ssl' => true,12 // 'timeout' => 30,13],
SFTP 驱动配置
在使用 SFTP 驱动程序之前,您需要通过 Composer 包管理器安装 Flysystem SFTP 包
1composer require league/flysystem-sftp-v3 "^3.0"
Laravel 的 Flysystem 集成与 SFTP 配合良好;但是,框架的默认 config/filesystems.php
配置文件中未包含示例配置。如果您需要配置 SFTP 文件系统,可以使用以下配置示例
1'sftp' => [ 2 'driver' => 'sftp', 3 'host' => env('SFTP_HOST'), 4 5 // Settings for basic authentication... 6 'username' => env('SFTP_USERNAME'), 7 'password' => env('SFTP_PASSWORD'), 8 9 // Settings for SSH key based authentication with encryption password...10 'privateKey' => env('SFTP_PRIVATE_KEY'),11 'passphrase' => env('SFTP_PASSPHRASE'),12 13 // Settings for file / directory permissions...14 'visibility' => 'private', // `private` = 0600, `public` = 064415 'directory_visibility' => 'private', // `private` = 0700, `public` = 075516 17 // Optional SFTP Settings...18 // 'hostFingerprint' => env('SFTP_HOST_FINGERPRINT'),19 // 'maxTries' => 4,20 // 'passphrase' => env('SFTP_PASSPHRASE'),21 // 'port' => env('SFTP_PORT', 22),22 // 'root' => env('SFTP_ROOT', ''),23 // 'timeout' => 30,24 // 'useAgent' => true,25],
作用域和只读文件系统
作用域磁盘允许您定义一个文件系统,其中所有路径都自动以给定的路径前缀开头。在创建作用域文件系统磁盘之前,您需要通过 Composer 包管理器安装一个额外的 Flysystem 包
1composer require league/flysystem-path-prefixing "^3.0"
您可以通过定义使用 scoped
驱动程序的磁盘来创建任何现有文件系统磁盘的路径作用域实例。例如,您可以创建一个磁盘,将您现有的 s3
磁盘的作用域限定为特定的路径前缀,然后每次使用您的作用域磁盘进行文件操作都将使用指定的前缀
1's3-videos' => [2 'driver' => 'scoped',3 'disk' => 's3',4 'prefix' => 'path/to/videos',5],
“只读”磁盘允许您创建不允许写入操作的文件系统磁盘。在使用 read-only
配置选项之前,您需要通过 Composer 包管理器安装一个额外的 Flysystem 包
1composer require league/flysystem-read-only "^3.0"
接下来,您可以将 read-only
配置选项包含在一个或多个磁盘的配置数组中
1's3-videos' => [2 'driver' => 's3',3 // ...4 'read-only' => true,5],
Amazon S3 兼容文件系统
默认情况下,您的应用程序的 filesystems
配置文件包含 s3
磁盘的磁盘配置。除了使用此磁盘与 Amazon S3 交互外,您还可以使用它与任何 S3 兼容的文件存储服务交互,例如 MinIO、DigitalOcean Spaces、Vultr Object Storage、Cloudflare R2 或 Hetzner Cloud Storage。
通常,在更新磁盘的凭据以匹配您计划使用的服务的凭据后,您只需要更新 endpoint
配置选项的值。此选项的值通常通过 AWS_ENDPOINT
环境变量定义
1'endpoint' => env('AWS_ENDPOINT', 'https://minio:9000'),
MinIO
为了使 Laravel 的 Flysystem 集成在使用 MinIO 时生成正确的 URL,您应该定义 AWS_URL
环境变量,使其与您的应用程序的本地 URL 匹配,并在 URL 路径中包含存储桶名称
1AWS_URL=https://127.0.0.1:9000/local
如果客户端无法访问 endpoint
,则通过 temporaryUrl
方法生成临时存储 URL 可能在使用 MinIO 时不起作用。
获取磁盘实例
可以使用 Storage
外观模式与您配置的任何磁盘进行交互。例如,您可以使用外观模式上的 put
方法在默认磁盘上存储头像。如果您在没有先调用 disk
方法的情况下调用 Storage
外观模式上的方法,该方法将自动传递到默认磁盘
1use Illuminate\Support\Facades\Storage;2 3Storage::put('avatars/1', $content);
如果您的应用程序与多个磁盘交互,您可以使用 Storage
外观模式上的 disk
方法来处理特定磁盘上的文件
1Storage::disk('s3')->put('avatars/1', $content);
按需磁盘
有时您可能希望在运行时使用给定的配置创建磁盘,而该配置实际上并未出现在应用程序的 filesystems
配置文件中。为了实现这一点,您可以将配置数组传递给 Storage
外观模式的 build
方法
1use Illuminate\Support\Facades\Storage;2 3$disk = Storage::build([4 'driver' => 'local',5 'root' => '/path/to/root',6]);7 8$disk->put('image.jpg', $content);
检索文件
get
方法可用于检索文件的内容。该方法将返回文件的原始字符串内容。请记住,所有文件路径都应相对于磁盘的“根”位置指定
1$contents = Storage::get('file.jpg');
如果您检索的文件包含 JSON,则可以使用 json
方法检索文件并解码其内容
1$orders = Storage::json('orders.json');
exists
方法可用于确定磁盘上是否存在文件
1if (Storage::disk('s3')->exists('file.jpg')) {2 // ...3}
missing
方法可用于确定磁盘上是否缺少文件
1if (Storage::disk('s3')->missing('file.jpg')) {2 // ...3}
下载文件
download
方法可用于生成响应,强制用户浏览器下载给定路径的文件。download
方法接受文件名作为该方法的第二个参数,这将确定下载文件的用户看到的文件名。最后,您可以将 HTTP 标头数组作为该方法的第三个参数传递
1return Storage::download('file.jpg');2 3return Storage::download('file.jpg', $name, $headers);
文件 URL
您可以使用 url
方法获取给定文件的 URL。如果您使用的是 local
驱动程序,这通常只是将 /storage
添加到给定路径并返回文件的相对 URL。如果您使用的是 s3
驱动程序,则将返回完全限定的远程 URL
1use Illuminate\Support\Facades\Storage;2 3$url = Storage::url('file.jpg');
当使用 local
驱动程序时,所有应公开访问的文件都应放置在 storage/app/public
目录中。此外,您应该在 public/storage
处创建符号链接,该链接指向 storage/app/public
目录。
当使用 local
驱动程序时,url
的返回值未进行 URL 编码。因此,我们建议始终使用将创建有效 URL 的名称存储您的文件。
URL 主机自定义
如果您想修改使用 Storage
外观模式生成的 URL 的主机,您可以在磁盘的配置数组中添加或更改 url
选项
1'public' => [2 'driver' => 'local',3 'root' => storage_path('app/public'),4 'url' => env('APP_URL').'/storage',5 'visibility' => 'public',6 'throw' => false,7],
临时 URL
使用 temporaryUrl
方法,您可以为使用 local
和 s3
驱动程序存储的文件创建临时 URL。此方法接受一个路径和一个 DateTime
实例,用于指定 URL 的过期时间
1use Illuminate\Support\Facades\Storage;2 3$url = Storage::temporaryUrl(4 'file.jpg', now()->addMinutes(5)5);
启用本地临时 URL
如果您在 local
驱动程序引入临时 URL 支持之前就开始开发应用程序,您可能需要启用本地临时 URL。为此,请将 serve
选项添加到 config/filesystems.php
配置文件中 local
磁盘的配置数组中
1'local' => [2 'driver' => 'local',3 'root' => storage_path('app/private'),4 'serve' => true, 5 'throw' => false,6],
S3 请求参数
如果您需要指定额外的 S3 请求参数,您可以将请求参数数组作为第三个参数传递给 temporaryUrl
方法
1$url = Storage::temporaryUrl(2 'file.jpg',3 now()->addMinutes(5),4 [5 'ResponseContentType' => 'application/octet-stream',6 'ResponseContentDisposition' => 'attachment; filename=file2.jpg',7 ]8);
自定义临时 URL
如果您需要自定义特定存储磁盘的临时 URL 创建方式,可以使用 buildTemporaryUrlsUsing
方法。例如,如果您有一个控制器允许您下载通过通常不支持临时 URL 的磁盘存储的文件,这将非常有用。通常,此方法应从服务提供程序的 boot
方法中调用
1<?php 2 3namespace App\Providers; 4 5use DateTime; 6use Illuminate\Support\Facades\Storage; 7use Illuminate\Support\Facades\URL; 8use Illuminate\Support\ServiceProvider; 9 10class AppServiceProvider extends ServiceProvider11{12 /**13 * Bootstrap any application services.14 */15 public function boot(): void16 {17 Storage::disk('local')->buildTemporaryUrlsUsing(18 function (string $path, DateTime $expiration, array $options) {19 return URL::temporarySignedRoute(20 'files.download',21 $expiration,22 array_merge($options, ['path' => $path])23 );24 }25 );26 }27}
临时上传 URL
只有 s3
驱动程序支持生成临时上传 URL 的功能。
如果您需要生成一个临时 URL,该 URL 可用于直接从您的客户端应用程序上传文件,您可以使用 temporaryUploadUrl
方法。此方法接受一个路径和一个 DateTime
实例,用于指定 URL 的过期时间。temporaryUploadUrl
方法返回一个关联数组,该数组可以被解构为上传 URL 和应包含在上传请求中的标头
1use Illuminate\Support\Facades\Storage;2 3['url' => $url, 'headers' => $headers] = Storage::temporaryUploadUrl(4 'file.jpg', now()->addMinutes(5)5);
此方法主要在无服务器环境中非常有用,这些环境要求客户端应用程序直接将文件上传到云存储系统,例如 Amazon S3。
文件元数据
除了读取和写入文件之外,Laravel 还可以提供有关文件本身的信息。例如,size
方法可用于获取文件大小(以字节为单位)
1use Illuminate\Support\Facades\Storage;2 3$size = Storage::size('file.jpg');
lastModified
方法返回文件上次修改时间的 UNIX 时间戳
1$time = Storage::lastModified('file.jpg');
给定文件的 MIME 类型可以通过 mimeType
方法获得
1$mime = Storage::mimeType('file.jpg');
文件路径
您可以使用 path
方法来获取给定文件的路径。如果您使用的是 local
驱动程序,这将返回文件的绝对路径。如果您使用的是 s3
驱动程序,此方法将返回文件在 S3 存储桶中的相对路径
1use Illuminate\Support\Facades\Storage;2 3$path = Storage::path('file.jpg');
存储文件
put
方法可用于将文件内容存储到磁盘上。您也可以将 PHP resource
传递给 put
方法,这将使用 Flysystem 的底层流支持。请记住,所有文件路径都应相对于为磁盘配置的“根”位置指定
1use Illuminate\Support\Facades\Storage;2 3Storage::put('file.jpg', $contents);4 5Storage::put('file.jpg', $resource);
写入失败
如果 put
方法(或其他“写入”操作)无法将文件写入磁盘,则将返回 false
1if (! Storage::put('file.jpg', $contents)) {2 // The file could not be written to disk...3}
如果您愿意,可以在文件系统磁盘的配置数组中定义 throw
选项。当此选项定义为 true
时,当写入操作失败时,put
等“写入”方法将抛出 League\Flysystem\UnableToWriteFile
的实例
1'public' => [2 'driver' => 'local',3 // ...4 'throw' => true,5],
在文件前追加和后追加内容
prepend
和 append
方法允许您写入文件的开头或结尾
1Storage::prepend('file.log', 'Prepended Text');2 3Storage::append('file.log', 'Appended Text');
复制和移动文件
copy
方法可用于将现有文件复制到磁盘上的新位置,而 move
方法可用于重命名或将现有文件移动到新位置
1Storage::copy('old/file.jpg', 'new/file.jpg');2 3Storage::move('old/file.jpg', 'new/file.jpg');
自动流式传输
将文件流式传输到存储可以显着减少内存使用量。如果您希望 Laravel 自动管理将给定文件流式传输到您的存储位置,您可以使用 putFile
或 putFileAs
方法。此方法接受 Illuminate\Http\File
或 Illuminate\Http\UploadedFile
实例,并将自动将文件流式传输到您期望的位置
1use Illuminate\Http\File;2use Illuminate\Support\Facades\Storage;3 4// Automatically generate a unique ID for filename...5$path = Storage::putFile('photos', new File('/path/to/photo'));6 7// Manually specify a filename...8$path = Storage::putFileAs('photos', new File('/path/to/photo'), 'photo.jpg');
关于 putFile
方法,有几点重要事项需要注意。请注意,我们只指定了目录名称,而不是文件名。默认情况下,putFile
方法将生成一个唯一 ID 作为文件名。文件的扩展名将通过检查文件的 MIME 类型来确定。文件的路径将由 putFile
方法返回,因此您可以将路径(包括生成的文件名)存储在数据库中。
putFile
和 putFileAs
方法还接受一个参数来指定存储文件的“可见性”。如果您要将文件存储在云磁盘(例如 Amazon S3)上,并且希望该文件可以通过生成的 URL 公开访问,这将特别有用
1Storage::putFile('photos', new File('/path/to/photo'), 'public');
文件上传
在 Web 应用程序中,存储文件最常见的用例之一是存储用户上传的文件,例如照片和文档。Laravel 使使用上传文件实例上的 store
方法存储上传文件变得非常容易。使用您希望存储上传文件的路径调用 store
方法
1<?php 2 3namespace App\Http\Controllers; 4 5use App\Http\Controllers\Controller; 6use Illuminate\Http\Request; 7 8class UserAvatarController extends Controller 9{10 /**11 * Update the avatar for the user.12 */13 public function update(Request $request): string14 {15 $path = $request->file('avatar')->store('avatars');16 17 return $path;18 }19}
关于此示例,有几点重要事项需要注意。请注意,我们只指定了目录名称,而不是文件名。默认情况下,store
方法将生成一个唯一 ID 作为文件名。文件的扩展名将通过检查文件的 MIME 类型来确定。文件的路径将由 store
方法返回,因此您可以将路径(包括生成的文件名)存储在数据库中。
您也可以在 Storage
facade 上调用 putFile
方法,以执行与上述示例相同的文件存储操作
1$path = Storage::putFile('avatars', $request->file('avatar'));
指定文件名
如果您不希望自动为存储的文件分配文件名,您可以使用 storeAs
方法,该方法接收路径、文件名和(可选)磁盘作为其参数
1$path = $request->file('avatar')->storeAs(2 'avatars', $request->user()->id3);
您也可以在 Storage
facade 上使用 putFileAs
方法,这将执行与上述示例相同的文件存储操作
1$path = Storage::putFileAs(2 'avatars', $request->file('avatar'), $request->user()->id3);
不可打印和无效的 Unicode 字符将自动从文件路径中删除。因此,您可能希望在将文件路径传递给 Laravel 的文件存储方法之前对其进行清理。文件路径使用 League\Flysystem\WhitespacePathNormalizer::normalizePath
方法进行规范化。
指定磁盘
默认情况下,此上传文件的 store
方法将使用您的默认磁盘。如果您想指定另一个磁盘,请将磁盘名称作为第二个参数传递给 store
方法
1$path = $request->file('avatar')->store(2 'avatars/'.$request->user()->id, 's3'3);
如果您使用的是 storeAs
方法,您可以将磁盘名称作为第三个参数传递给该方法
1$path = $request->file('avatar')->storeAs(2 'avatars',3 $request->user()->id,4 's3'5);
其他上传文件信息
如果您想获取上传文件的原始名称和扩展名,可以使用 getClientOriginalName
和 getClientOriginalExtension
方法
1$file = $request->file('avatar');2 3$name = $file->getClientOriginalName();4$extension = $file->getClientOriginalExtension();
但是,请记住 getClientOriginalName
和 getClientOriginalExtension
方法被认为是不安全的,因为文件名和扩展名可能会被恶意用户篡改。因此,您通常应首选 hashName
和 extension
方法来获取给定文件上传的名称和扩展名
1$file = $request->file('avatar');2 3$name = $file->hashName(); // Generate a unique, random name...4$extension = $file->extension(); // Determine the file's extension based on the file's MIME type...
文件可见性
在 Laravel 的 Flysystem 集成中,“可见性”是对跨多个平台的文件权限的抽象。文件可以声明为 public
或 private
。当文件声明为 public
时,您表明该文件通常应该可以被其他人访问。例如,当使用 S3 驱动程序时,您可以检索 public
文件的 URL。
您可以在通过 put
方法写入文件时设置可见性
1use Illuminate\Support\Facades\Storage;2 3Storage::put('file.jpg', $contents, 'public');
如果文件已经存储,则可以通过 getVisibility
和 setVisibility
方法检索和设置其可见性
1$visibility = Storage::getVisibility('file.jpg');2 3Storage::setVisibility('file.jpg', 'public');
当与上传文件交互时,您可以使用 storePublicly
和 storePubliclyAs
方法以 public
可见性存储上传文件
1$path = $request->file('avatar')->storePublicly('avatars', 's3');2 3$path = $request->file('avatar')->storePubliclyAs(4 'avatars',5 $request->user()->id,6 's3'7);
本地文件和可见性
当使用 local
驱动程序时,public
可见性 转换为目录的 0755
权限和文件的 0644
权限。您可以在应用程序的 filesystems
配置文件中修改权限映射
1 2``````php 3'local' => [ 4 'driver' => 'local', 5 'root' => storage_path('app'), 6 'permissions' => [ 7 'file' => [ 8 'public' => 0644, 9 'private' => 0600,10 ],11 'dir' => [12 'public' => 0755,13 'private' => 0700,14 ],15 ],16 'throw' => false,17],
删除文件
delete
方法接受单个文件名或要删除的文件数组
1 2``````php3use Illuminate\Support\Facades\Storage;4 5Storage::delete('file.jpg');6 7Storage::delete(['file.jpg', 'file2.jpg']);
如有必要,您可以指定应从中删除文件的磁盘
1 2``````php3use Illuminate\Support\Facades\Storage;4 5Storage::disk('s3')->delete('path/file.jpg');
目录
获取目录中的所有文件
files
方法返回给定目录中所有文件的数组。如果您想检索给定目录(包括所有子目录)中的所有文件列表,可以使用 allFiles
方法
1use Illuminate\Support\Facades\Storage;2 3$files = Storage::files($directory);4 5$files = Storage::allFiles($directory);
获取目录中的所有目录
directories
方法返回给定目录中所有目录的数组。此外,您可以使用 allDirectories
方法来获取给定目录及其所有子目录中的所有目录列表
1$directories = Storage::directories($directory);2 3$directories = Storage::allDirectories($directory);
创建目录
makeDirectory
方法将创建给定的目录,包括任何需要的子目录
1Storage::makeDirectory($directory);
删除目录
最后,deleteDirectory
方法可用于删除目录及其所有文件
1Storage::deleteDirectory($directory);
测试
Storage
facade 的 fake
方法允许您轻松生成一个伪造磁盘,结合 Illuminate\Http\UploadedFile
类的文件生成实用程序,可以大大简化文件上传的测试。例如
1<?php 2 3use Illuminate\Http\UploadedFile; 4use Illuminate\Support\Facades\Storage; 5 6test('albums can be uploaded', function () { 7 Storage::fake('photos'); 8 9 $response = $this->json('POST', '/photos', [10 UploadedFile::fake()->image('photo1.jpg'),11 UploadedFile::fake()->image('photo2.jpg')12 ]);13 14 // Assert one or more files were stored...15 Storage::disk('photos')->assertExists('photo1.jpg');16 Storage::disk('photos')->assertExists(['photo1.jpg', 'photo2.jpg']);17 18 // Assert one or more files were not stored...19 Storage::disk('photos')->assertMissing('missing.jpg');20 Storage::disk('photos')->assertMissing(['missing.jpg', 'non-existing.jpg']);21 22 // Assert that the number of files in a given directory matches the expected count...23 Storage::disk('photos')->assertCount('/wallpapers', 2);24 25 // Assert that a given directory is empty...26 Storage::disk('photos')->assertDirectoryEmpty('/wallpapers');27});
1<?php 2 3namespace Tests\Feature; 4 5use Illuminate\Http\UploadedFile; 6use Illuminate\Support\Facades\Storage; 7use Tests\TestCase; 8 9class ExampleTest extends TestCase10{11 public function test_albums_can_be_uploaded(): void12 {13 Storage::fake('photos');14 15 $response = $this->json('POST', '/photos', [16 UploadedFile::fake()->image('photo1.jpg'),17 UploadedFile::fake()->image('photo2.jpg')18 ]);19 20 // Assert one or more files were stored...21 Storage::disk('photos')->assertExists('photo1.jpg');22 Storage::disk('photos')->assertExists(['photo1.jpg', 'photo2.jpg']);23 24 // Assert one or more files were not stored...25 Storage::disk('photos')->assertMissing('missing.jpg');26 Storage::disk('photos')->assertMissing(['missing.jpg', 'non-existing.jpg']);27 28 // Assert that the number of files in a given directory matches the expected count...29 Storage::disk('photos')->assertCount('/wallpapers', 2);30 31 // Assert that a given directory is empty...32 Storage::disk('photos')->assertDirectoryEmpty('/wallpapers');33 }34}
默认情况下,fake
方法将删除其临时目录中的所有文件。如果您想保留这些文件,可以使用 “persistentFake” 方法代替。有关测试文件上传的更多信息,您可以查阅 HTTP 测试文档中关于文件上传的信息。
image
方法需要 GD 扩展。
自定义文件系统
Laravel 的 Flysystem 集成开箱即用地为多种“驱动程序”提供了支持;但是,Flysystem 不仅限于这些,并且还具有许多其他存储系统的适配器。如果您想在 Laravel 应用程序中使用这些额外的适配器之一,则可以创建自定义驱动程序。
为了定义自定义文件系统,您将需要一个 Flysystem 适配器。让我们将社区维护的 Dropbox 适配器添加到我们的项目中
1composer require spatie/flysystem-dropbox
接下来,您可以在应用程序的 服务提供程序 之一的 boot
方法中注册驱动程序。为了实现这一点,您应该使用 Storage
facade 的 extend
方法
1<?php 2 3namespace App\Providers; 4 5use Illuminate\Contracts\Foundation\Application; 6use Illuminate\Filesystem\FilesystemAdapter; 7use Illuminate\Support\Facades\Storage; 8use Illuminate\Support\ServiceProvider; 9use League\Flysystem\Filesystem;10use Spatie\Dropbox\Client as DropboxClient;11use Spatie\FlysystemDropbox\DropboxAdapter;12 13class AppServiceProvider extends ServiceProvider14{15 /**16 * Register any application services.17 */18 public function register(): void19 {20 // ...21 }22 23 /**24 * Bootstrap any application services.25 */26 public function boot(): void27 {28 Storage::extend('dropbox', function (Application $app, array $config) {29 $adapter = new DropboxAdapter(new DropboxClient(30 $config['authorization_token']31 ));32 33 return new FilesystemAdapter(34 new Filesystem($adapter, $config),35 $adapter,36 $config37 );38 });39 }40}
extend
方法的第一个参数是驱动程序的名称,第二个参数是一个闭包,它接收 $app
和 $config
变量。闭包必须返回 Illuminate\Filesystem\FilesystemAdapter
的实例。$config
变量包含在 config/filesystems.php
中为指定磁盘定义的值。
创建并注册扩展的服务提供程序后,您可以在 config/filesystems.php
配置文件中使用 dropbox
驱动程序。