PHPackages                             koffinate/laravel-filesystem - 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 &amp; Storage](/categories/file-storage)
4. /
5. koffinate/laravel-filesystem

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

koffinate/laravel-filesystem
============================

Illuminate filesystem compatibility with Minio Support

v1.0.4(3mo ago)13.8kMITPHPPHP ^8.1

Since Jun 17Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/koffinate/laravel-filesystem)[ Packagist](https://packagist.org/packages/koffinate/laravel-filesystem)[ RSS](/packages/koffinate-laravel-filesystem/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (5)Versions (7)Used By (0)

Filesystem Compatibility with Minio support
===========================================

[](#filesystem-compatibility-with-minio-support)

[![Software License](https://camo.githubusercontent.com/f0aeeb35a7309b4edf9306c8a141a5736b3bcef32b010069d76acdbb5e1cc540/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6b6f6666696e6174652f6c61726176656c2d66696c6573797374656d3f636f6c6f723d677265656e2d6c69676874266c6f676f3d676974687562267374796c653d666c61742d737175617265)](LICENSE)[![Latest Version](https://camo.githubusercontent.com/11755d728a9291324f6a598d8ab2feacd5ab64096702b1dd8cb67bcb2860bd9e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6b6f6666696e6174652f6c61726176656c2d66696c6573797374656d2e7376673f6c6f676f3d676974687562267374796c653d666c61742d73717561726526736f72743d73656d766572)](https://github.com/koffinate/laravel-filesystem/releases)[![Packagist Version](https://camo.githubusercontent.com/9d43da3e7d715271c078ce1d27ca1acb610039552bc20b640ebe297399c1b827/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b6f6666696e6174652f6c61726176656c2d66696c6573797374656d3f6c6f676f3d636f6d706f736572267374796c653d666c61742d73717561726526736f72743d73656d766572)](https://packagist.org/packages/koffinate/laravel-filesystem)[![Build Status](https://camo.githubusercontent.com/f349118a0f84eb45ea8098d59608db88c4029e16e4f2bb7b344d81574b73ae4e/68747470733a2f2f6170702e7472617669732d63692e636f6d2f6b6f6666696e6174652f6c61726176656c2d66696c6573797374656d2e7376673f6272616e63683d6d6173746572)](https://app.travis-ci.com/koffinate/laravel-filesystem)[![StyleCI](https://camo.githubusercontent.com/dd36b2e71062eb3808e06824f7f0e8f390148ad19bbf8687e7bb27ac42fa5430/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3139323237313430302f736869656c64)](https://github.styleci.io/repos/192271400)[![Total Downloads](https://camo.githubusercontent.com/00dc1b5ad35aff750d55ca534401de5bfcd97271424c8be726e54cb361207772/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b6f6666696e6174652f6c61726176656c2d66696c6573797374656d3f6c6f676f3d636f6d706f736572267374796c653d666c61742d737175617265)](https://packagist.org/packages/koffinate/laravel-filesystem)

[![GitHub forks](https://camo.githubusercontent.com/9d254124ec5330d7c8d20f362a248950ec4bd9d7e41a166f8d4110cf6f07a95d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6b6f6666696e6174652f6c61726176656c2d66696c6573797374656d3f7374796c653d736f6369616c)](https://github.com/koffinate/laravel-filesystem)[![GitHub stars](https://camo.githubusercontent.com/9101d41a524d216b6e4e609b9b3d1f6472bf1610ab356d77f2b912a5e36fd6da/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6b6f6666696e6174652f6c61726176656c2d66696c6573797374656d3f7374796c653d736f6369616c)](https://github.com/koffinate/laravel-filesystem)

Installation
------------

[](#installation)

```
composer require koffinate/laravel-filesystem
```

Configuration
-------------

[](#configuration)

add this to your environment

```
MINIO_ACCESS_KEY_ID="minio-access-key"
MINIO_SECRET_ACCESS_KEY="minio-secret-access-key"
MINIO_DEFAULT_REGION="minio-region"
MINIO_BUCKET="minio-bucket"
MINIO_USE_PATH_STYLE_ENDPOINT=true
MINIO_URL="minio-full-url-with-bucket-include"
MINIO_ENDPOINT="minio-endpoint-without-bucket-included"
MINIO_VISIBILITY="public"
```

or use default laravel aws-s3 environment,

```
AWS_ACCESS_KEY_ID="s3-access-key"
AWS_SECRET_ACCESS_KEY="s3-secret-access-key"
AWS_DEFAULT_REGION="s3-region"
AWS_BUCKET="s3-bucket"
AWS_USE_PATH_STYLE_ENDPOINT=false
AWS_URL="s3-full-url-with-bucket-include"
AWS_ENDPOINT="s3-endpoint-without-bucket-included"
AWS_VISIBILITY="public"
```

actually if you want to use both of minio and s3 together, use `AWS_` and `MINIO_` on your `.env`.

### Custom configuration

[](#custom-configuration)

You can still customize the configuration by defining new disks with `minio` key to `config/filesystem.php`.
or use this command to generate from default config

```
php artisan koffinate:minio-config
```

Usage
-----

[](#usage)

use normally laravel filesystem as you go.

make sure your `FILESYSTEM_DISK` on `.env` set to `minio` as default,

```
...
FILESYSTEM_DISK=minio
...
```

or `MEDIA_DISK` if using `spatie/laravel-medialibrary`'s package.

```
...
MEDIA_DISK=minio
...
```

### Obtain disk usage

[](#obtain-disk-usage)

you can use it directly using method `disk` from `Storage`,

```
// put content into file
Storage::disk('minio')->put('file.jpg', $contents);

// read file contents
$contents = Storage::disk('minio')->get('file.jpg');

// check file is exists
if (Storage::disk('minio')->exists('file.jpg')) {
    // ...
}

// check file is missing or not exists
if (Storage::disk('minio')->missing('file.jpg')) {
    // ...
}
```

on file upload,

```
// store on folder
$request->file('files')->store('path-to-folder', 'minio');

// store on folder with new name
$request->file('files')->storeAs('path-to-folder', 'file.jpg', 'minio');
```

read more usage on [Laravel Filesystem](https://laravel.com/docs/filesystem).

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance81

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 86.7% 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 ~193 days

Recently: every ~229 days

Total

6

Last Release

101d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7a1ab844f9d950664446a882d81438fc5acdb56def71a07bafb0e505ab5f1c92?d=identicon)[yusronarif](/maintainers/yusronarif)

---

Top Contributors

[![yusronarif](https://avatars.githubusercontent.com/u/3467343?v=4)](https://github.com/yusronarif "yusronarif (13 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (2 commits)")

---

Tags

phpfilesystemFlysystemlaravels3librarycoffeeyusronarifyusronarifmuchkoffinatekoffin

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/koffinate-laravel-filesystem/health.svg)

```
[![Health](https://phpackages.com/badges/koffinate-laravel-filesystem/health.svg)](https://phpackages.com/packages/koffinate-laravel-filesystem)
```

###  Alternatives

[sausin/laravel-ovh

OVH Object Storage driver for laravel

40153.5k](/packages/sausin-laravel-ovh)[zing/laravel-flysystem-obs

Flysystem Adapter for OBS

1211.2k](/packages/zing-laravel-flysystem-obs)[innoge/laravel-rclone

A sleek PHP wrapper around rclone with Laravel-style fluent API syntax

174.1k](/packages/innoge-laravel-rclone)

PHPackages © 2026

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