PHP library that provides a filesystem abstraction layer

Installs: 29 724 092

Dependents: 138

Suggesters: 18

Security: 0

Stars: 2 467

Watchers: 74

Forks: 354

Open Issues: 87

v0.11.1 2022-11-03 17:26 UTC


Stand With Ukraine

Gaufrette provides a filesystem abstraction layer.

Build Status Quality Score Packagist Version Total Downloads Software License Join the chat at Gitter

Why use Gaufrette?

Imagine you have to manage a lot of media in a PHP project. Let's see how to take this situation to your advantage using Gaufrette.

The filesystem abstraction layer permits you to develop your application without the need to know where all those media will be stored and how.

Another advantage of this is the possibility to update the location of the files without any impact on the code apart from the definition of your filesystem. In example, if your project grows up very fast and if your server reaches its limits, you can easily move your medias in an Amazon S3 server or any other solution.


Read the official Gaufrette documentation.

Metapackages for adapters

Every maintained adapter now has a dedicated metapackage. You can find the list on packagist. We highly recommend you to use them as they contain their own requirements: you don't need to worry about third-party dependencies to install before using Gaufrette anymore.

Symfony integration

Symfony integration is available through KnpLabs/KnpGaufretteBundle.


Here is the list of the dedicated maintainer(s) for every adapter not deprecated. If you don't receive any response to your issue or pull request in a timely manner, ping us:

Adapter Referent
AsyncAws S3 @Nyholm
AwsS3 @NiR-
AzureBlobStorage @NiR-
DoctrineDbal @pedrotroller, @NicolasNSSM
Flysystem @nicolasmure
Ftp @fabschurt
GoogleCloudStorage @AntoineLelaisant
GridFS @NiR-
OpenCloud @NiR-
PhpseclibSftp @fabschurt

For InMemory, Local, and Zip adapters everyone in this list is considered as a maintainer.


Requires :

  • docker-ce
  • docker-compose
  1. Create .env file :
$ make

and configure it as you want.

  1. Build the PHP docker image :
$ make
  1. Install dependencies :
$ make docker.all-deps
  1. Run tests :
$ make docker.tests

You can also use a different php version, simply set the PHP_VERSION env var to any of these values when calling a make target :

See the docker-compose.yml file for more details.

You'll need to clear the previously installed dependencies when switching from one version to an other. To do so, run :

$ make clear-deps
$ PHP_VERSION=<the_version_you_want_to_use> make build install-deps
  1. Apply Coding Standards

You should check for CS violations by using

$ make php-cs-compare

and fix them with

$ make php-cs-fix


This project does not have any stable release yet but we do not want to break BC now.