spatie/image

Manipulate images with an expressive API

Manipulate images with an expressive API

[](https://packagist.org/packages/spatie/image) [](LICENSE.md) [](https://github.com/spatie/image/actions/workflows/run-tests.yml) [](https://packagist.org/packages/spatie/image)

Image manipulation doesn't have to be hard. Here are a few examples on how this package makes it very easy to manipulate images., _(*1)

use Spatie\Image\Image;

// modifying the image so it fits in a 100x100 rectangle without altering aspect ratio
Image::load($pathToImage)
   ->width(100)
   ->height(100)
   ->save($pathToNewImage);

// overwriting the original image with a greyscale version   
Image::load($pathToImage)
   ->greyscale()
   ->save();

// make image darker and save it in low quality
Image::load($pathToImage)
   ->brightness(-30)
   ->quality(25)
   ->save();

// rotate the image and sharpen it
Image::load($pathToImage)
   ->orientation(90)
   ->sharpen(15)
   ->save();

You'll find more examples in the full documentation., _(*2)

Support us

, _(*3)

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products., _(*4)

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall., _(*5)

Installation

You can install the package via composer:, _(*6)

``` bash composer require spatie/image, <sub>(*7)</sub>

Please note that since version 1.5.3 this package requires exif extension to be enabled: http://php.net/manual/en/exif.installation.php

## Usage

Head over to [the full documentation](https://spatie.be/docs/image).

## Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Testing

``` bash
npm i pixelmatch
composer test

Contributing

Please see CONTRIBUTING for details., <sub>(*8)</sub>

Security

If you've found a bug regarding security please mail security@spatie.be instead of using the issue tracker., <sub>(*9)</sub>

Postcardware

You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using., <sub>(*10)</sub>

Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium., <sub>(*11)</sub>

We publish all received postcards on our company website., <sub>(*12)</sub>

Credits

• Freek Van der Herten
• All Contributors

Large parts of this codebase were copied from Intervention Image by Oliver Vogel, and modified for readability and to fit our needs., <sub>(*13)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*14)</sub>