knplabs/gaufrette-extras

Provides extra features (prefixed fs, resolvable fs) to Gaufrette

v0.2.0 2026-07-20 14:14 UTC

Requires

• php: ^7.4 || ^8.0
• knplabs/gaufrette: ^0.11

Requires (Dev)

• aws/aws-sdk-php: ~2.4|~3
• phpspec/phpspec: ^7.0 || ^8.0
• phpunit/phpunit: ^9||^10||^11||^12||^13
• symfony/phpunit-bridge: ^5.4 || ^6.4 || ^7.0

MIT

• Albin Kerouanton
• KnpLabs Team
• The contributors

Published on Packagist.org on 2026-07-20 14:15 UTC

README

Provides extras functionality around Gaufrette like Resolvable filesystem.

Resolvable filesystem

ResolvableFilesystem is a decorator permitting to resolve objects paths into URLs.

In order to use it, you have to pass the decorated Filesystem and a Resolver:

$client     = // AwsS3 client instantiation
$decorated  = new Filesystem(new AwsS3($client, 'my_bucket', ['directory' => 'root/dir']));
$filesystem = new ResolvableFilesystem(
    $decorated,
    new AwsS3PresignedUrlResolver($client, 'my_bucket', 'root/dir', new \DateTime('+ 1 hour'))
);

Then you can call resolve($key):

$filesystem->resolve('/foo.png'); // = 'https://...

Currently these resolvers are supported:

• AwsS3PublicUrlResolver
• AwsS3PresignedUrlResolver
• StaticUrlResolver