Weave Code
Laravel Filemanager Laravel Package
unisharp/laravel-filemanager
UniSharp Laravel Filemanager adds a responsive web-based file manager to Laravel apps. Browse, upload, organize and delete files and images, integrate with editors like TinyMCE/CKEditor, configure disks, permissions, and customization options.
A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE
Frequently asked questions about Laravel Filemanager
- What Laravel versions does UniSharp Laravel Filemanager support?
- The package is optimized for modern Laravel versions (8.x, 9.x, 10.x). While older Laravel 5.3 references exist in docs, the latest release (v2.14.0+) aligns with current Laravel’s filesystem and middleware systems. Always check the [upgrade guide](https://unisharp.github.io/laravel-filemanager/upgrade) for version-specific notes.
- How do I integrate this with TinyMCE or CKEditor?
- UniSharp provides pre-built adapters for TinyMCE, CKEditor, and Summernote. After installing the package, include the editor-specific JS/CSS in your assets, then configure the editor to use the filemanager’s upload handler. Example configs are in the [integration docs](https://unisharp.github.io/laravel-filemanager/integration).
- Can I use AWS S3 with 'Bucket owner enforced' ACLs?
- Yes, v2.14.0+ explicitly supports S3 ‘Bucket owner enforced’ ACLs, resolving prior ACL conflicts. Configure your `filesystems.php` to use the S3 disk, and the filemanager will handle permissions automatically. Test with pre-signed URLs in staging to validate secure uploads.
- How do I restrict filemanager access to specific users or roles?
- Use Laravel’s middleware to guard routes. Add `auth` or custom middleware (e.g., `role:admin`) to the `$middleware` array in `config/filemanager.php`. For shared folders, combine middleware with folder permissions via the `can` method in your policies.
- What PHP extensions are required for thumbnail generation?
- Thumbnails rely on the `intervention/image` package, which needs either GD or Imagick PHP extensions. Verify these are enabled in your `php.ini` (e.g., `extension=gd`). For async processing, queue thumbnail jobs using Laravel’s queue system to avoid blocking requests.
- How do I customize the filemanager’s UI or translations?
- Publish the package’s assets with `php artisan vendor:publish --tag=filemanager-assets`, then override the Blade views in `resources/views/vendor/filemanager`. Translations can be customized similarly via `vendor:publish --tag=filemanager-translations`. Use events (e.g., `filemanager.view`) for dynamic UI tweaks.
- Does this package support multi-tenancy or shared folders?
- Yes, the filemanager supports private (user-specific) and shared folders. Use the `Filemanager::setDisk()` and `Filemanager::setPath()` methods to scope access per tenant. Combine with Laravel’s auth system or middleware to enforce tenant isolation.
- How do I handle large file uploads or hit PHP memory limits?
- Adjust `post_max_size` and `upload_max_filesize` in `php.ini` for large files. For memory issues, queue thumbnail generation or use chunked uploads. In Docker/K8s, override these settings via environment variables or `php_ini_overrides` in your container config.
- Are there alternatives to UniSharp Laravel Filemanager for Laravel?
- Alternatives include Spatie’s `laravel-medialibrary` (for database-driven media) or `dropzonejs` (for drag-and-drop uploads). However, UniSharp stands out for its WYSIWYG editor integration, responsive UI, and granular disk/configuration support. Compare features like S3 ACL handling or event-driven customization.
- How do I test the filemanager in a CI/CD pipeline?
- Test file operations (uploads, deletions) using Laravel’s HTTP tests. Mock the filesystem or use in-memory disks (e.g., `local` with a temporary directory). Validate editor integrations by testing the upload handler endpoints. Check the [testing section](https://unisharp.github.io/laravel-filemanager/events) for event-based assertions.
Weaver
How can I help you explore Laravel packages today?