Download the PHP package devwizardhq/laravel-filex without Composer

Laravel Filex

Laravel Filex is a powerful, modern, and enterprise-grade file upload component for Laravel applications. Built on top of Dropzone.js, it provides a seamless drag-and-drop file upload experience with advanced features including chunked uploads, real-time progress tracking, comprehensive security validation, temporary file handling, quarantine system, and intelligent file management.

🚀 Features

• 🎯 Easy Integration: Drop-in Blade component for instant file upload functionality
• 📁 Drag & Drop: Modern drag-and-drop interface with visual feedback and animations
• 📊 Progress Tracking: Real-time upload progress with visual indicators and completion states
• 🔄 Chunked Uploads: Handle large files with automatic chunking for better performance and reliability
• ⏱️ Temporary Storage: Safe temporary file handling with automatic expiration and cleanup
• 🔒 Advanced Validation: Multi-layer client-side and server-side validation with custom rules
• 🛡️ Security Features: File signature validation, threat detection, quarantine system, and malicious content scanning
• 🎨 Highly Customizable: Extensive configuration options, theming, and styling flexibility
• ☁️ Cloud Ready: Support for local, S3, and other Laravel storage drivers with streaming
• 🌐 Multi-language Support: Built-in localization for multiple languages (English, Bengali, with more coming)
• 🧹 Auto Cleanup: Scheduled cleanup of orphaned temporary files and quarantined content
• ⚡ Performance Optimized: Lazy loading, intelligent caching, bulk operations, and memory management
• 🔄 Retry Logic: Automatic retry mechanism for failed uploads with exponential backoff
• 📱 Responsive Design: Mobile-friendly interface that works across all devices
• 🎛️ Rich API: Comprehensive API for programmatic file management and operations
• 📈 Performance Monitoring: Built-in performance metrics and optimization tools
• 🚨 Error Handling: Comprehensive error handling with detailed feedback and logging

📋 Requirements

• PHP 8.1+
• Laravel 11.x, or 12.x
• Minimum 256MB memory (recommended 512MB or higher for large files)
• File system write permissions for temporary storage
• Modern web browser with JavaScript support

📦 Installation

Install the package via Composer:

Quick Setup (Recommended)

The package automatically publishes its configuration and assets when installed. For manual installation or to republish files:

Asset Integration

Add the assets directive to your main layout file:

This directive automatically includes all required CSS, JavaScript, and route configurations with performance optimizations.

🔧 Basic Usage

Simple File Upload

Multiple File Upload

Advanced Configuration

🎛️ Component Props

UI Customization Props

Validation Props

Upload Behavior Props

Event Props

Debug and Testing Props

🏗️ Processing Uploads in Controllers

Using the HasFilex Trait

The HasFilex trait provides a clean, simple API for file upload operations:

Available HasFilex Methods

Simple Upload Methods

• moveFile() - Move a single file from request to permanent storage
• moveFiles() - Move multiple files from request to permanent storage

Validation Helpers

• getFileValidationRules() - Get validation rules for single file fields
• getFilesValidationRules() - Get validation rules for multiple file fields

Cleanup

• cleanupTempFiles() - Clean up temporary files if validation fails

Using the Service Directly

Using the Facade

File Visibility Control

Laravel Filex supports controlling file visibility when moving from temporary to permanent storage:

📝 Validation Rules

Laravel Filex provides custom validation rules for enhanced file validation:

Using Custom Validation Rules

Using the FileRule Facade

Available Validation Rules

⚙️ Configuration

Laravel Filex provides extensive configuration options. Publish and customize the config file:

Configuration Table

Environment Variables

You can configure most settings using environment variables:

Route Configuration

You can customize the route prefix, domain, and middleware for file upload endpoints:

This allows you to:

• Change the route prefix from /filex/ to any custom prefix
• Set a specific domain for file upload routes
• Add custom middleware to protect upload routes
• Customize the route names

🧹 File Cleanup

Laravel Filex automatically manages temporary files with scheduled cleanup:

Manual Cleanup

Automatic Cleanup

The package automatically schedules cleanup based on your configuration:

The cleanup is automatically scheduled based on your configuration.

🔒 Security Features

Laravel Filex includes comprehensive security features to protect against malicious file uploads:

Multi-layer Validation

• File Extension Validation: Check against allowed extensions
• MIME Type Validation: Verify declared MIME types
• File Signature Validation: Validate actual file headers/magic bytes
• Content Scanning: Scan file contents for suspicious patterns

Threat Detection

• Executable File Detection: Identify and block executable files
• Script Content Detection: Scan for embedded PHP, JavaScript, and other scripts
• Path Traversal Protection: Prevent directory traversal attacks
• Suspicious Filename Detection: Block files with suspicious names

Quarantine System

Suspicious files are automatically quarantined instead of being processed:

Custom Security Patterns

Add custom security patterns in your configuration:

Security Configuration

Enable or disable security features in your environment:

🎨 Styling and Customization

CSS Customization

Laravel Filex provides comprehensive CSS classes for customization:

Component Styling

Custom Event Handlers

Component Helpers

Each uploader instance exposes helper functions for programmatic control:

🎯 Advanced Features

Chunked Uploads

For large files, Laravel Filex automatically enables chunked uploads:

Progress Tracking & Events

Real-time upload progress with customizable callbacks:

Image Processing & Validation

Built-in image validation and processing:

File Editing & Updates

Handle existing files in edit forms:

Bulk Operations

Process multiple files efficiently:

🚀 Performance Optimization

Configuration Optimization

Asset Optimization

The package includes built-in performance optimizations:

• Lazy Loading: Assets are loaded only when needed
• Asset Minification: Compressed CSS and JavaScript files
• CDN Support: Easy integration with CDN for static assets
• Caching: Smart caching of validation results and file metadata

Large File Handling

🔧 Commands

Laravel Filex provides several Artisan commands:

🌐 Localization

Laravel Filex supports multiple languages out of the box.

Supported Languages

• 🇺🇸 English (en) - Default
• 🇧🇩 Bengali (bn) - Complete
• 🇪🇸 Spanish (es) - Complete
• 🇫🇷 French (fr) - Complete
• 🇩🇪 German (de) - Complete
• 🇸🇦 Arabic (ar) - Complete
• 🇨🇳 Chinese (zh) - Complete
• 🇷🇺 Russian (ru) - Complete
• 🇮🇳 Hindi (hi) - Complete
• 🇧🇷 Portuguese (pt) - Complete
• 🇯🇵 Japanese (ja) - Complete
• 🇮🇹 Italian (it) - Complete

Publishing Language Files

Adding Custom Languages

1. Create language directory: resources/lang/vendor/filex/[locale]/

2. Copy English files:

3. Translate the messages
4. Set your application locale

Dynamic Language Switching

Contributing Translations

We welcome contributions for new languages! To contribute:

1. Fork the repository
2. Create a new language file based on the English version
3. Translate all messages while keeping the same structure
4. Test the translations in your application
5. Submit a pull request