文件存储

• 介绍
• 配置
  • 本地驱动程序
  • 公共磁盘
  • 驱动程序先决条件
  • 作用域和只读文件系统
  • 与 Amazon S3 兼容的文件系统
• 获取磁盘实例
  • 按需磁盘
• 检索文件
  • 下载文件
  • 文件 URL
  • 临时 URL
  • 文件元数据
• 存储文件
  • 在文件开头和结尾添加内容
  • 复制和移动文件
  • 自动流式传输
  • 文件上传
  • 文件可见性
• 删除文件
• 目录
• 测试
• 自定义文件系统

介绍

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 目录。因此，以下方法将写入 storage/app/example.txt

use Illuminate\Support\Facades\Storage;
 
Storage::disk('local')->put('example.txt', 'Contents');

公共磁盘

应用程序的 filesystems 配置文件中包含的 public 磁盘用于将公开访问的文件。默认情况下，public 磁盘使用 local 驱动程序并将文件存储在 storage/app/public 中。

要从 Web 访问这些文件，你应该从 public/storage 到 storage/app/public 创建一个符号链接。使用此文件夹约定将使你能够将公开访问的文件保留在一个目录中，该目录可以在使用 Envoyer 等零停机时间部署系统时轻松地在部署之间共享。

要创建符号链接，可以使用 storage:link Artisan 命令

php artisan storage:link

存储文件并创建符号链接后，你可以使用 asset 助手创建指向文件的 URL

echo asset('storage/file.txt');

可以在 filesystems 配置文件中配置额外的符号链接。运行 storage:link 命令时将创建每个配置的链接

'links' => [
    public_path('storage') => storage_path('app/public'),
    public_path('images') => storage_path('app/images'),
],

storage:unlink 命令可用于删除你配置的符号链接

php artisan storage:unlink

驱动程序先决条件

S3 驱动程序配置

在使用 S3 驱动程序之前，你需要通过 Composer 包管理器安装 Flysystem S3 包

composer require league/flysystem-aws-s3-v3 "^3.0" --with-all-dependencies

你的 config/filesystems.php 配置文件中包含一个 S3 磁盘配置数组。通常，你应该使用以下环境变量配置你的 S3 信息和凭据，这些环境变量由 config/filesystems.php 配置文件引用

AWS_ACCESS_KEY_ID=<your-key-id>
AWS_SECRET_ACCESS_KEY=<your-secret-access-key>
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=<your-bucket-name>
AWS_USE_PATH_STYLE_ENDPOINT=false

为了方便起见，这些环境变量与 AWS CLI 使用的命名约定相匹配。

FTP 驱动程序配置

在使用 FTP 驱动程序之前，你需要通过 Composer 包管理器安装 Flysystem FTP 包

composer require league/flysystem-ftp "^3.0"

Laravel 的 Flysystem 集成非常适合与 FTP 配合使用；但是，框架的默认 config/filesystems.php 配置文件中未包含示例配置。如果你需要配置 FTP 文件系统，可以使用以下配置示例

'ftp' => [
    'driver' => 'ftp',
    'host' => env('FTP_HOST'),
    'username' => env('FTP_USERNAME'),
    'password' => env('FTP_PASSWORD'),
 
    // Optional FTP Settings...
    // 'port' => env('FTP_PORT', 21),
    // 'root' => env('FTP_ROOT'),
    // 'passive' => true,
    // 'ssl' => true,
    // 'timeout' => 30,
],

SFTP 驱动程序配置

在使用 SFTP 驱动程序之前，你需要通过 Composer 包管理器安装 Flysystem SFTP 包

composer require league/flysystem-sftp-v3 "^3.0"

Laravel 的 Flysystem 集成非常适合与 SFTP 配合使用；但是，框架的默认 config/filesystems.php 配置文件中未包含示例配置。如果你需要配置 SFTP 文件系统，可以使用以下配置示例

