PHPackages                             vdauchy/eloquent-flysystem-adaptor - 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. vdauchy/eloquent-flysystem-adaptor

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

vdauchy/eloquent-flysystem-adaptor
==================================

0.3.2(4y ago)2231MITPHPPHP ^7.4|^8.0

Since Feb 22Pushed 4y ago1 watchersCompare

[ Source](https://github.com/vdauchy/eloquent-flysystem-adaptor)[ Packagist](https://packagist.org/packages/vdauchy/eloquent-flysystem-adaptor)[ RSS](/packages/vdauchy-eloquent-flysystem-adaptor/feed)WikiDiscussions develop Synced 2d ago

READMEChangelogDependencies (12)Versions (6)Used By (0)

Eloquent Flysystem Adaptor
==========================

[](#eloquent-flysystem-adaptor)

[![Build Status](https://github.com/vdauchy/eloquent-flysystem-adaptor/workflows/tests/badge.svg)](https://github.com/vdauchy/eloquent-flysystem-adaptor/actions)[![Total Downloads](https://camo.githubusercontent.com/b67845d3f67c7de1f991215cc23d6b59d49ca3631316d14e1858754ea00c0d99/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766461756368792f656c6f7175656e742d666c7973797374656d2d61646170746f72)](https://packagist.org/packages/vdauchy/eloquent-flysystem-adaptor)[![Latest Stable Version](https://camo.githubusercontent.com/fca0c93d4ddeea69bfc48c5d216c4644f70391ad1816ebb1234a47b86fc18343/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f766461756368792f656c6f7175656e742d666c7973797374656d2d61646170746f72)](https://packagist.org/packages/vdauchy/eloquent-flysystem-adaptor)[![License](https://camo.githubusercontent.com/9055a8b51cb173a9b7cbd07507b7fe140632af66f70a2b6404d5429b8a3bf133/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f766461756368792f656c6f7175656e742d666c7973797374656d2d61646170746f72)](https://packagist.org/packages/vdauchy/eloquent-flysystem-adaptor)

Introduction
------------

[](#introduction)

This package is an Adaptor for Flysystem using Laravel's ORM (Eloquent).

In `config\filesystems.php` add your new disk as:

```
return [
    'disks' => [
        /* Name your disk as you wish */
        'my_sql_disk' => [
            /* Use 'eloquent' driver that is registered by this package. */
            'driver' => 'eloquent',
            /* Optional: Set your custom model that extends the base Model to use different tables per disk */
            'model' => CustomContentModel::class,
            /* Optional: Set a custom callable to generate urls or just overwrite the static method 'getUrl()' */
            'getUrl' => [CustomContentModel::class, 'getSomeCustomUrl']
        ]
    ]
];
```

Create as many models as you wish like:

```
use VDauchy\EloquentFlysystemAdaptor\models\Content;

class CustomContentModel extends Content
{
    /**
     * Example of `getUrl` overwrite to generate URLs using the UUID.
     */
    static public function getUrl(string $path, ?array $metadata): string
    {
        return route('my.custom.content', ['uuid' => $metadata['uuid']]);
    }
}
```

Create controllers like:

```
Route::get('my-custom-content/{uuid}', function (string $uuid) {
    $content = CustomContentModel::fromUuid($uuid);
    /* TODO: Add checks for public/private visibility and improve type/mime handling */
    return response($content->contents, 200, ['Content-Type' => $content->mimetype]);
})
->where('uuid', '^[a-z0-9\-]{36}$')
->name('my.custom.content');
```

Maintenance
-----------

[](#maintenance)

Here are the steps to develop/test this package using docker:

```
# Make sure no image with the same tag exists.
docker image rm php-cli-eloquent-flysystem-adaptor:latest -f;

# Build new image with the expected extensions.
docker build . -t php-cli-eloquent-flysystem-adaptor:latest;

# Update vendors.
docker run \
    --volume $(pwd):/usr/src/app \
    php-cli-eloquent-flysystem-adaptor:latest \
    composer update;

# Run unit tests.
docker run \
    --volume $(pwd):/usr/src/app \
    php-cli-eloquent-flysystem-adaptor:latest \
    composer unit;

# Run static analysis.
docker run \
    --volume $(pwd):/usr/src/app \
    php-cli-eloquent-flysystem-adaptor:latest \
    composer lint;

# Run style check.
docker run \
    --volume $(pwd):/usr/src/app \
    php-cli-eloquent-flysystem-adaptor:latest \
    composer fmt;
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.9% 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 ~23 days

Total

5

Last Release

1812d ago

PHP version history (2 changes)0.1.0PHP ^7.4

0.3.0PHP ^7.4|^8.0

### Community

Maintainers

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

---

Top Contributors

[![vdauchy](https://avatars.githubusercontent.com/u/26772554?v=4)](https://github.com/vdauchy "vdauchy (10 commits)")[![merthurturk](https://avatars.githubusercontent.com/u/1395005?v=4)](https://github.com/merthurturk "merthurturk (1 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/vdauchy-eloquent-flysystem-adaptor/health.svg)

```
[![Health](https://phpackages.com/badges/vdauchy-eloquent-flysystem-adaptor/health.svg)](https://phpackages.com/packages/vdauchy-eloquent-flysystem-adaptor)
```

###  Alternatives

[spatie/laravel-query-builder

Easily build Eloquent queries from API requests

4.4k26.9M220](/packages/spatie-laravel-query-builder)[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[dyrynda/laravel-model-uuid

This package allows you to easily work with UUIDs in your Laravel models.

4802.8M8](/packages/dyrynda-laravel-model-uuid)[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)

PHPackages © 2026

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