PHPackages                             gs\_fork\_knplabs/gaufrette - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. gs\_fork\_knplabs/gaufrette

ActiveLibrary[File &amp; Storage](/categories/file-storage)

gs\_fork\_knplabs/gaufrette
===========================

PHP library that provides a filesystem abstraction layer

v0.5.0(8y ago)027MITPHPPHP &gt;=5.6

Since Apr 15Pushed 8y ago1 watchersCompare

[ Source](https://github.com/gregsparrow/Gaufrette)[ Packagist](https://packagist.org/packages/gs_fork_knplabs/gaufrette)[ Docs](http://knplabs.com)[ RSS](/packages/gs-fork-knplabs-gaufrette/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (15)Versions (24)Used By (0)

Gaufrette
=========

[](#gaufrette)

Gaufrette provides a filesystem abstraction layer.

[![Build Status](https://camo.githubusercontent.com/b52d1896ecf9bccd0b518c25e463b2d92ca1657d73207639c758f2d0554a1054/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f4b6e704c6162732f4761756672657474652f6d61737465722e7376673f7374796c653d666c61742d737175617265)](http://travis-ci.org/KnpLabs/Gaufrette)[![AppVeyor Status](https://camo.githubusercontent.com/2000d76203f8059c75986f77067a473f2b6af4ce66f1f7672d05f48b88f743d0/68747470733a2f2f696d672e736869656c64732e696f2f6170707665796f722f63692f4e69522d2f4761756672657474652f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://ci.appveyor.com/project/NiR-/gaufrette)[![Quality Score](https://camo.githubusercontent.com/d33e40c025ae07748dd0c1f46f11636d0170ff4448f834cdf69946c313656da6/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f4b6e704c6162732f4761756672657474652e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/KnpLabs/Gaufrette)[![Packagist Version](https://camo.githubusercontent.com/a1fb15b95155eb974cfae4681242d4c90c564b6f6e6037e4019aef6d3ad56ab5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4b6e704c6162732f4761756672657474652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/KnpLabs/Gaufrette)[![Total Downloads](https://camo.githubusercontent.com/d07e309f93e24f89ee0d80fed8f58f6f5a95b22a8e35165ad355127cf27af557/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f4b6e704c6162732f4761756672657474652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/KnpLabs/Gaufrette)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Join the chat at Gitter](https://camo.githubusercontent.com/f8d9da96490aa57d7276be058339575d9a02990b35c7533dec59a33405fa79dc/68747470733a2f2f696d672e736869656c64732e696f2f6769747465722f726f6f6d2f6e776a732f6e772e6a732e7376673f7374796c653d666c61742d737175617265)](https://gitter.im/KnpLabs/Gaufrette)

Why use Gaufrette?
------------------

[](#why-use-gaufrette)

Imagine you have to manage a lot of medias in a PHP project. Lets see how to take this situation in your advantage using Gaufrette.

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

Another advantage of this is the possibility to update the files location 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.

### Documentation

[](#documentation)

Read the official [Gaufrette documentation](http://knplabs.github.io/Gaufrette/).

### Metapackages for adapters

[](#metapackages-for-adapters)

Every maintained adapter now have a dedicated metapackage. You can [find the list on packagist](https://packagist.org/packages/gaufrette/). **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)

Symfony integration is available through [KnpLabs/KnpGaufretteBundle](https://github.com/KnpLabs/KnpGaufretteBundle).

### Maintainers

[](#maintainers)

Here is the list of 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:

AdapterReferentAwsS3@NiR-AzureBlobStorage@NiR-DoctrineDbal@pedrotroller, @NicolasNSSMFlysystem@nicolasmureFtp@fabschurtGoogleCloudStorage@AntoineLelaisantGridFS@NiR-InMemoryLocalOpenCloud@NiR-PhpseclibSftp@fabschurtZipFor `InMemory`, `Local` and `Zip` adapters everyone in this list is considered as a maintainer.

### Launch the Test Suite

[](#launch-the-test-suite)

Requires:

- docker
- docker-compose

Build images:

```
$ docker-compose build

```

Launch the tests:

```
$ bin/tests-all

```

Is it green?

### Note

[](#note)

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

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~132 days

Recently: every ~85 days

Total

17

Last Release

3013d ago

Major Versions

v0.5.0 → 1.x-dev2018-02-08

PHP version history (5 changes)v0.1PHP &gt;=5.3.0

v0.1.4PHP &gt;=5.3.2

v0.3PHP &gt;=5.4

v0.4.0PHP &gt;=5.6

1.x-devPHP &gt;=7.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1705888?v=4)[Aleksandr Kalugin](/maintainers/gregsparrow)[@gregsparrow](https://github.com/gregsparrow)

---

Top Contributors

[![Herzult](https://avatars.githubusercontent.com/u/177588?v=4)](https://github.com/Herzult "Herzult (166 commits)")[![l3l0](https://avatars.githubusercontent.com/u/209405?v=4)](https://github.com/l3l0 "l3l0 (149 commits)")[![akovalyov](https://avatars.githubusercontent.com/u/2339101?v=4)](https://github.com/akovalyov "akovalyov (44 commits)")[![umpirsky](https://avatars.githubusercontent.com/u/208957?v=4)](https://github.com/umpirsky "umpirsky (43 commits)")[![mtarvainen](https://avatars.githubusercontent.com/u/813675?v=4)](https://github.com/mtarvainen "mtarvainen (20 commits)")[![nicolasmure](https://avatars.githubusercontent.com/u/4362252?v=4)](https://github.com/nicolasmure "nicolasmure (16 commits)")[![cdfre](https://avatars.githubusercontent.com/u/1069129?v=4)](https://github.com/cdfre "cdfre (15 commits)")[![woodsae](https://avatars.githubusercontent.com/u/26761?v=4)](https://github.com/woodsae "woodsae (9 commits)")[![Richtermeister](https://avatars.githubusercontent.com/u/624921?v=4)](https://github.com/Richtermeister "Richtermeister (8 commits)")[![Baachi](https://avatars.githubusercontent.com/u/833645?v=4)](https://github.com/Baachi "Baachi (8 commits)")[![hason](https://avatars.githubusercontent.com/u/288535?v=4)](https://github.com/hason "hason (7 commits)")[![qpleple](https://avatars.githubusercontent.com/u/774546?v=4)](https://github.com/qpleple "qpleple (7 commits)")[![wysow](https://avatars.githubusercontent.com/u/632747?v=4)](https://github.com/wysow "wysow (7 commits)")[![pawski](https://avatars.githubusercontent.com/u/4613458?v=4)](https://github.com/pawski "pawski (6 commits)")[![MAXakaWIZARD](https://avatars.githubusercontent.com/u/1138453?v=4)](https://github.com/MAXakaWIZARD "MAXakaWIZARD (5 commits)")[![ddeboer](https://avatars.githubusercontent.com/u/89267?v=4)](https://github.com/ddeboer "ddeboer (5 commits)")[![schmittjoh](https://avatars.githubusercontent.com/u/197017?v=4)](https://github.com/schmittjoh "schmittjoh (5 commits)")[![stloyd](https://avatars.githubusercontent.com/u/67402?v=4)](https://github.com/stloyd "stloyd (5 commits)")[![afitzke](https://avatars.githubusercontent.com/u/1736596?v=4)](https://github.com/afitzke "afitzke (4 commits)")[![stof](https://avatars.githubusercontent.com/u/439401?v=4)](https://github.com/stof "stof (4 commits)")

---

Tags

filesystemabstractionfilemedia

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/gs-fork-knplabs-gaufrette/health.svg)

```
[![Health](https://phpackages.com/badges/gs-fork-knplabs-gaufrette/health.svg)](https://phpackages.com/packages/gs-fork-knplabs-gaufrette)
```

###  Alternatives

[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.8M123](/packages/knplabs-gaufrette)[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.1k](/packages/league-flysystem)[knplabs/knp-gaufrette-bundle

Allows to easily use the Gaufrette library in a Symfony project

72528.6M91](/packages/knplabs-knp-gaufrette-bundle)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M788](/packages/league-flysystem-aws-s3-v3)[league/flysystem-local

Local filesystem adapter for Flysystem.

226231.8M39](/packages/league-flysystem-local)[league/flysystem-memory

In-memory filesystem adapter for Flysystem.

8533.6M194](/packages/league-flysystem-memory)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