'sftp' => [
    'driver' => 'sftp',
    'host' => env('SFTP_HOST'),
 
    // Settings for basic authentication...
    'username' => env('SFTP_USERNAME'),
    'password' => env('SFTP_PASSWORD'),
 
    // Settings for SSH key based authentication with encryption password...
    'privateKey' => env('SFTP_PRIVATE_KEY'),
    'passphrase' => env('SFTP_PASSPHRASE'),
 
    // Settings for file / directory permissions...
    'visibility' => 'private', // `private` = 0600, `public` = 0644
    'directory_visibility' => 'private', // `private` = 0700, `public` = 0755
 
    // Optional SFTP Settings...
    // 'hostFingerprint' => env('SFTP_HOST_FINGERPRINT'),
    // 'maxTries' => 4,
    // 'passphrase' => env('SFTP_PASSPHRASE'),
    // 'port' => env('SFTP_PORT', 22),
    // 'root' => env('SFTP_ROOT', ''),
    // 'timeout' => 30,
    // 'useAgent' => true,
],

作用域和只读文件系统

作用域磁盘允许你定义一个文件系统，其中所有路径都会自动以给定的路径前缀为前缀。在创建作用域文件系统磁盘之前，你需要通过 Composer 包管理器安装额外的 Flysystem 包

composer require league/flysystem-path-prefixing "^3.0"

你可以通过定义一个使用 scoped 驱动程序的磁盘来创建任何现有文件系统磁盘的作用域实例。例如，你可以创建一个将现有 s3 磁盘的作用域限定为特定路径前缀的磁盘，然后使用作用域磁盘执行的每个文件操作都将使用指定的路径前缀

's3-videos' => [
    'driver' => 'scoped',
    'disk' => 's3',
    'prefix' => 'path/to/videos',
],

“只读”磁盘允许你创建不允许写入操作的文件系统磁盘。在使用 read-only 配置选项之前，你需要通过 Composer 包管理器安装额外的 Flysystem 包

composer require league/flysystem-read-only "^3.0"

接下来，可以在一个或多个磁盘配置数组中包含 read-only 配置选项

's3-videos' => [
    'driver' => 's3',
    // ...
    'read-only' => true,
],

与 Amazon S3 兼容的文件系统

默认情况下，应用程序的 filesystems 配置文件中包含 s3 磁盘的磁盘配置。除了使用此磁盘与 Amazon S3 交互外，还可以使用它与任何与 S3 兼容的文件存储服务交互，例如 MinIO 或 DigitalOcean Spaces.

通常，在更新磁盘的凭据以匹配你计划使用的服务的凭据后，只需要更新 endpoint 配置选项的值。此选项的值通常通过 AWS_ENDPOINT 环境变量定义

'endpoint' => env('AWS_ENDPOINT', 'https://minio:9000'),

MinIO

为了使 Laravel 的 Flysystem 集成在使用 MinIO 时生成正确的 URL，你应该定义 AWS_URL 环境变量，使其与应用程序的本地 URL 相匹配，并在 URL 路径中包含桶名称

AWS_URL=https://127.0.0.1:9000/local

获取磁盘实例

Storage 门面可用于与任何配置的磁盘进行交互。例如，可以使用门面上的 put 方法将头像存储在默认磁盘上。如果你在未先调用 disk 方法的情况下调用 Storage 门面上的方法，该方法将自动传递给默认磁盘

use Illuminate\Support\Facades\Storage;
 
Storage::put('avatars/1', $content);

如果应用程序与多个磁盘进行交互，可以使用 Storage 门面上的 disk 方法来处理特定磁盘上的文件

Storage::disk('s3')->put('avatars/1', $content);

按需磁盘

有时你可能希望在运行时使用给定的配置创建磁盘，而该配置实际上不存在于应用程序的 filesystems 配置文件中。要实现这一点，可以将配置数组传递给 Storage 门面的 build 方法

use Illuminate\Support\Facades\Storage;
 
$disk = Storage::build([
    'driver' => 'local',
    'root' => '/path/to/root',
]);
 
$disk->put('image.jpg', $content);

检索文件

get 方法可用于检索文件内容。该方法将返回文件的原始字符串内容。请记住，所有文件路径应相对于磁盘的“根”位置指定

$contents = Storage::get('file.jpg');

如果您要检索的文件包含 JSON，则可以使用 json 方法检索文件并对其内容进行解码

$orders = Storage::json('orders.json');

exists 方法可用于确定磁盘上是否存在文件

if (Storage::disk('s3')->exists('file.jpg')) {
    // ...
}

