A blade component for easy image manipulation
Want to serve private hosted images without the need to code your own logic ? Want to resize your images before sending them to the browser, without extra coding ? Then smart might be your buddy !
This package makes it possible to
- serve images that are not public accessible without coding
- resize images without coding
- resizing public hosted images without coding
- automatically cache your images
Installation
You can install the package via composer:
composer require dietercoopman/smart
The blade component
Smart provides you with a blade component as replacement for the normal <img>
html tag. You can pass in all html attributes , they will be applied. This example will serve a file that is not public accessible and resize it to 400px maintaining the aspect ratio.
<x-smart-image src="{{ storage_path('smart.png') }}" width="400px"/>
This will parse the image , cache it and serve to your browser
<img src="smart/7b5a22db93fd72ead9c5292182927ff2" width="400px">
It's also possible to handle public hosted files but changing the image size , so execute a real resize on the image stream and not only telling the browser to show it at other dimensions.
<x-smart-image src="https://raw.githubusercontent.com/dietercoopman/smart/main/tests/test.png" width="600px" />
Caching
The images are cached with the intervention/image chacke. Default the package will generate a key to store the images in the cache. This key will be used to build the src of the file, making it possible for browsers to cache the image. This key is a random generated but you can override it if you want a more descriptive name for your images.
This can be done by setting the data-src
attribute for your smart image.
<x-smart-image src="{{ storage_path('smart.png') }}" data-src="branding.png" width="400px"/>
this will generate this html as output
<img src="smart/branding.png" width="600px">
Here you see the caching in action
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.