Download the PHP package mwguerra/filemanager without Composer
On this page you can find all versions of the php package mwguerra/filemanager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mwguerra/filemanager
More information about mwguerra/filemanager
Files in mwguerra/filemanager
Package filemanager
Short Description A full-featured file manager package for Laravel and Filament v5 with dual operating modes, drag-and-drop uploads, S3/MinIO support, and comprehensive security features.
License MIT
Homepage https://github.com/mwguerra/filemanager
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package filemanager
MWGuerra FileManager
A full-featured file manager package for Laravel and Filament v5 with dual operating modes, S3/MinIO support, file previews, and drag-and-drop uploads.
Version Compatibility
| Version | Filament | Laravel | Livewire | PHP |
|---|---|---|---|---|
| 2.x | 5.x | 12.x | 4.x | 8.2+ |
| 1.x | 4.x | 11.x | 3.x | 8.2+ |
Features
- Dual operating modes: Database mode (tracked files with metadata) or Storage mode (direct filesystem browsing)
- File browser: Grid and list views, folder tree sidebar, breadcrumb navigation
- File operations: Upload, move, rename, delete with drag-and-drop support
- Multi-selection: Select multiple files with Ctrl/Cmd + click
- File previews: Built-in viewers for video, audio, images, PDF, and text files
- Storage drivers: Works with local, S3, MinIO, or any Laravel Storage driver
- Security: MIME validation, blocked extensions, filename sanitization, signed URLs
- Authorization: Configurable permissions with Laravel Policy support
- Embeddable: Use as standalone pages or embed in Filament forms
- Dark mode: Full dark mode support via Filament
Requirements
- PHP 8.2+
- Laravel 12.x
- Filament 5.x
- Livewire 4.x
Installation
For Filament 5 / Laravel 12 (latest):
For Filament 4 / Laravel 11 (legacy):
Upgrading from v1.x to v2.x
v2.x targets Filament 5, Laravel 12, and Livewire 4. Key changes:
- Filament 5: Table
->actions()renamed to->recordActions(),->bulkActions()renamed to->toolbarActions() - Livewire 4: If you published views, replace any
@entangle('...')directives with$wire.entangle('...') - Laravel 12: Minimum Laravel version is now 12.x
Publish configuration:
Run migrations:
Run the install command:
Register the plugin in your Panel Provider:
Plugin Configuration
Register all components or select only the ones you need:
| Component | URL | Description |
|---|---|---|
FileManager::class |
/admin/file-manager |
Database mode with full CRUD operations |
FileSystem::class |
/admin/file-system |
Storage mode for browsing files (read-only) |
FileSystemItemResource::class |
/admin/file-system-items |
Direct database table management |
SchemaExample::class |
/admin/schema-example |
Demo page for embedding components in forms |
Quick Start
After installation, access the file manager at:
| Page | URL | Description |
|---|---|---|
| File Manager | /admin/file-manager |
Database mode with full CRUD operations |
| File System | /admin/file-system |
Storage mode for browsing files (read-only) |
File Manager (Database Mode)
Full CRUD file management with metadata tracking, thumbnails, and folder organization.
File System (Storage Mode: Read-only)
Read-only file browser for direct filesystem access with S3/MinIO support.
FileSystemItems Resource
Direct database table management for file system items with Filament's standard resource interface.
File Previews
Built-in viewers for common file types with modal preview support.
Image Preview
Video Preview
Embedding in Forms
The package provides two embeddable schema components that can be added to any Filament form. Use FileManagerEmbed for full CRUD operations with database-tracked files, or FileSystemEmbed for a read-only storage browser. Both components are fully customizable with options for height, disk, target directory, and initial folder.
Embed Component Configuration
Both embed components support fluent configuration for customizing their appearance:
| Method | Description |
|---|---|
height(string) |
Set component height (default: '500px') |
defaultViewMode(string) |
Set initial view mode: 'grid' or 'list' |
disk(?string) |
Storage disk to use |
target(?string) |
Target directory within the disk |
initialFolder(?string) |
Initial folder to navigate to on load |
showSidebar() / hideSidebar() |
Show or hide the folder tree sidebar |
sidebarRootLabel(string) |
Label for root folder in sidebar (default: 'Root') |
sidebarHeading(string) |
Heading text for sidebar (default: 'Folders') |
sidebar(bool, ?string, ?string) |
Configure all sidebar options at once |
breadcrumbsRootLabel(string) |
Label for root in breadcrumbs (default: 'Root') |
showHeader() / hideHeader() |
Show or hide header with controls |
compact() |
Enable compact mode (no header, no sidebar) |
All configuration methods support Closure values for dynamic configuration:
Fluent Configuration API
The plugin provides a fluent API for configuring all aspects of the file manager directly in your Panel Provider. This approach is preferred over config file settings as it keeps your panel configuration in one place.
Panel Sidebar
Add a folder tree sidebar to your Filament panel navigation:
File Manager Page Configuration
Configure the database mode File Manager page:
File System Page Configuration
Configure the storage mode File System page (read-only):
Schema Example Page
Enable/disable the demo page for testing embedded components:
Complete Configuration Example
Configuration Precedence
Configuration values follow this precedence (highest to lowest):
- Fluent API - Values set via the plugin methods
- Config file - Values from
config/filemanager.php - Defaults - Built-in default values
For sidebar labels, page-specific settings fall back to panel sidebar settings:
Icon Customization
The file manager uses heroicons by default, but includes fallback SVGs that work without the blade-icons/blade-heroicons package. You can customize icons through the plugin configuration.
Override specific icons:
Disable all icons:
Re-enable icons:
Available icons:
| Icon | Default | Description |
|---|---|---|
folder |
heroicon-o-folder |
Folder icon |
folder-open |
heroicon-o-folder-open |
Open folder icon |
folder-plus |
heroicon-m-folder-plus |
Add folder icon |
document |
heroicon-o-document |
Generic file icon |
document-text |
heroicon-o-document-text |
Text file icon |
chevron-right |
heroicon-m-chevron-right |
Expand chevron |
chevron-down |
heroicon-m-chevron-down |
Collapse chevron |
musical-note |
heroicon-o-musical-note |
Audio file icon |
video-camera |
heroicon-o-video-camera |
Video file icon |
photo |
heroicon-o-photo |
Image file icon |
trash |
heroicon-o-trash |
Delete action |
pencil |
heroicon-m-pencil |
Edit action |
cloud-arrow-up |
heroicon-o-cloud-arrow-up |
Upload icon |
arrow-down-tray |
heroicon-o-arrow-down-tray |
Download icon |
All icons have bundled SVG fallbacks, so the file manager works even without blade-icons installed.
Using icons in your own code:
Artisan Commands
filemanager:install
Install FileManager with all required assets and configuration:
| Option | Description |
|---|---|
--skip-assets |
Skip publishing Filament assets |
--skip-config |
Skip publishing configuration |
--skip-migrations |
Skip running migrations |
--with-css |
Also configure your app.css for style customization |
--css-path= |
Path to CSS file (default: resources/css/app.css) |
--force |
Overwrite existing configurations |
Note: The --with-css option is only needed if you want to customize FileManager styles in your project's CSS. The plugin includes pre-compiled CSS with all necessary Tailwind classes.
filesystem:list
List files directly from a storage disk (recursive by default):
| Option | Description |
|---|---|
path |
Folder path to list (default: root) |
--disk= |
Storage disk (default: from config/env) |
--type= |
Filter: folder, file, or all |
--no-recursive |
Disable recursive listing |
--format= |
Output: table, json, or csv |
--show-hidden |
Include hidden files (starting with .) |
filemanager:list
List files with database or storage mode support:
| Option | Description |
|---|---|
path |
Folder path or ID to list (default: root) |
--disk= |
Storage disk (default: from config/env) |
--mode= |
Mode: database or storage (default: database) |
--target= |
Target directory within disk |
--type= |
Filter: folder, file, or all |
--recursive |
Enable recursive listing |
--format= |
Output: table, json, or csv |
--show-hidden |
Include hidden files |
filemanager:rebuild
Rebuild database from filesystem (clears existing records):
| Option | Description |
|---|---|
--disk= |
Storage disk to scan (default: from config/env) |
--root= |
Root directory to scan |
--force |
Skip confirmation prompt |
filemanager:upload
Upload a local folder to storage:
| Option | Description |
|---|---|
path |
Local folder path to upload (required) |
--disk= |
Target storage disk (default: from config/env) |
--target= |
Target directory within disk |
--no-database |
Skip creating database records |
--force |
Skip confirmation prompt |
Publishable Assets
| Tag | Description |
|---|---|
filemanager-config |
Configuration file |
filemanager-migrations |
Database migrations |
filemanager-views |
Blade view templates |
filemanager-model |
Customizable model |
filemanager-stubs |
Config stubs (filesystems, env) |
filemanager-upload-config |
Upload configuration |
Issues and Contributing
Found a bug or have a feature request? Please open an issue on GitHub Issues.
We welcome contributions! Please read our Contributing Guide before submitting a pull request.
License
File Manager is open-sourced software licensed under the MIT License.
Author
Marcelo W. Guerra
- Website: mwguerra.com
- Github: mwguerra
- Linkedin: marcelowguerra
Contributors
All versions of filemanager with dependencies
filament/filament Version ^5.0
illuminate/contracts Version ^12.0|^13.0
spatie/laravel-package-tools Version ^1.16