PHPackages                             emaia/laravel-mediaman - 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. emaia/laravel-mediaman

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

emaia/laravel-mediaman
======================

MediaMan - Elegant &amp; powerful media management package for Laravel!

v3.0.1(1w ago)068↓66.7%[1 PRs](https://github.com/emaia/laravel-mediaman/pulls)MITPHPPHP ^8.3CI passing

Since Mar 17Pushed 1w agoCompare

[ Source](https://github.com/emaia/laravel-mediaman)[ Packagist](https://packagist.org/packages/emaia/laravel-mediaman)[ Docs](https://github.com/emaia/laravel-mediaman)[ RSS](/packages/emaia-laravel-mediaman/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (33)Versions (66)Used By (0)

[![Latest Version on Packagist](https://camo.githubusercontent.com/599a674bd3027e69ad2be870de32bdb10b6d4b22723363820d62088df7620199/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656d6169612f6c61726176656c2d6d656469616d616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/emaia/laravel-mediaman)[![GitHub Tests Action Status](https://camo.githubusercontent.com/64ab0df5973fbe4ffe071d205c43e7fa1027aae08ff67fda65d3766dd80844f5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f656d6169612f6c61726176656c2d6d656469616d616e2f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/emaia/laravel-mediaman/actions?query=workflow%3Aci+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9bcd0e1aa1b3fd31a1056147e8a38053ce113afb8ba0fff0fd4d1120d1c82cea/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f656d6169612f6c61726176656c2d6d656469616d616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/emaia/laravel-mediaman)

Laravel MediaMan
================

[](#laravel-mediaman)

MediaMan is an elegant and powerful media management package for Laravel apps with a painless uploader, virtual collections, automatic conversions and responsive images, and per-model channel associations.

The API is fluent and UI-agnostic — you stay in control of how things look and behave. Equally at home in a web app or an API server.

Quick example
-------------

[](#quick-example)

```
$media = MediaUploader::fromRequest('featured_image')
    ->useCollection('Posts')
    ->upload();

$post = Post::find(1);
$post->attachMedia($media, 'featured-image-channel');
```

Core concepts
-------------

[](#core-concepts)

- **Media** — any uploaded file, persisted as its own record. Validate types/sizes in your form requests.
- **MediaUploader** — fluent entry point. Uploads exist independently of any model.
- **MediaCollection** — a virtual group of media; many-to-many with Media. Great for asset libraries.
- **Channel** — a per-model tag (`avatar`, `gallery`, …) stored in the polymorphic `mediaman_mediables` pivot. Channels also drive conversions.
- **Conversion** — a transformation registered globally (resize, watermark, format change) and run when media is attached to a channel.
- **Responsive Images** — multi-size, multi-format variants (AVIF/WebP/JPG/PNG) with ready-made ``/`srcset` HTML.

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

[](#documentation)

[**Installation**](docs/installation.md)Requirements, composer, publishing assets, upgrade paths[**Configuration**](docs/configuration.md)Disk, queue, image driver, custom models, URL prefix[**Media**](docs/media.md)The `Media` entity: retrieve, update, delete, HTTP responses, mail, copy/attachTo[**Uploads**](docs/uploads.md)`MediaUploader`: `source`, `fromRequest`, `fromDisk`, `fromBase64`, `fromUrl`[**Models &amp; associations**](docs/models.md)`HasMedia` trait, channels, ordering, fallbacks[**Collections**](docs/collections.md)`MediaCollection`: CRUD, validation, auto-prune[**Conversions**](docs/conversions.md)Global registration, per-channel execution, format detection[**Responsive images**](docs/responsive-images.md)Generation, `` / `srcset`, width calculators[**Security**](docs/security.md)Disallowed extensions, SSRF guard, orphan cleanup[**Events**](docs/events.md)The four package events[**Artisan commands**](docs/commands.md)Publish assets, orphan cleanup, responsive image generation and stats[**Recipes**](docs/recipes.md)PDF/video thumbnails, image optimization, ZIP downloads, multi-file uploads[**API reference**](docs/api.md)Public surface by class/traitRelease history: [CHANGELOG.md](CHANGELOG.md).

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

[](#requirements)

LaravelPackagePHPv12–v131.x–2.x8.3+`fromUrl()` uploads (introduced in 2.5.0) also require **ext-curl**.

Quick install
-------------

[](#quick-install)

```
composer require emaia/laravel-mediaman
php artisan mediaman:publish
php artisan storage:link
php artisan migrate
```

See [Installation](docs/installation.md) for the full setup, including the upgrade path for existing installations.

Contribution and license
------------------------

[](#contribution-and-license)

Found a bug? Open an issue. Feature requests &amp; PRs are welcome.

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

###  Health Score

48

—

FairBetter than 93% of packages

Maintenance98

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 75.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 ~31 days

Recently: every ~1 days

Total

63

Last Release

9d ago

Major Versions

v0.9.0 → v1.0.0-rc12024-04-15

v0.10.0 → v1.0.0-rc22024-10-05

v1.7.1 → v2.0.02026-05-17

2.x-dev → 3.x-dev2026-06-25

PHP version history (4 changes)v0.1.0PHP ^8.0|^7.3

v1.0.0PHP ^8.2

v1.1.0PHP ^8.1

v1.6.4PHP ^8.3

### Community

Maintainers

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

---

Top Contributors

[![FarhanShares](https://avatars.githubusercontent.com/u/3446817?v=4)](https://github.com/FarhanShares "FarhanShares (291 commits)")[![emaia](https://avatars.githubusercontent.com/u/131877?v=4)](https://github.com/emaia "emaia (89 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")

---

Tags

laravelmedia-librarymedia-managerlaravel-packagelaravel-media-managerlaravel-medialaravel mediamanlaravel file managerlaravel media collectionlaravel media managementlaravel file management

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/emaia-laravel-mediaman/health.svg)

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

###  Alternatives

[livewire/livewire

A front-end framework for Laravel.

23.6k89.0M2.7k](/packages/livewire-livewire)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8793.2M25](/packages/yajra-laravel-oci8)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)[farhanshares/laravel-mediaman

MediaMan - The most elegant &amp; powerful media management package for Laravel!

314.2k](/packages/farhanshares-laravel-mediaman)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1235.9k20](/packages/fleetbase-core-api)

PHPackages © 2026

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