itmosoft / laravel-file-manager
File uploads, folder organization, polymorphic ownership, and storage metadata for Laravel applications.
v1.0.0
2026-11-17 10:33 UTC
Requires
- php: ^8.3
- illuminate/contracts: ^12.0|^13.0
- illuminate/database: ^12.0|^13.0
- illuminate/filesystem: ^12.0|^13.0
- illuminate/http: ^12.0|^13.0
- illuminate/support: ^12.0|^13.0
Requires (Dev)
- orchestra/testbench: ^10.0|^11.0
- phpunit/phpunit: ^11.5|^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
File uploads, folder organization, polymorphic ownership, and storage metadata for Laravel applications.
Requirements
- PHP 8.3+
- Laravel 12 or 13
Installation
composer require itmosoft/laravel-file-manager php artisan vendor:publish --tag=itmosoft-file-manager-config php artisan migrate
Add file management to a model
use ItmoSoft\FileManager\Concerns\HasFileManager; class User extends Model { use HasFileManager; }
Create folders and upload files
use ItmoSoft\FileManager\FileManager; $manager = app(FileManager::class); $folder = $manager->createFolder(auth()->user(), 'Contracts'); $asset = $manager->upload( file: $request->file('document'), owner: auth()->user(), folder: $folder, metadata: ['category' => 'legal'], );
The package stores the binary through Laravel's configured filesystem disk and persists the disk, path, original name, MIME type, extension, byte size, owner, folder, and metadata.
Move and delete files
$manager->moveToFolder($asset, $anotherFolder); $manager->delete($asset);
Pass null as the destination folder to move an asset to the owner's root.
Query files and folders
$user->fileAssets()->latest()->get(); $user->fileFolders()->with('children', 'files')->get();
Security responsibilities
- The package prevents assigning a folder to a different polymorphic owner through its manager methods.
- Your application must authorize uploads, downloads, listing, and deletion.
- Do not expose storage paths or generate public URLs without applying your access policy.
- Validate allowed file types, sizes, and content at the application boundary.
- Configure private storage disks for confidential files.
Scope limitations
This release does not include a file-browser UI, HTTP routes, download authorization, image transformations, virus scanning, chunked uploads, version history, sharing links, or a recycle bin.
Testing
composer install
composer test
License
MIT. See LICENSE.