amostajo / laravel-image-handler
Package provides laravel with Image Handler class, perfect to create thumbs, resize or crop images.
Installs: 1 268
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 2
Forks: 6
Open Issues: 1
Requires
- php: >=5.4
- eventviva/php-image-resize: 1.5.*
- illuminate/console: ~5.0
- illuminate/support: ~5.0
Requires (Dev)
- illuminate/database: ~5.0
- mockery/mockery: dev-master
- phpunit/phpunit: ~4.1
- sami/sami: dev-master
This package is auto-updated.
Last update: 2024-10-21 19:43:08 UTC
README
Image handling solution for Laravel 5, creates thumbs on the fly, handles image cropping, upscaling and resizing.
Works with Laravel 5.1.
Installation
Add
"amostajo/laravel-image-handler": "1.0.1"
to your composer.json
. Then run composer install
or composer update
.
Then in your config/app.php
add
Amostajo\LaravelImageHandler\Providers\ImageHandlerProvider::class,
in the providers array.
Then add
'ImageHandler' => Amostajo\LaravelImageHandler\Facades\ImageHandler::class,
in the aliases
array.
Copy and rename the config file [package]\config\config.php
to your laravel's config directory [root]\config\image.php
.
Usage
Creating a thumb for an image have never been this easy:
// $imageUrl is exactly that, an image url. // From either your own website or from an external source. $url = ImageHandler::thumb($imageUrl);
ImageHandler will actually create a thumb and place it in public/thumbs
directory.
The returned $url
can be placed in a img
html tag like this (sample using blade):
<img src="{{ ImageHandler::thumb($imageUrl) }}"/>
The thumb created will always be cropped to fit the desired size. By default, the thumb will be cropped to the width and height specified in the configuration file, although you can easily set these as parameters:
<img src="{{ ImageHandler::thumb($imageUrl, 800, 180) }}"/>
If you don't want the image to be cropped, prefer to keep constraints and just resize, use these methods instead:
// Resized / scaled to a specific width $url = ImageHandler::width($imageUrl); // Resized / scaled to a specific height $url = ImageHandler::height($imageUrl);
<img src="{{ ImageHandler::width($imageUrl, 350) }}"/>
<img src="{{ ImageHandler::height($imageUrl, 350) }}"/>
Configuration
Modify the configuration file to adjust the default thumb sizes, set the name of the folder path for the thumbs to be stored and more.
License
This package is free software distributed under the terms of the MIT license.
Additional Information
This package uses php-image-resize.
Image credits
Beach Taken from http://beachgrooves.com on 1st of July of 2015.
Sheep Taken from https://guim.co.uk on 1st of July of 2015.