PHPackages                             php-collective/file-storage - 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. php-collective/file-storage

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

php-collective/file-storage
===========================

File Storage

1.0.0(6mo ago)08.1k—8.3%2[1 issues](https://github.com/php-collective/file-storage/issues)2MITPHPPHP >=8.1CI passing

Since Nov 6Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/php-collective/file-storage)[ Packagist](https://packagist.org/packages/php-collective/file-storage)[ RSS](/packages/php-collective-file-storage/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (3)Used By (2)

File Storage
============

[](#file-storage)

[![CI](https://github.com/php-collective/file-storage/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/php-collective/file-storage/actions/workflows/ci.yml)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

A framework agnostic file storage system.

Dealing with uploads, storing and managing the files has been very often painful and cumbersome. This library tries to make this more easy and convenient for you - no matter what framework you are using.

This library is pretty much the same as these plugins for [Laravel](https://github.com/spatie/laravel-medialibrary), [Yii](https://github.com/yii2tech/file-storage) and [Cake](https://github.com/burzum/cakephp-file-storage), but not tied to any framework or ORM and less tight coupled.

Features
--------

[](#features)

- **Store files on almost everything:** Local disk, Amazon S3, Dropbox... and many more through the fantastic [league/flysystem](thephpleague/flysystem) library.
- Framework-agnostic
- Image processing (optional feature / dependency)
- Image optimization (optional feature / dependency)
- Provides factories for the adapters
- As lite as possible on dependencies

Installation
------------

[](#installation)

```
composer require php-collective/file-storage
```

Documentation
-------------

[](#documentation)

Please start by reading [docs/](/docs/readme.md) in this repository.

Example
-------

[](#example)

Take a look at [example.php](example.php) or even run it:

```
php example.php
```

The example should give you an exhaustive overview of the library.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance78

Regular maintenance activity

Popularity26

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 62.5% of commits — single point of failure

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 ~3 days

Total

2

Last Release

189d ago

Major Versions

0.1.0 → 1.0.02025-11-10

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/39854?v=4)[Mark Scherer](/maintainers/dereuromark)[@dereuromark](https://github.com/dereuromark)

---

Top Contributors

[![burzum](https://avatars.githubusercontent.com/u/162789?v=4)](https://github.com/burzum "burzum (40 commits)")[![dereuromark](https://avatars.githubusercontent.com/u/39854?v=4)](https://github.com/dereuromark "dereuromark (23 commits)")[![floriankraemer](https://avatars.githubusercontent.com/u/4996022?v=4)](https://github.com/floriankraemer "floriankraemer (1 commits)")

---

Tags

persistenceimage processingfilesstoragemediafile systemagnosticfile storage

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/php-collective-file-storage/health.svg)

```
[![Health](https://phpackages.com/badges/php-collective-file-storage/health.svg)](https://phpackages.com/packages/php-collective-file-storage)
```

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[google/cloud

Google Cloud Client Library

1.2k16.2M53](/packages/google-cloud)[sylius/resource-bundle

Resource component for Sylius.

23410.2M173](/packages/sylius-resource-bundle)[league/flysystem-async-aws-s3

AsyncAws S3 filesystem adapter for Flysystem.

2610.5M31](/packages/league-flysystem-async-aws-s3)[bunnycdn/storage

PHP library to interact with the BunnyCDN Storage API.

8460.2k4](/packages/bunnycdn-storage)

PHPackages © 2026

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