# KnpLabs/Gaufrette

PHP library that provides a filesystem abstraction layer − will be a feast for your files!

Repository: https://github.com/KnpLabs/Gaufrette
Canonical: https://ross.abutalabs.com/products/gaufrette
Homepage: http://knplabs.github.io/Gaufrette
Language: PHP
License: MIT
License Family: permissive
Topics: php, filesystem, gaufrette, hacktoberfest
Last push: 2026-07-22T20:52:59+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 62, longevity 100
- inputs: {"age_days": 5706, "days_push": 42, "days_rel": 42, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2464, forks 352 (observed 2026-08-28T04:06:53.599640+00:00)

## What it is
Gaufrette is a PHP library providing a filesystem abstraction layer, letting applications work with files without knowing where or how they are stored. It supports many adapters such as local disk, Amazon S3, Azure Blob Storage, FTP, and Google Cloud Storage, so storage backends can be swapped without code changes.

## Use cases
- abstract file storage in a PHP application
- switch file storage from local disk to Amazon S3 without changing code
- manage media uploads across multiple storage backends
- write code that is agnostic to the filesystem backend
- integrate file storage into Symfony via KnpGaufretteBundle

## When to choose
- you need storage-backend-agnostic file handling in PHP
- you anticipate migrating media between local and cloud storage
- you use Symfony and want a bundle-based filesystem abstraction

## When to avoid
- you are starting a new project where Flysystem is the modern standard
- you need only simple local file operations with no abstraction
- you require actively developed cutting-edge features

## Facets
- artifact type: library
- maturity: maintenance
- function: file-system
- domain: files, web-development, developer-tools
- platform: php
- tags: filesystem-abstraction, storage-adapters, amazon-s3, symfony

## Member repositories
- KnpLabs/Gaufrette (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:53.599640+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:29:15.539610+00:00, confidence not recorded.
  - readme: https://github.com/KnpLabs/Gaufrette (fetched 2026-08-28T04:06:53.599640+00:00, sha d03f347343e1)
  - homepage: http://knplabs.github.io/Gaufrette (fetched 2026-08-29T10:10:44.630288+00:00, sha d7fea35a049e)
- Data as of 2026-08-30T08:39:29.467469+00:00.