anakadote / laravel-5-image-manager
Image resizing and cropping package for Laravel.
Installs: 8 595
Dependents: 1
Suggesters: 0
Security: 0
Stars: 14
Watchers: 3
Forks: 8
Open Issues: 0
Requires
- php: >=5.4.0
- illuminate/support: >=5.0
This package is auto-updated.
Last update: 2024-09-29 04:14:16 UTC
README
Deprecated: This package is now deprecated in favor of https://github.com/anakadote/ImageManager for further development
Image Resizing and Cropping Package for Laravel
This Laravel package provides a convenient way of resizing and cropping images.
Begin by installing this package through Composer. Edit your project's composer.json
file to require anakadote/laravel-5-image-manager
.
"require": {
"anakadote/laravel-5-image-manager": "dev-master"
}
Next, update Composer from the Terminal:
composer update
Next, add the service provider. Open config/app.php
and add a new item to the providers array.
Anakadote\ImageManager\ImageManagerServiceProvider::class
The final step is to use artisan to move the package assets to the public directory, also from the Terminal:
php artisan vendor:publish --provider="Anakadote\ImageManager\ImageManagerServiceProvider"
Usage
This package is accessible via a Laravel Facade so to use simply call its methods on the Facade "ImageManager".
getImagePath($filename, $width, $height, $mode, $quality = 90)
Example 1: Resize or crop an image and get the newly generated image's web path.
<img src="{{ ImageManager::getImagePath(public_path() . '/img/' . $image->filename, 250, 200, 'crop') }}" alt="">
Example 2: Use an HTML picture element to display a webp version of the image, if supported by the browser.
<picture> <source srcset="{{ ImageManager::getImagePath(public_path() . '/img/' . $image->filename, 250, 200, 'crop', 90, 'webp') }}" type="image/webp"> <img src="{{ ImageManager::getImagePath(public_path() . '/img/' . $image->filename, 250, 200, 'crop') }}" alt=""> </picture>
The getImagePath() method has six parameters, the first four of which are required:
-
File Name (string) The fully qualified name of image file. The file must reside in your app's
public
directory. You'll need to grant write access by the web server to thepublic
directory and its children. -
Width (integer) Desired width of the image.
-
Height (integer) Desired height of the image.
-
Output Mode (string) The output mode. Options are:
-
crop
-
fit - Fit while maintaining aspect ratio.
-
fit-x - Fit to the given width while maintaining aspect ratio.
-
fit-y - Fit to the given height while maintaining aspect ratio.
-
Image Quality - (integer, 0 - 100) Default value is 90.
-
Format - (string) Convert the image to the given format/extension, e.g. "webp";
getUniqueFilename($filename, $destination)
Generate a unique file name within a destination directory — uses the original file name as the basis for the new file name.
<?php $unique_filename = ImageManager::getUniqueFilename( $filename, public_path() . '/img/' );
The getUniqueFilename() method has two parameters: the original filename, and the destination path.
deleteImage($filename)
Delete an image including all resized and/or cropped images generated from it.
<?php ImageManager::deleteImage( public_path() . '/img/' . $image->filename );
The deleteImage() method has a single parameter which is the fully qualified name of the original image file. This method will recursively delete all generated images from the original image file.