PHPackages durimjusaj/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 & Storage](/categories/file-storage) 4. / 5. durimjusaj/gaufrette ActiveLibrary[File & Storage](/categories/file-storage) durimjusaj/gaufrette ==================== PHP library that provides a filesystem abstraction layer 1.1(1y ago)0351MITPHPPHP ^7.4 || ^8.0 Since Dec 3Pushed 2mo agoCompare [ Source](https://github.com/durimjusaj/Gaufrette)[ Packagist](https://packagist.org/packages/durimjusaj/gaufrette)[ Docs](http://knplabs.com)[ RSS](/packages/durimjusaj-gaufrette/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (5)Versions (4)Used By (1) Gaufrette ========= [](#gaufrette) [![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://stand-with-ukraine.pp.ua) Gaufrette provides a filesystem abstraction layer. [![Build Status](https://github.com/KnpLabs/Gaufrette/actions/workflows/ci.yml/badge.svg)](https://github.com/KnpLabs/Gaufrette/actions)[![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 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. ### Documentation [](#documentation) Read the official [Gaufrette documentation](http://knplabs.github.io/Gaufrette/). ### Metapackages for adapters [](#metapackages-for-adapters) Every maintained adapter now has 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 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: AdapterReferentAsyncAws S3@NyholmAwsS3@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. ### Development [](#development) Requires : - docker-ce - docker-compose 1. Create `.env` file : ``` $ make docker.dev ``` and configure it as you want. 2. Build the PHP docker image : ``` $ make docker.build ``` 3. Install dependencies : ``` $ make docker.all-deps ``` 4. 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 : - `7.1` - `7.2` (default) - `7.3` (The docker setup for PHP 7.3 is available. However, the ssh2 extension is not installed [as it is not available for PHP 7.3 yet](https://serverpilot.io/docs/how-to-install-the-php-ssh2-extension)) See the [`docker-compose.yml`](/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= make build install-deps ``` 5. Apply Coding Standards You should check for CS violations by using ``` $ make php-cs-compare ``` and fix them with ``` $ make php-cs-fix ``` ### Note [](#note) This project does not have any stable release yet but we do not want to break BC now. ### Health Score 36 — LowBetter than 81% of packages Maintenance69 Regular maintenance activity Popularity7 Limited adoption so far Community21 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor3 3 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 ~0 days Total 2 Last Release 522d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/baf26d07ee5daecb29763d555d01bdc63add51d5e82f053975a43e4b409d2d1d?d=identicon)[durimjusaj](/maintainers/durimjusaj) --- 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)")[![nicolasmure](https://avatars.githubusercontent.com/u/4362252?v=4)](https://github.com/nicolasmure "nicolasmure (61 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)")[![Nek-](https://avatars.githubusercontent.com/u/972456?v=4)](https://github.com/Nek- "Nek- (30 commits)")[![mtarvainen](https://avatars.githubusercontent.com/u/813675?v=4)](https://github.com/mtarvainen "mtarvainen (20 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)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (8 commits)")[![Baachi](https://avatars.githubusercontent.com/u/833645?v=4)](https://github.com/Baachi "Baachi (8 commits)")[![wysow](https://avatars.githubusercontent.com/u/632747?v=4)](https://github.com/wysow "wysow (7 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)")[![pawski](https://avatars.githubusercontent.com/u/4613458?v=4)](https://github.com/pawski "pawski (6 commits)")[![nm2107](https://avatars.githubusercontent.com/u/54795627?v=4)](https://github.com/nm2107 "nm2107 (5 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)") --- Tags filesystemabstractionfilemedia ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/durimjusaj-gaufrette/health.svg) ``` [![Health](https://phpackages.com/badges/durimjusaj-gaufrette/health.svg)](https://phpackages.com/packages/durimjusaj-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)