missing 方法可用于确定磁盘上是否缺少文件

if (Storage::disk('s3')->missing('file.jpg')) {
    // ...
}

下载文件

download 方法可用于生成一个响应，强制用户的浏览器下载给定路径下的文件。download 方法接受文件名作为方法的第二个参数，该参数将决定用户下载文件时看到的文件名。最后，您可以将 HTTP 标头的数组作为方法的第三个参数传递

return Storage::download('file.jpg');
 
return Storage::download('file.jpg', $name, $headers);

文件 URL

您可以使用 url 方法获取给定文件的 URL。如果您使用的是 local 驱动程序，这通常只是将 /storage 添加到给定路径前面并返回到文件的相对 URL。如果您使用的是 s3 驱动程序，则将返回完全限定的远程 URL

use Illuminate\Support\Facades\Storage;
 
$url = Storage::url('file.jpg');

使用 local 驱动程序时，所有应公开访问的文件都应放置在 storage/app/public 目录中。此外，您应该 创建一个指向 storage/app/public 目录的符号链接，该链接位于 public/storage 中。

URL 主机自定义

如果您想修改使用 Storage 门面生成的 URL 的主机，可以在磁盘的配置数组中添加或更改 url 选项

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
    'throw' => false,
],

临时 URL

使用 temporaryUrl 方法，您可以为使用 local 和 s3 驱动程序存储的文件创建临时 URL。此方法接受一个路径和一个 DateTime 实例，该实例指定 URL 应在何时过期

use Illuminate\Support\Facades\Storage;
 
$url = Storage::temporaryUrl(
    'file.jpg', now()->addMinutes(5)
);

启用本地临时 URL

如果您在向 local 驱动程序引入对临时 URL 的支持之前就开始开发应用程序，则可能需要启用本地临时 URL。为此，请在 config/filesystems.php 配置文件中的 local 磁盘的配置数组中添加 serve 选项

'local' => [
    'driver' => 'local',
    'root' => storage_path('app/private'),
    'serve' => true, 
    'throw' => false,
],

S3 请求参数

如果您需要指定其他 S3 请求参数，您可以将请求参数的数组作为 temporaryUrl 方法的第三个参数传递

$url = Storage::temporaryUrl(
    'file.jpg',
    now()->addMinutes(5),
    [
        'ResponseContentType' => 'application/octet-stream',
        'ResponseContentDisposition' => 'attachment; filename=file2.jpg',
    ]
);

自定义临时 URL

如果您需要自定义为特定存储磁盘创建临时 URL 的方式，可以使用 buildTemporaryUrlsUsing 方法。例如，如果您有一个控制器允许您下载通过不支持临时 URL 的磁盘存储的文件，这将很有用。通常，此方法应从服务提供者的 boot 方法调用

<?php
 
namespace App\Providers;
 
use DateTime;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\URL;
use Illuminate\Support\ServiceProvider;
 
class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        Storage::disk('local')->buildTemporaryUrlsUsing(
            function (string $path, DateTime $expiration, array $options) {
                return URL::temporarySignedRoute(
                    'files.download',
                    $expiration,
                    array_merge($options, ['path' => $path])
                );
            }
        );
    }
}

临时上传 URL

如果您需要生成一个可以用于直接从您的客户端应用程序上传文件的临时 URL，可以使用 temporaryUploadUrl 方法。此方法接受一个路径和一个 DateTime 实例，该实例指定 URL 应在何时过期。temporaryUploadUrl 方法返回一个关联数组，该数组可以解构为上传 URL 和应包含在上传请求中的标头

use Illuminate\Support\Facades\Storage;
 
['url' => $url, 'headers' => $headers] = Storage::temporaryUploadUrl(
    'file.jpg', now()->addMinutes(5)
);

此方法主要在需要客户端应用程序直接将文件上传到云存储系统（如 Amazon S3）的无服务器环境中很有用。

文件元数据

除了读取和写入文件外，Laravel 还可以提供有关文件本身的信息。例如，size 方法可用于获取文件的字节大小

use Illuminate\Support\Facades\Storage;
 
$size = Storage::size('file.jpg');

lastModified 方法返回文件上次修改的 UNIX 时间戳

