A Laravel package for managing file uploads and image processing with Stapler integration.
Laravel-Stapler is a file upload package for the Laravel framework that integrates with the Stapler package to manage file attachments in Eloquent models. It simplifies handling file uploads, image processing, and storage by providing Laravel-specific commands, migration generators, and sensible defaults. The package solves the problem of managing file uploads in Laravel applications with minimal configuration.
Laravel developers building applications that require file upload functionality, such as user avatars, document attachments, or image galleries. It is particularly useful for projects needing image processing and storage flexibility.
Developers choose Laravel-Stapler because it offers a seamless integration with Laravel's Eloquent ORM, includes built-in tools like migration generators and Artisan commands, and provides a convention-over-configuration approach to file uploads. Its tight coupling with Stapler ensures robust file handling while adding Laravel-specific enhancements.
Stapler-based file upload package for the Laravel framework.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Generates database migrations for file attachment fields automatically via the `stapler:fasten` Artisan command, eliminating manual schema updates for common file columns like file_name and file_size.
Supports multiple image libraries (GD, Gmagick, Imagick) through the Imagine package and allows defining custom styles (e.g., thumbnails), enabling easy image transformations without extra dependencies.
Includes Laravel-specific Artisan commands for fastening and refreshing attachments, and integrates with mass assignment protection, making file fields easily assignable in Eloquent models.
Configurable for local file systems or Amazon S3, with detailed S3 client and object configuration arrays for advanced use, as noted in the migration instructions from older versions.
Officially supports only Laravel up to 5.4, with the maintainer stating they will not update it for newer versions due to inconsistencies, forcing users to rely on it at their own risk in modern projects.
Requires manual steps like creating a system folder with write permissions, and migrating from older Stapler versions involves multiple configuration changes, such as updating service providers and S3 settings.
Relies on service providers that are deprecated in Laravel's newer versions, and the base Stapler package may have maintenance issues, limiting long-term reliability and community support.