Name: Laravel Uploads
Author: ghostcompiler

Laravel Uploads manages local/cloud file storage, tracks upload metadata, generates secure tokenized preview URLs, integrates with Eloquent models, and supports real-time image optimization. It also features on-demand proxy streaming for remote URLs with zero local disk footprint.

Installation

Install the package via Composer:

composer require ghostcompiler/laravel-uploads
php artisan install:laravel-uploads
php artisan migrate

Use --force to overwrite any existing assets:

php artisan install:laravel-uploads --force

Basic Usage

Uploading a File

use GhostCompiler\LaravelUploads\Facades\Uploads;

// Store a file under configured defaults
$upload = Uploads::upload($request->file('avatar'));

// Store to a specific directory inside the storage path
$upload = Uploads::upload('avatars', $request->file('avatar'));

Uploading from a URL (Dynamic Proxy Streaming)

You can pass a remote URL string directly. The package will register the reference in the database, proxying it on-demand to hide the source URL and bypass local disk storage:

$upload = Uploads::upload('https://avatar.example.com/user123.jpg');

Resolving Secure URLs

Retrieve secure tokenized URLs to stream or preview private files:

// Generates a secure routing URL expiring in 15 minutes
$url = Uploads::url($upload, 15);

Full Documentation

For detailed guides on configuration settings, Eloquent trait integrations, custom URL resolvers, image optimization pipelines, and Artisan commands, see the:

👉 Laravel Uploads Documentation

Development And Build Environment

This package was developed using ServBay as the local development environment.

Development Tool Used

Local development tool: ServBay
Website: www.servbay.com

ServBay your development friend

Testing And Build Machine

Tested on: Mac M4
Built on: Mac M4

<?php namespace GhostCompiler\LaravelUploads\Tests\Unit; use GhostCompiler\LaravelUploads\Services\LaravelUploadsManager; use GhostCompiler\LaravelUploads\Tests\TestCase; class LaravelUploadsManagerResizeTest extends TestCase { public function test_it_calculates_height_from_width_while_preserving_aspect_ratio(): void { config()->set('laravel-uploads.image_optimization.max_width', 1600); config()->set('laravel-uploads.image_optimization.max_height', null); [$width, $height] = $this->manager()->exposedTargetImageDimensions(4000, 2000); $this->assertSame(1600, $width); $this->assertSame(800, $height); } public function test_it_calculates_width_from_height_while_preserving_aspect_ratio(): void { config()->set('laravel-uploads.image_optimization.max_width', null); config()->set('laravel-uploads.image_optimization.max_height', 900); [$width, $height] = $this->manager()->exposedTargetImageDimensions(2000, 4000); $this->assertSame(450, $width); $this->assertSame(900, $height); } public function test_it_does_not_upscale_images_when_resize_limits_are_larger_than_original(): void { config()->set('laravel-uploads.image_optimization.max_width', 1600); config()->set('laravel-uploads.image_optimization.max_height', 1600); [$width, $height] = $this->manager()->exposedTargetImageDimensions(800, 600); $this->assertSame(800, $width); $this->assertSame(600, $height); } protected function manager(): TestableLaravelUploadsManager { return new TestableLaravelUploadsManager(); } } class TestableLaravelUploadsManager extends LaravelUploadsManager { public function exposedTargetImageDimensions(int $width, int $height): array { return $this->targetImageDimensions($width, $height); } }

Laravel Uploads