$time = Storage::lastModified('file.jpg');

可以通过 mimeType 方法获取给定文件的 MIME 类型

$mime = Storage::mimeType('file.jpg');

文件路径

您可以使用 path 方法获取给定文件的路径。如果您使用的是 local 驱动程序，这将返回文件的绝对路径。如果您使用的是 s3 驱动程序，此方法将返回 S3 存储桶中文件的相对路径

use Illuminate\Support\Facades\Storage;
 
$path = Storage::path('file.jpg');

存储文件

put 方法可用于将文件内容存储在磁盘上。您也可以将 PHP resource 传递给 put 方法，它将使用 Flysystem 的底层流支持。请记住，所有文件路径应相对于为磁盘配置的“根”位置指定

use Illuminate\Support\Facades\Storage;
 
Storage::put('file.jpg', $contents);
 
Storage::put('file.jpg', $resource);

写入失败

如果 put 方法（或其他“写入”操作）无法将文件写入磁盘，则将返回 false

if (! Storage::put('file.jpg', $contents)) {
    // The file could not be written to disk...
}

如果您愿意，可以在文件系统磁盘的配置数组中定义 throw 选项。当此选项定义为 true 时，“写入”方法（如 put）在写入操作失败时将抛出一个 League\Flysystem\UnableToWriteFile 实例

'public' => [
    'driver' => 'local',
    // ...
    'throw' => true,
],

在文件开头和结尾添加内容

prepend 和 append 方法允许您写入文件的开头或结尾

Storage::prepend('file.log', 'Prepended Text');
 
Storage::append('file.log', 'Appended Text');

复制和移动文件

copy 方法可用于将现有文件复制到磁盘上的新位置，而 move 方法可用于将现有文件重命名或移动到新位置

Storage::copy('old/file.jpg', 'new/file.jpg');
 
Storage::move('old/file.jpg', 'new/file.jpg');

自动流式传输

将文件流式传输到存储可以显着减少内存使用量。如果您希望 Laravel 自动管理将给定文件流式传输到您的存储位置，可以使用 putFile 或 putFileAs 方法。此方法接受一个 Illuminate\Http\File 或 Illuminate\Http\UploadedFile 实例，并将自动将文件流式传输到您想要的位置

use Illuminate\Http\File;
use Illuminate\Support\Facades\Storage;
 
// Automatically generate a unique ID for filename...
$path = Storage::putFile('photos', new File('/path/to/photo'));
 
// Manually specify a filename...
$path = Storage::putFileAs('photos', new File('/path/to/photo'), 'photo.jpg');

关于 putFile 方法需要注意一些重要事项。请注意，我们只指定了一个目录名称，而不是文件名。默认情况下，putFile 方法将生成一个唯一的 ID 作为文件名。文件的扩展名将通过检查文件的 MIME 类型来确定。putFile 方法将返回文件的路径，以便您可以将路径（包括生成的文件名）存储在数据库中。

putFile 和 putFileAs 方法也接受一个参数来指定存储文件的“可见性”。如果您将文件存储在云磁盘（如 Amazon S3）上，并且希望文件可以通过生成的 URL 公开访问，这将特别有用

Storage::putFile('photos', new File('/path/to/photo'), 'public');

文件上传

在 Web 应用程序中，存储文件的最常见用例之一是存储用户上传的文件，例如照片和文档。Laravel 使使用上传文件实例的 store 方法存储上传文件变得非常容易。使用您要存储上传文件的路径调用 store 方法

<?php
 
namespace App\Http\Controllers;
 
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
 
class UserAvatarController extends Controller
{
    /**
     * Update the avatar for the user.
     */
    public function update(Request $request): string
    {
        $path = $request->file('avatar')->store('avatars');
 
        return $path;
    }
}

关于此示例需要注意一些重要事项。请注意，我们只指定了一个目录名称，而不是文件名。默认情况下，store 方法将生成一个唯一的 ID 作为文件名。文件的扩展名将通过检查文件的 MIME 类型来确定。store 方法将返回文件的路径，以便您可以将路径（包括生成的文件名）存储在数据库中。

您也可以在 Storage 门面中调用 putFile 方法，以执行与上述示例相同的文件存储操作

