mirror of
https://github.com/Intervention/image.git
synced 2025-01-17 12:18:14 +01:00
76 lines
2.1 KiB
Markdown
76 lines
2.1 KiB
Markdown
# Intervention Image
|
|
## PHP Image Manipulation
|
|
|
|
[](https://packagist.org/packages/intervention/image)
|
|
[](https://github.com/Intervention/image/actions)
|
|
[](https://packagist.org/packages/intervention/image/stats)
|
|
|
|
Intervention Image is a **image handling and manipulation library written in PHP** providing an easier and expressive way to create, edit, and compose images. GD library or Imagick can be selected as the base layer for all operations.
|
|
|
|
- Simple interface for common tasks
|
|
- Interchangable driver architecture
|
|
- Support for animated images
|
|
- Framework-agnostic
|
|
- PSR-12 compliant
|
|
|
|
## Code Examples
|
|
|
|
```php
|
|
// create image manager with desired driver
|
|
$manager = new ImageManager('gd')
|
|
|
|
// open an image file
|
|
$image = $manager->make('images/example.gif');
|
|
|
|
// resize image instance
|
|
$image->resize(height: 300);
|
|
|
|
// insert a watermark
|
|
$image->place('images/watermark.png');
|
|
|
|
// encode edited image
|
|
$encoded = $image->toJpg();
|
|
|
|
// save encoded image
|
|
$encoded->save('images/example.jpg');
|
|
```
|
|
|
|
## Requirements
|
|
|
|
- PHP >= 8.1
|
|
|
|
## Supported Image Libraries
|
|
|
|
- GD Library
|
|
- Imagick PHP extension
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
composer require intervention/image
|
|
```
|
|
|
|
## Getting started
|
|
|
|
Learn the [basics](https://image.intervention.io/v3/basics/instantiation/) on how to use Intervention Image and more with the [official documentation](https://image.intervention.io/v3/).
|
|
|
|
## Development & Testing
|
|
|
|
With this package comes a Docker image to build a test suite and analysis container. To build this container you have to have Docker installed on your system. You can run all tests with this command.
|
|
|
|
```bash
|
|
docker-compose run --rm --build tests
|
|
```
|
|
|
|
Run the static analyzer on the code base.
|
|
|
|
```bash
|
|
docker-compose run --rm --build analysis
|
|
```
|
|
|
|
## License
|
|
|
|
Intervention Image is licensed under the [MIT License](http://opensource.org/licenses/MIT).
|
|
|
|
Copyright 2022 Oliver Vogel
|