Download the PHP package askancy/laravel-smart-thumbnails without Composer
On this page you can find all versions of the php package askancy/laravel-smart-thumbnails. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download askancy/laravel-smart-thumbnails
More information about askancy/laravel-smart-thumbnails
Files in askancy/laravel-smart-thumbnails
Package laravel-smart-thumbnails
Short Description Content-aware thumbnails, gradient padding, responsive images and safe version cleanup for Laravel
License MIT
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 laravel-smart-thumbnails
Laravel Smart Thumbnails
The ultimate thumbnail generation package for Laravel. Featuring intelligent smart-cropping, multi-disk support, automatic subdirectory organization, and bulletproof error handling that ensures your application's UI never breaks.
✨ Features
- 🧠 Intelligent Smart Crop Algorithm - Energy-based detection ensures the most important parts of your images are never cropped out.
- 🛡️ Bulletproof Error Handling - Fails gracefully with automatic fallbacks (original image, placeholders, or generated SVGs) to guarantee your layout remains intact.
- 🖼️ Modern Format Support - Seamlessly generates modern image formats, including WebP and AVIF, for maximum compression and performance.
- 📁 Massive Scale Subdirectories - Handles millions of thumbnails efficiently via customizable subdirectory distribution strategies (e.g., hash prefixes, dates).
- 💾 Multi-Disk Architecture - Fully supports local, S3, scoped disks, and any custom Laravel filesystem.
- 🎨 Responsive Variants - Easily define multiple responsive presets (e.g., thumb, card, hero, zoom) within your configuration.
- ⚡ High Performance & Cache - Utilizes Smart Cache Tagging for targeted invalidation without flushing your entire application cache.
- 🎯 Intervention Image 3.x Ready - Full compatibility with the latest image manipulation APIs.
📋 Requirements
- PHP 8.1 or higher
- Laravel 10.0, 11.0, or 12.0
- Intervention Image 3.9+
- GD or ImageMagick PHP Extension (ImageMagick is required for AVIF support)
- Optional: Redis or Memcached (for cache tagging capabilities)
📦 Installation
Install the package via Composer:
Publish the configuration file:
🚀 Quick Start
Laravel Smart Thumbnails is designed to be effortless. Use the facade directly in your Blade views:
The Bulletproof "Silent" Mode (Recommended)
This mode never throws exceptions. If an image is missing or the disk fails, it silently falls back to a placeholder.
The "Strict" Mode (For Debugging / Admin Panels)
If you want exceptions to be thrown when something goes wrong (e.g., missing original file), use strict mode:
Advanced Responsive Pictures
Leverage configured variants to easily render <picture> tags for responsive designs:
⚙️ Configuration
Your config/thumbnails.php file is where the magic happens. You can define multiple "presets", each representing a distinct context (like products, avatars, gallery).
AVIF Format Support
For ultra-modern web performance, AVIF provides ~50% smaller file sizes than JPEG and ~30% smaller than WebP.
To use AVIF, ensure you have the ImageMagick extension installed and update your driver in config/thumbnails.php:
Then, simply set 'format' => 'avif' in your presets!
📁 Subdirectory Optimization
When you have millions of images, storing them all in a single folder slows down the filesystem drastically. Smart Thumbnails solves this automatically using customizable strategies:
'hash_prefix'(Recommended): Uses the first two characters of the MD5 hash (e.g.a/b/image.jpg). Perfectly distributes files.'date_based': Organizes by generation date (e.g.2025/12/31/image.jpg).'filename_prefix': Groups by the starting letters of the filename.'hash_levels': Deeper, multi-level nesting for massive scale (e.g.a/b/c/image.jpg).
🛠️ Maintenance & CLI Commands
Keep your application fast and clean using the built-in Artisan commands:
You can also analyze your usage via Tinker:
🔄 Upgrade Guide (v2.0)
If you are upgrading from an older version, the transition is 100% backwards compatible. No code changes are required in your views or controllers.
Enhancements included automatically:
- Upgrade to Intervention Image 3.x.
- Better memory management and Cache Tagging (Memcached/Redis recommended).
- Advanced Smart Cropping algorithm optimizations.
Make sure to clear your caches after upgrading:
🤝 Contributing
We welcome pull requests and issues! Please see CONTRIBUTING.md for details on our code of conduct and development process.
Looking to help with our AI/Smart Crop Roadmap? Check out SMART_CROP_ROADMAP.md.
📄 License
The MIT License (MIT). Please see LICENSE.md for more information.
🙏 Credits
- Created and maintained by Askancy
- Image manipulation powered by Intervention Image
- Smart crop algorithm inspired by dont-crop
💡 Pro Tip: Always use
->urlSafe()when rendering images in public user-facing views to guarantee your frontend never breaks due to a missing file!
All versions of laravel-smart-thumbnails with dependencies
laravel/framework Version ^11.0|^12.0
intervention/image Version ^3.9
ext-gd Version *