README

A modular, clean-architecture Laravel package for file management — upload, process, store, and serve files across multiple drivers and file types.

Requirements

• PHP 8.2+ / Laravel 10–13 / Imagick PHP extension / intervention/image v3

Installation

composer require m2code/file-manager
php artisan vendor:publish --tag=config --provider="M2code\FileManager\FileManagerServiceProvider"

Quick Start

use M2code\FileManager\Facades\FileManager;
use M2code\FileManager\Application\Uploader\ImageUploader;

// Save any file (UploadedFile, base64, SVG string)
$result = FileManager::save($request->file('document'), 'uploads');

// Upload and process an image
$result = ImageUploader::make()
    ->blur()->optimize('avif')->watermark()
    ->upload($request->file('photo'), 'uploads');

$result->variants->get('original')?->path;
$result->blurhash;

// Delete
FileManager::delete('uploads/old.png');
FileManager::deleteVariants($result->variants);

// URLs
$url = FileUrl::getUrl('uploads/photo.png');
$signed = FileUrl::getSignedUrl('uploads/photo.png', now()->addHour());

Documentation

For Users

For Developers

Testing

vendor/bin/phpunit -c phpunit.xml

License

MIT License — Marij Mokoginta (M2code)