{"id":15880031,"url":"https://github.com/opensoft/opensoftstoragebundle","last_synced_at":"2025-06-24T06:37:31.546Z","repository":{"id":57032329,"uuid":"94266809","full_name":"opensoft/OpensoftStorageBundle","owner":"opensoft","description":"A bundle for tracking stored files across local and cloud based storages","archived":false,"fork":false,"pushed_at":"2023-02-28T18:03:15.000Z","size":25596,"stargazers_count":4,"open_issues_count":0,"forks_count":7,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-26T13:52:29.934Z","etag":null,"topics":["bundle","file","file-manager","file-storage","gaufrette","php","storage","storage-engine","symfony","symfony-bundle"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opensoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-06-13T23:18:50.000Z","updated_at":"2019-05-28T16:47:00.000Z","dependencies_parsed_at":"2024-01-13T07:23:25.456Z","dependency_job_id":"0b594a73-5190-46b2-9a25-f23c2479b657","html_url":"https://github.com/opensoft/OpensoftStorageBundle","commit_stats":{"total_commits":61,"total_committers":8,"mean_commits":7.625,"dds":"0.16393442622950816","last_synced_commit":"911bfc9286f703069dd601a1226b69334c688d1d"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/opensoft/OpensoftStorageBundle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensoft%2FOpensoftStorageBundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensoft%2FOpensoftStorageBundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensoft%2FOpensoftStorageBundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensoft%2FOpensoftStorageBundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opensoft","download_url":"https://codeload.github.com/opensoft/OpensoftStorageBundle/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensoft%2FOpensoftStorageBundle/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261622814,"owners_count":23186023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bundle","file","file-manager","file-storage","gaufrette","php","storage","storage-engine","symfony","symfony-bundle"],"created_at":"2024-10-06T03:07:15.280Z","updated_at":"2025-06-24T06:37:31.522Z","avatar_url":"https://github.com/opensoft.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Opensoft Storage Bundle\n=======================\n\n[![Build Status](https://travis-ci.com/opensoft/OpensoftStorageBundle.svg?token=otbbpqUUMBuesyKDQkii\u0026branch=master)](https://travis-ci.com/opensoft/OpensoftStorageBundle) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/opensoft/OpensoftStorageBundle/badges/quality-score.png?b=master\u0026s=4543cbe3f924124f40ff8063e5e37d43db11b37e)](https://scrutinizer-ci.com/g/opensoft/OpensoftStorageBundle/?branch=master)\n\nRationale\n---------\n\nMany solutions for file storage already exist within the Symfony Bundle ecosystem, yet we found them all lacking some combination\nof requirements that we would need for our use cases.  As part of our core business, we store and process many different kinds\nof files for customers involved in printing.  Due to this requirement, we needed a system that accomplished the following\nconsiderations:\n\n1.  A solid abstration layer for writing files to storage locations.  Those storage locations should be either local or cloud based.\n2.  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.\n3.  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.\n4.  A storage file write, deletion and movement policy between different storage locations over time.\n5.  A \"permanent url\" concept that can resolve URL's to the stored files, no matter which storage system they exist on.\n\nTo accomplish this goal, we've designed the OpensoftStorageBundle to handle these use cases for us.  It combines tools from\n[knplabs/gaufrette](https://github.com/KnpLabs/Gaufrette), Doctrine entites for Storages, StorageFiles, and StoragePolicies, some\nadministrative screens to create, update, review, and look at stored files, and some doctrine listeners\n\nYour application then has access to a `storage_manager` service which handles most of these use cases for storing new files\ninto the storage engine.\n\nDocumentation\n-------------\n\nDocumentation for the bundle can be found in [Resources/doc](Resources/doc/index.md)\n\nLicense\n-------\n\nThis bundle is licensed under the permissive MIT license.  We welcome pull requests to improve it!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensoft%2Fopensoftstoragebundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopensoft%2Fopensoftstoragebundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensoft%2Fopensoftstoragebundle/lists"}