在构建一个需要处理大量文件的应用程序时，我遇到了一个问题：我的文件存储在不同的地方，包括本地磁盘、Amazon S3 等。我需要一种统一的方式来访问这些文件，而不需要关心它们实际存储在哪里。这时，我发现了 Gaufrette Extras，它为 Gaufrette 文件系统提供了额外的功能，例如可解析的文件系统。
gaufrette 是一个 php 文件系统抽象层，它允许你使用相同的 api 来访问不同的文件存储服务。而 gaufrette extras 则在 gaufrette 的基础上，提供了更多实用的功能，例如 resolvablefilesystem。
ResolvableFilesystem：让文件路径变成可访问的 URL
ResolvableFilesystem 是一个装饰器，它可以将文件路径解析成 URL。这对于需要在 Web 应用中展示存储在云存储服务上的文件非常有用。
安装 Gaufrette Extras
使用 Composer 安装 Gaufrette Extras 非常简单：
composer require gaufrette/extras
使用 ResolvableFilesystem
要使用 ResolvableFilesystem，你需要先创建一个 Gaufrette 文件系统，然后将其传递给 ResolvableFilesystem 装饰器，同时还需要提供一个 Resolver。Resolver 负责将文件路径解析成 URL。
以下是一个使用 Amazon S3 和 AwsS3PresignedUrlResolver 的例子：
use Gaufrette\Filesystem;
use Gaufrette\Adapter\AwsS3;
use Gaufrette\Extras\Resolvable\ResolvableFilesystem;
use Gaufrette\Extras\Resolvable\Resolver\AwsS3PresignedUrlResolver;
use Aws\S3\S3Client;
// 1. 创建 Aws\S3\S3Client 实例
$client = new S3Client([
'version' => 'latest',
'region' => 'your-aws-region',
'credentials' => [
'key' => 'your-aws-access-key',
'secret' => 'your-aws-secret-key',
],
]);
// 2. 创建 Gaufrette\Adapter\AwsS3 实例
$adapter = new AwsS3($client, 'your-s3-bucket', ['directory' => 'your-s3-directory']);
// 3. 创建 Gaufrette\Filesystem 实例
$decorated = new Filesystem($adapter);
// 4. 创建 AwsS3PresignedUrlResolver 实例
$resolver = new AwsS3PresignedUrlResolver($client, 'your-s3-bucket', 'your-s3-directory', new \DateTime('+ 1 hour'));
// 5. 创建 ResolvableFilesystem 实例
$filesystem = new ResolvableFilesystem($decorated, $resolver);
// 6. 解析文件路径
$url = $filesystem->resolve('/foo.png');
echo $url; // 输出类似：https://your-s3-bucket.s3.amazonaws.com/your-s3-directory/foo.png?AWSAccessKeyId=...&Expires=...&Signature=...在这个例子中，我们首先创建了一个 AwsS3 适配器，然后使用它创建了一个 Filesystem 实例。接着，我们创建了一个 AwsS3PresignedUrlResolver，它使用 AWS S3 客户端生成一个预签名 URL，该 URL 允许我们在一段时间内访问 S3 上的文件。最后，我们使用 ResolvableFilesystem 将文件路径 /foo.png 解析成一个预签名 URL。
Gaufrette Extras 的优势
- 统一的文件访问方式： 无论文件存储在哪里，都可以使用相同的 API 来访问它们。
-
简化 URL 生成：
ResolvableFilesystem可以方便地将文件路径解析成 URL，无需手动构建 URL。 - 支持多种云存储服务： Gaufrette 提供了对多种云存储服务的支持，例如 Amazon S3、Google Cloud Storage 等。
通过使用 Gaufrette Extras，我能够以一种统一、高效的方式访问存储在不同地方的文件，极大地简化了我的应用程序的开发和维护。如果你也面临类似的问题，不妨尝试一下 Gaufrette Extras，相信它会给你带来惊喜。
Composer在线学习地址：学习地址
