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.1(3mo ago)012.9k↑734.4%2[1 issues](https://github.com/php-collective/file-storage/issues)2MITPHPPHP >=8.1CI passing

Since Nov 6Pushed 3mo 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 2w ago

READMEChangelog (3)Dependencies (12)Versions (5)Used By (2)

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

[](#file-storage)

[![CI](https://camo.githubusercontent.com/a2072c3eb73929e768910d9a7b075cca9591bf4c4846c252120ce7eaf24908db/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7068702d636f6c6c6563746976652f66696c652d73746f726167652f63692e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://github.com/php-collective/file-storage/actions)[![Coverage](https://camo.githubusercontent.com/f80297f3996300a46f8208214dbabdb0015f9132eeb090ebe87833dd30bc9b74/68747470733a2f2f636f6465636f762e696f2f67682f7068702d636f6c6c6563746976652f66696c652d73746f726167652f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/php-collective/file-storage)[![Latest Stable Version](https://camo.githubusercontent.com/7d0aaeb088a471ea2cf7245f778343e85655fc86822cdbcee4e3c9afc5bf4d30/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068702d636f6c6c6563746976652f66696c652d73746f726167653f7374796c653d666c61742d737175617265)](https://packagist.org/packages/php-collective/file-storage)[![Total Downloads](https://camo.githubusercontent.com/42cb7e1cfe780f53d3788581f8cb10d2ade2a00c165a6891f40ced15c2e54a37/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7068702d636f6c6c6563746976652f66696c652d73746f726167653f7374796c653d666c61742d737175617265)](https://packagist.org/packages/php-collective/file-storage)[![PHPStan](https://camo.githubusercontent.com/fff00cebb924e124a7335e6bd8ca8f8cf38869463c1654eff45d0939f1f21c57/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://phpstan.org/)[![PHP Version](https://camo.githubusercontent.com/35a3bdb1bce06d7a3dbf9e85884c3825a7ae0a352825e3e64ecc741b9d690087/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d3838393242462e7376673f7374796c653d666c61742d737175617265)](https://php.net)[![Software License](https://camo.githubusercontent.com/6c711032aff1ca0eb6b211aa6cb3649ce7fd64a7714e1181d4bb457f9680e7cf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e7376673f7374796c653d666c61742d737175617265)](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

45

—

FairBetter than 91% of packages

Maintenance79

Regular maintenance activity

Popularity27

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 58% 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 ~86 days

Total

3

Last Release

110d 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 (28 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

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k555.0M2.8k](/packages/aws-aws-sdk-php)[google/cloud

Google Cloud Client Library

1.2k16.9M57](/packages/google-cloud)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k832.6k54](/packages/neuron-core-neuron-ai)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

36826.2k2](/packages/telnyx-telnyx-php)[bunnycdn/storage

PHP library to interact with the BunnyCDN Storage API.

8684.7k4](/packages/bunnycdn-storage)

PHPackages © 2026

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