PHPackages                             imahmood/laravel-file-storage - 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. imahmood/laravel-file-storage

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

imahmood/laravel-file-storage
=============================

Laravel file storage

v2.3.1(5mo ago)110.6k1MITPHPPHP ^8.1CI passing

Since Oct 1Pushed 5mo ago1 watchersCompare

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

READMEChangelog (10)Dependencies (7)Versions (16)Used By (0)

Laravel FileStorage package
===========================

[](#laravel-filestorage-package)

[![Latest Stable Version](https://camo.githubusercontent.com/a8e4c341b9f5ded295254f9bc53bdabcd02a5a7f1f4d5b7c5cea97f4a51838a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696d61686d6f6f642f6c61726176656c2d66696c652d73746f726167652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/imahmood/laravel-file-storage)[![GitHub Tests Action Status](https://camo.githubusercontent.com/1afa244d266d034cf53d0196c8d91699ce7c77effd392e73794316568713fb88/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f696d61686d6f6f642f6c61726176656c2d66696c652d73746f726167652f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/imahmood/laravel-file-storage/actions?query=workflow%3Atests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/741ad992c9cc247e7e472a63845985cbc2365626b6e0330f8b3742447a94d373/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696d61686d6f6f642f6c61726176656c2d66696c652d73746f726167652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/imahmood/laravel-file-storage)[![License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

FileStorage is a Laravel package that simplifies the process of uploading and attaching files to models, while also automating preview generation and image optimization.

Features
--------

[](#features)

- Easily upload and attach files to models.
- Specify the storage disk dynamically using the `onDisk` method.
- Automatically generate previews for images and PDFs and optimize images, improving user experience.

Requirements
------------

[](#requirements)

Before using this package, make sure your environment meets the following requirements:

- **PHP:** 8.1 or later.
- **Extensions:** `ext-ffi` extension is required.
- **System Packages:** `libvips42` library is necessary for image processing.

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

[](#documentation)

- [Installation](docs/installation.md)
- [Quick start](docs/quick-start.md)
- [Getting a file URL](docs/getting-url.md)
- [Methods](docs/methods.md)
- [Events](docs/events.md)

License
-------

[](#license)

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

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance73

Regular maintenance activity

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.8% 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 ~57 days

Total

15

Last Release

154d ago

Major Versions

v1.0.2 → v2.0.02024-01-01

### Community

Maintainers

![](https://www.gravatar.com/avatar/40872fcebcb975a26597596c44e39a140269d1db23522b47831bfca04d3397f1?d=identicon)[imahmood](/maintainers/imahmood)

---

Top Contributors

[![imahmood](https://avatars.githubusercontent.com/u/13146816?v=4)](https://github.com/imahmood "imahmood (30 commits)")[![smmehdisharifi](https://avatars.githubusercontent.com/u/24722498?v=4)](https://github.com/smmehdisharifi "smmehdisharifi (2 commits)")

---

Tags

laravellaravel-storagelaravel-uploadmedia-managerphpupload

###  Code Quality

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/imahmood-laravel-file-storage/health.svg)

```
[![Health](https://phpackages.com/badges/imahmood-laravel-file-storage/health.svg)](https://phpackages.com/packages/imahmood-laravel-file-storage)
```

###  Alternatives

[overtrue/laravel-filesystem-qiniu

A Qiniu storage filesystem for Laravel.

482229.7k16](/packages/overtrue-laravel-filesystem-qiniu)[rahulhaque/laravel-filepond

Use FilePond the Laravel way

261114.4k2](/packages/rahulhaque-laravel-filepond)[bnbwebexpertise/laravel-attachments

Attach files to your models, retrievable by key, group name or using the Eloquent relationship.

89211.0k1](/packages/bnbwebexpertise-laravel-attachments)[codebar-ag/laravel-flysystem-cloudinary

Cloudinary Flysystem v1 integration with Laravel

1224.9k2](/packages/codebar-ag-laravel-flysystem-cloudinary)

PHPackages © 2026

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