$path = Storage::putFile('avatars', $request->file('avatar'));

指定文件名

如果您不希望为存储的文件自动分配文件名，可以使用 storeAs 方法，该方法接收路径、文件名和（可选）磁盘作为其参数

$path = $request->file('avatar')->storeAs(
    'avatars', $request->user()->id
);

您也可以在 Storage 门面中使用 putFileAs 方法，它将执行与上述示例相同的文件存储操作

$path = Storage::putFileAs(
    'avatars', $request->file('avatar'), $request->user()->id
);

指定磁盘

默认情况下，此上传文件的 store 方法将使用您的默认磁盘。如果您想指定另一个磁盘，请将磁盘名称作为 store 方法的第二个参数传递

$path = $request->file('avatar')->store(
    'avatars/'.$request->user()->id, 's3'
);

如果您使用的是 storeAs 方法，可以将磁盘名称作为方法的第三个参数传递

$path = $request->file('avatar')->storeAs(
    'avatars',
    $request->user()->id,
    's3'
);

其他上传文件信息

如果您想获取上传文件的原始名称和扩展名，可以使用 getClientOriginalName 和 getClientOriginalExtension 方法

$file = $request->file('avatar');
 
$name = $file->getClientOriginalName();
$extension = $file->getClientOriginalExtension();

但是，请记住，getClientOriginalName 和 getClientOriginalExtension 方法被认为是不安全的，因为文件名和扩展名可能会被恶意用户篡改。因此，您通常应该优先使用 hashName 和 extension 方法来获取给定文件上传的名称和扩展名

$file = $request->file('avatar');
 
$name = $file->hashName(); // Generate a unique, random name...
$extension = $file->extension(); // Determine the file's extension based on the file's MIME type...

文件可见性

在 Laravel 的 Flysystem 集成中，“可见性”是跨多个平台的文件权限的抽象。文件可以声明为 public 或 private。当文件声明为 public 时，您表示该文件通常应该对其他人可见。例如，使用 S3 驱动程序时，您可以检索 public 文件的 URL。

您可以在使用 put 方法写入文件时设置可见性

use Illuminate\Support\Facades\Storage;
 
Storage::put('file.jpg', $contents, 'public');

如果文件已经存储，可以使用 getVisibility 和 setVisibility 方法检索和设置其可见性

$visibility = Storage::getVisibility('file.jpg');
 
Storage::setVisibility('file.jpg', 'public');

与上传文件交互时，可以使用 storePublicly 和 storePubliclyAs 方法以 public 可见性存储上传的文件

$path = $request->file('avatar')->storePublicly('avatars', 's3');
 
$path = $request->file('avatar')->storePubliclyAs(
    'avatars',
    $request->user()->id,
    's3'
);

本地文件和可见性

使用 local 驱动程序时，public 可见性 转换为目录的 0755 权限和文件的 0644 权限。您可以在应用程序的 filesystems 配置文件中修改权限映射

'local' => [
    'driver' => 'local',
    'root' => storage_path('app'),
    'permissions' => [
        'file' => [
            'public' => 0644,
            'private' => 0600,
        ],
        'dir' => [
            'public' => 0755,
            'private' => 0700,
        ],
    ],
    'throw' => false,
],

删除文件

delete 方法接受单个文件名或要删除的文件数组

use Illuminate\Support\Facades\Storage;
 
Storage::delete('file.jpg');
 
Storage::delete(['file.jpg', 'file2.jpg']);

如果需要，可以指定要从中删除文件的磁盘

use Illuminate\Support\Facades\Storage;
 
Storage::disk('s3')->delete('path/file.jpg');

目录

获取目录中的所有文件

files 方法返回给定目录中所有文件的数组。如果您想检索给定目录中包含所有子目录的所有文件的列表，可以使用 allFiles 方法

use Illuminate\Support\Facades\Storage;
 
$files = Storage::files($directory);
 
$files = Storage::allFiles($directory);

获取目录中的所有目录

directories 方法返回给定目录中所有目录的数组。此外，可以使用 allDirectories 方法获取给定目录及其所有子目录中的所有目录列表

$directories = Storage::directories($directory);
 
$directories = Storage::allDirectories($directory);

创建目录

