anakadote / ImageManager-for-Laravel-5 by anakadote

Image resizing and cropping package for Laravel 5.
8,506
15
3
Package Data
Maintainer Username: anakadote
Maintainer Contact: hello@endif.io (Taylor Collins)
Package Create Date: 2015-05-18
Package Last Update: 2021-12-02
Language: PHP
License: MIT
Last Refreshed: 2024-04-18 03:00:47
Package Statistics
Total Downloads: 8,506
Monthly Downloads: 30
Daily Downloads: 1
Total Stars: 15
Total Watchers: 3
Total Forks: 8
Total Open Issues: 0

Image Resizing and Cropping Package for Laravel 5.*

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)

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="">

The getImagePath() method has five parameters, the first four of which are required:

  1. 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 the public directory and its children.

  2. Width (integer) Desired width of the image.

  3. Height (integer) Desired height of the image.

  4. Output Mode (string) The output mode. Options are:

  5. crop

  6. fit - Fit while maintaining aspect ratio

  7. fit-x - Fit to the given width while maintaining aspect ratio

  8. fit-y - Fit to the given height while maintaining aspect ratio

  9. Image Quality - (integer, 0 - 100) Default value is 90


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.