{"id":20416411,"url":"https://github.com/folkloreinc/laravel-image-legacy","last_synced_at":"2025-05-16T12:11:36.615Z","repository":{"id":13565860,"uuid":"16258186","full_name":"folkloreinc/laravel-image-legacy","owner":"folkloreinc","description":"Image manipulation library for Laravel 4 and 5 based on Imagine (https://github.com/avalanche123/Imagine) and inspired by Croppa for easy url based manipulation (with caching)","archived":false,"fork":false,"pushed_at":"2023-01-27T19:25:49.000Z","size":5171,"stargazers_count":271,"open_issues_count":23,"forks_count":81,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-05-16T12:11:35.017Z","etag":null,"topics":["crop","image-manipulation","imagine","laravel","manipulate-images","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"juliusloman/grafana-restsql-datasource","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/folkloreinc.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-26T17:59:46.000Z","updated_at":"2025-03-20T21:49:02.000Z","dependencies_parsed_at":"2023-02-15T12:15:42.501Z","dependency_job_id":null,"html_url":"https://github.com/folkloreinc/laravel-image-legacy","commit_stats":null,"previous_names":["folkloreatelier/laravel-image"],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folkloreinc%2Flaravel-image-legacy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folkloreinc%2Flaravel-image-legacy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folkloreinc%2Flaravel-image-legacy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folkloreinc%2Flaravel-image-legacy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/folkloreinc","download_url":"https://codeload.github.com/folkloreinc/laravel-image-legacy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254527099,"owners_count":22085919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crop","image-manipulation","imagine","laravel","manipulate-images","php"],"created_at":"2024-11-15T06:19:46.484Z","updated_at":"2025-05-16T12:11:36.595Z","avatar_url":"https://github.com/folkloreinc.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Image\nLaravel Image is an image manipulation package for Laravel 4 and 5 based on the [PHP Imagine library](https://github.com/avalanche123/Imagine). It is inspired by [Croppa](https://github.com/BKWLD/croppa) as it can use specially formatted urls to do the manipulations. It supports basic image manipulations such as resize, crop, rotation and flip. It also supports effects such as negative, grayscale, gamma, colorize and blur. You can also define custom filters for greater flexibility.\n\n[![Latest Stable Version](https://poser.pugx.org/folklore/image/v/stable.svg)](https://packagist.org/packages/folklore/image)\n[![Build Status](https://travis-ci.org/Folkloreatelier/laravel-image.png?branch=master)](https://travis-ci.org/Folkloreatelier/laravel-image)\n[![Total Downloads](https://poser.pugx.org/folklore/image/downloads.svg)](https://packagist.org/packages/folklore/image)\n\nThe main difference between this package and other image manipulation libraries is that you can use parameters directly in the url to manipulate the image. A manipulated version of the image is then saved in the same path as the original image, **creating a static version of the file and bypassing PHP for all future requests**.\n\nFor example, if you have an image at this URL:\n\n    /uploads/photo.jpg\n\nTo create a 300x300 version of this image in black and white, you use the URL:\n\n    /uploads/photo-image(300x300-crop-grayscale).jpg\n    \nTo help you generate the URL to an image, you can use the `Image::url()` method\n\n```php\nImage::url('/uploads/photo.jpg',300,300,array('crop','grayscale'));\n```\n\nor\n\n```html\n\u003cimg src=\"\u003c?=Image::url('/uploads/photo.jpg',300,300,array('crop','grayscale'))?\u003e\" /\u003e\n```\n\nAlternatively, you can programmatically manipulate images using the `Image::make()` method. It supports all the same options as the `Image::url()` method.\n\n```php\nImage::make('/uploads/photo.jpg',array(\n\t'width' =\u003e 300,\n\t'height' =\u003e 300,\n\t'grayscale' =\u003e true\n))-\u003esave('/path/to/the/thumbnail.jpg');\n```\n\nor use directly the Imagine library\n\n```php\n$thumbnail = Image::open('/uploads/photo.jpg')\n\t\t\t-\u003ethumbnail(new Imagine\\Image\\Box(300,300));\n\n$thumbnail-\u003eeffects()-\u003egrayscale();\n\t\n$thumbnail-\u003esave('/path/to/the/thumbnail.jpg');\n```\n\n## Features\n\nThis package use [Imagine](https://github.com/avalanche123/Imagine) for image manipulation. Imagine is compatible with GD2, Imagick, Gmagick and supports a lot of [features](http://imagine.readthedocs.org/en/latest/).\n\nThis package also provides some common filters ready to use ([more on this](https://github.com/Folkloreatelier/laravel-image/wiki/Image-filters)):\n- Resize\n- Crop (with position)\n- Rotation\n- Black and white\n- Invert\n- Gamma\n- Blur\n- Colorization\n- Interlace\n\n## Version Compatibility\n\n Laravel  | Image\n:---------|:----------\n 4.2.x    | 0.1.x\n 5.0.x    | 0.2.x\n 5.1.x    | 0.3.x\n 5.2.x    | 0.3.x\n\n## Installation\n\n#### Dependencies:\n\n* [Laravel 5.x](https://github.com/laravel/laravel)\n* [Imagine 0.6.x](https://github.com/avalanche123/Imagine)\n\n#### Server Requirements:\n\n* [gd](http://php.net/manual/en/book.image.php) or [Imagick](http://php.net/manual/fr/book.imagick.php) or [Gmagick](http://www.php.net/manual/fr/book.gmagick.php)\n* [exif](http://php.net/manual/en/book.exif.php) - Required to get image format.\n\n#### Installation:\n\n**1-** Require the package via Composer in your `composer.json`.\n```json\n{\n\t\"require\": {\n\t\t\"folklore/image\": \"0.3.*\"\n\t}\n}\n```\n\n**2-** Run Composer to install or update the new requirement.\n\n```bash\n$ composer install\n```\n\nor\n\n```bash\n$ composer update\n```\n\n**3-** Add the service provider to your `app/config/app.php` file\n```php\n'Folklore\\Image\\ImageServiceProvider',\n```\n\n**4-** Add the facade to your `app/config/app.php` file\n```php\n'Image' =\u003e 'Folklore\\Image\\Facades\\Image',\n```\n\n**5-** Publish the configuration file and public files\n\n```bash\n$ php artisan vendor:publish --provider=\"Folklore\\Image\\ImageServiceProvider\"\n```\n\n**6-** Review the configuration file\n\n```\napp/config/image.php\n```\n\n## Documentation\n* [Complete documentation](https://github.com/Folkloreatelier/image/wiki)\n* [Configuration options](https://github.com/Folkloreatelier/image/wiki/Configuration-options)\n\n## Roadmap\nHere are some features we would like to add in the future. Feel free to collaborate and improve this library.\n\n* More built-in filters such as Brightness and Contrast\n* More configuration when serving images\n* Artisan command to manipulate images\n* Support for batch operations on multiple files\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffolkloreinc%2Flaravel-image-legacy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffolkloreinc%2Flaravel-image-legacy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffolkloreinc%2Flaravel-image-legacy/lists"}