makeDirectory 方法将创建给定目录，包括任何需要的子目录

Storage::makeDirectory($directory);

删除目录

最后，deleteDirectory 方法可用于删除目录及其所有文件

Storage::deleteDirectory($directory);

测试

Storage 门面的 fake 方法允许您轻松生成一个虚假磁盘，该磁盘与 Illuminate\Http\UploadedFile 类的文件生成实用程序相结合，可以极大地简化文件上传的测试。例如

<?php
 
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
 
test('albums can be uploaded', function () {
    Storage::fake('photos');
 
    $response = $this->json('POST', '/photos', [
        UploadedFile::fake()->image('photo1.jpg'),
        UploadedFile::fake()->image('photo2.jpg')
    ]);
 
    // Assert one or more files were stored...
    Storage::disk('photos')->assertExists('photo1.jpg');
    Storage::disk('photos')->assertExists(['photo1.jpg', 'photo2.jpg']);
 
    // Assert one or more files were not stored...
    Storage::disk('photos')->assertMissing('missing.jpg');
    Storage::disk('photos')->assertMissing(['missing.jpg', 'non-existing.jpg']);
 
    // Assert that a given directory is empty...
    Storage::disk('photos')->assertDirectoryEmpty('/wallpapers');
});

<?php
 
namespace Tests\Feature;
 
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
use Tests\TestCase;
 
class ExampleTest extends TestCase
{
    public function test_albums_can_be_uploaded(): void
    {
        Storage::fake('photos');
 
        $response = $this->json('POST', '/photos', [
            UploadedFile::fake()->image('photo1.jpg'),
            UploadedFile::fake()->image('photo2.jpg')
        ]);
 
        // Assert one or more files were stored...
        Storage::disk('photos')->assertExists('photo1.jpg');
        Storage::disk('photos')->assertExists(['photo1.jpg', 'photo2.jpg']);
 
        // Assert one or more files were not stored...
        Storage::disk('photos')->assertMissing('missing.jpg');
        Storage::disk('photos')->assertMissing(['missing.jpg', 'non-existing.jpg']);
 
        // Assert that a given directory is empty...
        Storage::disk('photos')->assertDirectoryEmpty('/wallpapers');
    }
}

默认情况下，fake 方法将删除其临时目录中的所有文件。如果您想保留这些文件，可以使用“persistentFake”方法。有关测试文件上传的更多信息，您可以参考 HTTP 测试文档中有关文件上传的信息。

自定义文件系统

Laravel 的 Flysystem 集成开箱即用地支持多种“驱动程序”；但是，Flysystem 不限于这些驱动程序，并且拥有适用于许多其他存储系统的适配器。如果要在 Laravel 应用程序中使用这些额外的适配器，可以创建自定义驱动程序。

要定义自定义文件系统，需要一个 Flysystem 适配器。让我们将一个社区维护的 Dropbox 适配器添加到我们的项目中。

composer require spatie/flysystem-dropbox

接下来，可以在应用程序的其中一个 服务提供者 的 boot 方法中注册驱动程序。为此，应使用 Storage 门面的 extend 方法。

<?php
 
namespace App\Providers;
 
use Illuminate\Contracts\Foundation\Application;
use Illuminate\Filesystem\FilesystemAdapter;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\ServiceProvider;
use League\Flysystem\Filesystem;
use Spatie\Dropbox\Client as DropboxClient;
use Spatie\FlysystemDropbox\DropboxAdapter;
 
class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     */
    public function register(): void
    {
        // ...
    }
 
    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        Storage::extend('dropbox', function (Application $app, array $config) {
            $adapter = new DropboxAdapter(new DropboxClient(
                $config['authorization_token']
            ));
 
            return new FilesystemAdapter(
                new Filesystem($adapter, $config),
                $adapter,
                $config
            );
        });
    }
}

extend 方法的第一个参数是驱动程序的名称，第二个参数是一个闭包，该闭包接收 $app 和 $config 变量。闭包必须返回一个 Illuminate\Filesystem\FilesystemAdapter 实例。$config 变量包含为指定磁盘在 config/filesystems.php 中定义的值。

创建并注册扩展的服务提供者后，可以在 config/filesystems.php 配置文件中使用 dropbox 驱动程序。