m2code/file-manager

Flexible Laravel File Manager: upload, move, delete, thumbnail, blurhash, and more

v1.0.3 2025-06-29 02:43 UTC

Requires

• php: ^8.2
• ext-http: *
• illuminate/console: ^10|^11|^12
• illuminate/filesystem: ^10|^11|^12
• illuminate/http: ^10|^11|^12
• illuminate/support: ^10|^11|^12
• intervention/image: ^3
• kornrunner/blurhash: ^1.1

Requires (Dev)

• orchestra/testbench: 9.x-dev

MIT

• marijmokoginta

README

📦 A modular, clean-architecture-based Laravel package to manage file operations — image, video, documents — with support for multiple drivers (local, cloud, Firebase, etc), progressive images, and flexible configuration.

🔧 Features

• 📁 Save, move, delete, and manage files (images, videos, docs, etc.)
• 🧠 Auto-detect file type & handle accordingly
• 🌁 Image processing (blur preview, low quality, watermark)
• ☁️ Extensible storage drivers: local, S3, Firebase, etc.
• ⚙️ Clean architecture (DDD-friendly & testable)
• 🧩 Facade and fluent Uploader API
• 🔐 Support for signed/dynamic URLs

🚀 Installation

composer require marijmokoginta/file-manager

🛠 Publish Configuration

php artisan vendor:publish --tag=config --provider="M2code\FileManager\FileManagerServiceProvider"

📂 Basic Usage

Save file using facade (no config):

use M2code\FileManager\Facades\FileManager;

$path = FileManager::save($request->file('image'), 'uploads');

Upload image with processing:

use M2code\FileManager\Uploaders\ImageUploader;

$uploader = new ImageUploader();

$result = $uploader
    ->withBlur()
    ->withLowQuality()
    ->withWatermark()
    ->upload($request->file('photo'), 'uploads/images');

$result->path;            // Original file path
$result->lowQualityPath;  // Low quality version
$result->blurhash;        // Blurhash string

📡 Get file URL

use M2code\FileManager\Facades\FileUrl;

$url = FileUrl::url('uploads/images/image.jpg'); // Local or driver-specific

🗃 Supported Drivers

• ✅ Local (default)
• 🔜 S3, Firebase, Custom drivers

Configure in config/file-manager.php:

'driver' => 'local', // or 'firebase', 's3'

📄 License

MIT License © Marij Mokoginta (M2code)