PHPackages                             opensoft/storage-bundle - 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. opensoft/storage-bundle

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

opensoft/storage-bundle
=======================

An opinionated file based storage system with database level file tracking.

2.0.4(6y ago)416.1k↓33.3%7MITJavaScriptPHP >=7.2

Since Jun 21Pushed 3y ago1 watchersCompare

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

READMEChangelog (10)Dependencies (17)Versions (24)Used By (0)

Opensoft Storage Bundle
=======================

[](#opensoft-storage-bundle)

[![Build Status](https://camo.githubusercontent.com/930b076eab6c16cd8ca0126a0a37f811b6d55d0d1a1c2f030efe7db0a1fa60d4/68747470733a2f2f7472617669732d63692e636f6d2f6f70656e736f66742f4f70656e736f667453746f7261676542756e646c652e7376673f746f6b656e3d6f746262707155554d42756573794b44516b6969266272616e63683d6d6173746572)](https://travis-ci.com/opensoft/OpensoftStorageBundle) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/6dfe7a7180ef86a7a94dc3e97cb23c9ffb8167b6f28a5adf33e864499332f3de/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6f70656e736f66742f4f70656e736f667453746f7261676542756e646c652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d617374657226733d34353433636265336639323431323466343066663830363365356533376434336462313162333765)](https://scrutinizer-ci.com/g/opensoft/OpensoftStorageBundle/?branch=master)

Rationale
---------

[](#rationale)

Many solutions for file storage already exist within the Symfony Bundle ecosystem, yet we found them all lacking some combination of requirements that we would need for our use cases. As part of our core business, we store and process many different kinds of files for customers involved in printing. Due to this requirement, we needed a system that accomplished the following considerations:

1. A solid abstration layer for writing files to storage locations. Those storage locations should be either local or cloud based.
2. Database level tracking for all our files. We should be able to easily query how many, what type, their sizes, which storage location they were stored in.
3. Strong FK relationships between normal database objects and these stored files. This allows us to know exact how each file is linked to other relationships in the database, allowing for cascade related behaviors associated with those files. It also helps us prevent orphaned storage files that aren't linked properly to anything.
4. A storage file write, deletion and movement policy between different storage locations over time.
5. A "permanent url" concept that can resolve URL's to the stored files, no matter which storage system they exist on.

To accomplish this goal, we've designed the OpensoftStorageBundle to handle these use cases for us. It combines tools from [knplabs/gaufrette](https://github.com/KnpLabs/Gaufrette), Doctrine entites for Storages, StorageFiles, and StoragePolicies, some administrative screens to create, update, review, and look at stored files, and some doctrine listeners

Your application then has access to a `storage_manager` service which handles most of these use cases for storing new files into the storage engine.

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

[](#documentation)

Documentation for the bundle can be found in [Resources/doc](Resources/doc/index.md)

License
-------

[](#license)

This bundle is licensed under the permissive MIT license. We welcome pull requests to improve it!

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 88.3% 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 ~44 days

Recently: every ~31 days

Total

17

Last Release

2547d ago

Major Versions

1.3.4 → 2.0.02019-01-24

PHP version history (2 changes)1.0.0PHP >=5.6

2.0.0PHP >=7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/a39488bf3a486007486e38ab85aef162e86b29be6bc48ed69d68e5186b9a7fad?d=identicon)[richardfullmer](/maintainers/richardfullmer)

---

Top Contributors

[![richardfullmer](https://avatars.githubusercontent.com/u/384602?v=4)](https://github.com/richardfullmer "richardfullmer (68 commits)")[![Gounlaf](https://avatars.githubusercontent.com/u/236413?v=4)](https://github.com/Gounlaf "Gounlaf (3 commits)")[![rbunce](https://avatars.githubusercontent.com/u/1913028?v=4)](https://github.com/rbunce "rbunce (2 commits)")[![GitHubHubus](https://avatars.githubusercontent.com/u/11797167?v=4)](https://github.com/GitHubHubus "GitHubHubus (1 commits)")[![ikhaldeev](https://avatars.githubusercontent.com/u/915276?v=4)](https://github.com/ikhaldeev "ikhaldeev (1 commits)")[![scottdriscoll](https://avatars.githubusercontent.com/u/1554882?v=4)](https://github.com/scottdriscoll "scottdriscoll (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

bundlefilefile-managerfile-storagegaufrettephpstoragestorage-enginesymfonysymfony-bundleFlysystemcloudfilestorage

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/opensoft-storage-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/opensoft-storage-bundle/health.svg)](https://phpackages.com/packages/opensoft-storage-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k16.7M310](/packages/easycorp-easyadmin-bundle)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

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

PHPackages © 2026

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