PHPackages                             a42/magento-filesystem-extension-docs - 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. a42/magento-filesystem-extension-docs

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

a42/magento-filesystem-extension-docs
=====================================

1.0.x-dev(4y ago)11ADSLPHP ~7.1.3||~7.2.0||~7.3.0||~7.4.0

Since Sep 27Pushed 4y ago2 watchersCompare

[ Source](https://github.com/georgebabarus/magento-filesystem-extension)[ Packagist](https://packagist.org/packages/a42/magento-filesystem-extension-docs)[ Docs](https://docs.asset42.com/en/latest/)[ RSS](/packages/a42-magento-filesystem-extension-docs/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Introduction
============

[](#introduction)

Magento 2.4 version has already in place the filesystem abstraction needed to implement and integrate new filesystems (e.g.: external file systems like Amazon Simple Storage Service - S3) for Magento's core modules or custom modules.

There are few touchpoints not abstracted enough, as you could see in the current documentation, but this extension covers this subject to allow cloud object storage service integration into Magento 2.

In many cases, existing "Database files storage" could not be useful and definitively is not an optimal implementation since it is doing sync back to the local filesystem on missing resources.

The ultimate scope of these extensions is to extract static files storage as a microservice for the Magento 2 platform, decoupling files storage system of the computing system, at the same time providing more flexibility in web asset compression, processing, and delivery.

Read the [documentation](https://docs.magento.asset42.com) to find some of the key advantages of using these Magento 2 extensions to integrate with various cloud file storage services in a platform-agnostic manner.

What is covered with these extensions?
--------------------------------------

[](#what-is-covered-with-these-extensions)

- Decouple file storage system of compute component and scale them independently.

    > - Install all bb/filesystem, bb/filesystem-overwrites, bb/filesystem-cms, bb/filesystem-catalog, bb/filesystem-downloadable modules.
    > - Install one of the filesystem driver module eg: bb/filesystem-s3.
    >
    >     A filesystem driver is a class implementing basic operations (read, write, move, etc.) on files or directories. (see: \\Magento\\Framework\\Filesystem\\DriverInterface)
    > - Configure directory mapping to save and serve files directly from storage service.
- Mapping for any media sub-directory to various filesystem services.

    > For example you can make the following mapping:
    >
    > > - media/catalog files to a public AWS S3 bucket
    > > - media/downloadable could be mapped to a private AWS S3 bucket
    > > - media/captcha could be kept on disk filesystem

Currently, there are 6 modules developed for Magento 2 to achieve fully abstracted filesystem implementation:

Important

All extensions are available on [Magento Marketplace](https://marketplace.magento.com/).

[Read more about what you should purchase and install for your scenario](https://docs.magento.asset42.com/en/latest/extension/installation.html)

- `bb/filesystem` is the core module, implementing most of the business logic:

    > - directories mapping
    > - configure new remote media directories for new modules (e.g.: you want to store some reports in Azure Blob storage, you can configure a new directory for this report)
    > - use the media storage system of your choice for any given directory or subdirectory
    > - image resize in-place without sync back to local filesystem (this require having the same configuration for the main directory and the destination of resized files)
    > - [:term:`OOB`](#id1) this module can be used in custom modules, none of Magento core features are touched

`bb/filesystem-overwrites`

> - allows bb/filesystem features on built-in media directories

`bb/filesystem-cms`

> - configure Magento\_Cms module to use bb/filesystem
> - fix some weak points on Magento core components that are not using driver object to execute basic actions on files

`bb/filesystem-catalog`

> - configure Magento\_Catalog module to use bb/filesystem
> - fix some weak points on Magento core components that are not using driver object to execute basic actions on files

`bb/filesystem-downloadable`

> - Allow downloadable files to be saved in a different non-public media storage
> - fix some weak points on Magento core components that are not using driver object to execute basic actions on files

`bb/filesystem-s3`

> - implementation of Amazon S3 like API as a Magento filesystem driver

Author
------

[](#author)

[George Babarus](https://github.com/georgebabarus)

Mailing list
------------

[](#mailing-list)

[Subscribe to the mailing list](https://magento.asset42.com/remote-filesystem-integration-extensions-for-magento-2)

You will receive more information and updates on the extensions developed to allow application-level optimal integration of remote filesystems (e.g.: Amazon S3, Azure Blob Storage, Google Cloud Object Storage) into Magento 2 ecosystem:

> - release notes
> - new features
> - case studies
> - new ideas
> - feature requests surveys

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

1685d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6a654b1c3841734e9167ebd0b61c0da4f69f8e2ffb6e68676d94eaf7bfeee092?d=identicon)[georgebabarus](/maintainers/georgebabarus)

---

Top Contributors

[![georgebabarus](https://avatars.githubusercontent.com/u/6019079?v=4)](https://github.com/georgebabarus "georgebabarus (15 commits)")

---

Tags

awsazurecloudextensionfilesystemgooglemagentos3servicestoragemagento

### Embed Badge

![Health badge](/badges/a42-magento-filesystem-extension-docs/health.svg)

```
[![Health](https://phpackages.com/badges/a42-magento-filesystem-extension-docs/health.svg)](https://phpackages.com/packages/a42-magento-filesystem-extension-docs)
```

###  Alternatives

[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.8M123](/packages/knplabs-gaufrette)[google/cloud-storage

Cloud Storage Client for PHP

34390.8M123](/packages/google-cloud-storage)[illuminate/filesystem

The Illuminate Filesystem package.

15261.6M2.6k](/packages/illuminate-filesystem)[superbalist/flysystem-google-storage

Flysystem adapter for Google Cloud Storage

26320.6M30](/packages/superbalist-flysystem-google-storage)[creocoder/yii2-flysystem

The flysystem extension for the Yii framework

2931.7M61](/packages/creocoder-yii2-flysystem)[flowjs/flow-php-server

PHP library for handling chunk uploads. Works with flow.js html5 file uploads.

2451.6M15](/packages/flowjs-flow-php-server)

PHPackages © 2026

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