PHPackages mrfrkayvaz/impono - 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. mrfrkayvaz/impono ActiveLibrary[File & Storage](/categories/file-storage) mrfrkayvaz/impono ================= A flexible Laravel package that handles uploads from links, raw data, or files, turning them into a unified upload process. v0.1.3(3mo ago)031โ†“50%MITPHPPHP ^8.2 Since Sep 6Pushed 3mo agoCompare [ Source](https://github.com/mrfrkayvaz/impono)[ Packagist](https://packagist.org/packages/mrfrkayvaz/impono)[ RSS](/packages/mrfrkayvaz-impono/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (10)Versions (5)Used By (0) โ˜๏ธ Impono ========= [](#๏ธ-impono) [![Latest Version on Packagist](https://camo.githubusercontent.com/7c645c870bf0e98eaa0f58c90b95d57954b72fb2ff048b54dc23f3578a51f4d7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d7266726b617976617a2f696d706f6e6f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mrfrkayvaz/impono)[![License](https://camo.githubusercontent.com/96265069087b43ea16ca9946f41c978efaad4edcc99ed0c7ee07b7c386386052/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d7266726b617976617a2f696d706f6e6f3f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mrfrkayvaz/impono)[![Total Downloads](https://camo.githubusercontent.com/9b490f89d05e220c567f427809dabbc77a926edc973e3bcb67a3d63b42a9a48f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d7266726b617976617a2f696d706f6e6f3f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mrfrkayvaz/impono)[![GitHub stars](https://camo.githubusercontent.com/ba04d31d80a0075eec50a32ac5f862be5d8e9feffc1fba76d6f15f92b1529f00/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d7266726b617976617a2f696d706f6e6f3f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/ba04d31d80a0075eec50a32ac5f862be5d8e9feffc1fba76d6f15f92b1529f00/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d7266726b617976617a2f696d706f6e6f3f7374796c653d666c61742d737175617265) A flexible Laravel package that handles uploads from links, raw data, or files, turning them into a unified upload process. Impono provides powerful image manipulation, compression, and storage capabilities with an intuitive API. Features -------- [](#features) - ๐Ÿ”— **Multiple Upload Sources**: Upload from files, URLs, or raw data (base64) - ๐Ÿ–ผ๏ธ **Image Manipulation**: Resize, convert, apply filters, and more - ๐Ÿ—œ๏ธ **Smart Compression**: Automatic image optimization - ๐ŸŽจ **Built-in Filters**: Sepia, blur, brightness adjustments - ๐Ÿ’พ **Flexible Storage**: Support for multiple Laravel storage disks - ๐Ÿ”ง **Extensible**: Easy to add custom manipulation drivers - ๐Ÿงช **Well Tested**: Comprehensive test suite with Pest PHP - โšก **Performance**: Optimized for speed and memory efficiency Installation ------------ [](#installation) You can install the package via Composer: ``` composer require mrfrkayvaz/impono ``` ### Laravel Auto-Discovery [](#laravel-auto-discovery) The package will automatically register itself with Laravel 5.5+. ### Manual Registration [](#manual-registration) If you're using an older version of Laravel, add the service provider to your `config/app.php`: ``` 'providers' => [ // ... Impono\ImponoServiceProvider::class, ], ``` And add the facade alias: ``` 'aliases' => [ // ... 'Impono' => Impono\Facades\Impono::class, ], ``` Configuration ------------- [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --provider="Impono\ImponoServiceProvider" --tag="impono-config" ``` ### Environment Variables [](#environment-variables) Add these variables to your `.env` file: ``` FILESYSTEM_DISK=local IMPOONO_TEMP_PATH=impono/tmp IMPOONO_LOCATION=uploads ``` Usage ----- [](#usage) ### Basic Upload from File [](#basic-upload-from-file) ``` use Impono\Facades\Impono; use Illuminate\Http\Request; public function upload(Request $request) { $file = $request->file('image'); $result = Impono::fromFile($file) ->disk('local') ->location('uploads/2025/jan') ->push('my-image.png'); echo $result->getURL(); // uploads/2025/jan/my-image.png } ``` ### Upload from URL [](#upload-from-url) ``` use Impono\Facades\Impono; $result = Impono::fromUrl('https://example.com/image.jpg') ->resize(800, 600) ->quality(85) ->convert(Extension::WEBP) ->compress() ->push('optimized-image.webp'); echo $result->getURL(); ``` ### Upload from Base64 Data [](#upload-from-base64-data) ``` use Impono\Facades\Impono; $base64Data = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...'; $result = Impono::fromData($base64Data) ->resize(400, 300) ->sepia() ->push('vintage-photo.png'); ``` ### Image Manipulation [](#image-manipulation) ``` use Impono\Facades\Impono; use Impono\Enums\Extension; $result = Impono::fromFile($file) ->resize(1200, 800) // Resize to specific dimensions ->quality(90) // Set JPEG quality ->convert(Extension::WEBP) // Convert to WebP format ->sepia() // Apply sepia filter ->blur(5) // Apply blur effect ->brightness(20) // Adjust brightness ->compress() // Optimize file size ->disk('s3') // Store on S3 ->location('images/gallery') // Custom storage path ->push('processed-image.webp'); ``` ### Available Image Operations [](#available-image-operations) #### Resizing [](#resizing) ``` ->resize(800, 600) // Resize to exact dimensions ->width(800) // Set width only ->height(600) // Set height only ``` #### Format Conversion [](#format-conversion) ``` use Impono\Enums\Extension; ->convert(Extension::WEBP) // Convert to WebP ->convert(Extension::PNG) // Convert to PNG ->convert(Extension::JPEG) // Convert to JPEG ->convert(Extension::GIF) // Convert to GIF ->convert(Extension::AVIF) // Convert to AVIF ->convert(Extension::HEIC) // Convert to HEIC ->convert(Extension::TIFF) // Convert to TIFF ``` #### Filters and Effects [](#filters-and-effects) ``` ->sepia() // Apply sepia filter ->blur(5) // Apply blur (1-100) ->brightness(20) // Adjust brightness (-100 to 100) ->quality(85) // Set JPEG quality (1-100) ``` #### Compression [](#compression) ``` ->compress() // Optimize file size ``` ### Storage Configuration [](#storage-configuration) ``` // Use different storage disks ->disk('local') // Local storage ->disk('s3') // Amazon S3 ->disk('gcs') // Google Cloud Storage // Set custom storage location ->location('uploads/2025/jan') ->location('images/products') ``` ### File Information [](#file-information) ``` $result = Impono::fromFile($file)->push(); // Get file information echo $result->getURL(); // File path echo $result->getFilename(); // Filename without extension echo $result->getExtension(); // File extension echo $result->getDisk(); // Storage disk echo $result->getLocation(); // Storage location echo $result->getIsTemp(); // Is temporary file // Get image dimensions (for images) $width = $result->getWidth(); $height = $result->getHeight(); $fileSize = $result->getFileSize(); ``` Configuration Options --------------------- [](#configuration-options) ### Basic Configuration [](#basic-configuration) ``` // config/impono.php return [ 'temp_path' => 'impono/tmp', // Temporary file storage path 'location' => 'uploads', // Default storage location 'mimes' => [ // Supported file types ['extension' => 'jpg', 'type' => 'image', 'mime' => 'image/jpeg'], ['extension' => 'png', 'type' => 'image', 'mime' => 'image/png'], ['extension' => 'gif', 'type' => 'image', 'mime' => 'image/gif'], ['extension' => 'webp', 'type' => 'image', 'mime' => 'image/webp'], // ... more file types ] ]; ``` ### Supported File Types [](#supported-file-types) The package supports a wide range of file types: **Images:** - JPEG, PNG, GIF, WebP, AVIF, HEIC, TIFF, BMP, SVG **Videos:** - MP4, WebM **Documents:** - PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, CSV **Audio:** - MP3, WebA **Archives:** - ZIP, RAR **Other:** - TXT, XML Advanced Usage -------------- [](#advanced-usage) ### Custom Storage Paths [](#custom-storage-paths) ``` $result = Impono::fromFile($file) ->disk('s3') ->location('user-uploads/' . auth()->id() . '/profile') ->push('avatar.jpg'); ``` ### Batch Processing [](#batch-processing) ``` $files = $request->file('images'); $results = []; foreach ($files as $file) { $results[] = Impono::fromFile($file) ->resize(800, 600) ->compress() ->push(); } ``` ### Error Handling [](#error-handling) ``` try { $result = Impono::fromUrl('https://example.com/image.jpg') ->resize(800, 600) ->push(); } catch (\InvalidArgumentException $e) { // Handle unsupported file type return response()->json(['error' => 'Unsupported file type'], 400); } catch (\RuntimeException $e) { // Handle download/processing errors return response()->json(['error' => 'Failed to process image'], 500); } ``` Testing ------- [](#testing) The package includes a comprehensive test suite. Run tests using: ``` composer test ``` Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 12.0+ - GD or Imagick extension - Spatie Image package Dependencies ------------ [](#dependencies) - `illuminate/support` ^12.0 - `illuminate/database` ^12.0 - `illuminate/http` ^12.0 - `spatie/image` ^3.8 - `spatie/image-optimizer` ^1.8 Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. 1. Fork the repository 2. Create your feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add some amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request License ------- [](#license) This package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). Support ------- [](#support) If you find this package useful, please consider starring it on GitHub. For issues and feature requests, please use the [GitHub issue tracker](https://github.com/mrfrkayvaz/impono/issues). Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Roadmap ------- [](#roadmap) - Video manipulation support - PDF processing capabilities - Advanced compression algorithms - CDN integration - Batch processing queue support - Watermark functionality --- **Made with โค๏ธ for the Laravel community** ### Health Score 37 โ€” LowBetter than 82% of packages Maintenance87 Actively maintained with recent releases Popularity7 Limited adoption so far Community6 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~51 days Total 4 Last Release 93d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/815930?v=4)[mrfrk](/maintainers/mrfrk)[@mrfrk](https://github.com/mrfrk) --- Top Contributors [![mrfrkayvaz](https://avatars.githubusercontent.com/u/14070998?v=4)](https://github.com/mrfrkayvaz "mrfrkayvaz (13 commits)") --- Tags laravelupload ### Code Quality TestsPest Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/mrfrkayvaz-impono/health.svg) ``` [![Health](https://phpackages.com/badges/mrfrkayvaz-impono/health.svg)](https://phpackages.com/packages/mrfrkayvaz-impono) ``` ### Alternatives [unisharp/laravel-filemanager A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE 2.2k3.3M73](/packages/unisharp-laravel-filemanager)[sopamo/laravel-filepond Laravel backend module for filepond uploads 215272.2k3](/packages/sopamo-laravel-filepond)[illuminatech/multipart-middleware 'multipart/form-data' parser middleware for Laravel 34268.8k](/packages/illuminatech-multipart-middleware)[oneofftech/laravel-tus-upload Upload files to your Laravel application with the tus.io resumable upload protocol. 517.3k](/packages/oneofftech-laravel-tus-upload)[erlandmuchasaj/laravel-file-uploader A simple package to help you easily upload files to your laravel project. 128.7k](/packages/erlandmuchasaj-laravel-file-uploader) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)