PHPackages                             intervention/image-tempest - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image &amp; Media](/categories/media)
4. /
5. intervention/image-tempest

ActiveLibrary[Image &amp; Media](/categories/media)

intervention/image-tempest
==========================

Tempest framework integration of Intervention Image

4.0.0(1mo ago)12MITPHPPHP ^8.5CI passing

Since Apr 18Pushed 1w agoCompare

[ Source](https://github.com/Intervention/image-tempest)[ Packagist](https://packagist.org/packages/intervention/image-tempest)[ Docs](https://image.intervention.io)[ Fund](https://paypal.me/interventionio)[ GitHub Sponsors](https://github.com/Intervention)[ RSS](/packages/intervention-image-tempest/feed)WikiDiscussions develop Synced 1w ago

READMEChangelog (1)Dependencies (8)Versions (3)Used By (0)

Intervention Image Tempest
==========================

[](#intervention-image-tempest)

Tempest framework integration for Intervention Image
----------------------------------------------------

[](#tempest-framework-integration-for-intervention-image)

[![Latest Version](https://camo.githubusercontent.com/0feca2e0b613f17a9cc33ccbda1cec24f32f3b477b10c408185c1783bdad6698/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e74657276656e74696f6e2f696d6167652d74656d706573742e737667)](https://packagist.org/packages/intervention/image-tempest)[![Tests](https://github.com/Intervention/image-tempest/actions/workflows/build.yml/badge.svg)](https://github.com/Intervention/image-tempest/actions/workflows/build.yml)[![Monthly Downloads](https://camo.githubusercontent.com/783c9063aa12722165d10498e99623591405a24887f74de4e75dff79dd0e78a7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f696e74657276656e74696f6e2f696d6167652d74656d706573742e737667)](https://packagist.org/packages/intervention/image-tempest/stats)[![Support me on Ko-fi](https://raw.githubusercontent.com/Intervention/image-tempest/main/.github/images/support.svg)](https://ko-fi.com/interventionphp)

This package provides an integration to setup [Intervention Image](https://image.intervention.io) easily to your [Tempest](https://tempestphp.com) application with a publishable configuration.

Requirements
------------

[](#requirements)

- Tempest &gt;= 3.9

Installation
------------

[](#installation)

In your existing Tempest application you can install this package using [Composer](https://getcomposer.org).

```
composer require intervention/image-tempest
```

Features
--------

[](#features)

Although Intervention Image can be used with Tempest without this extension, this integration package includes the following features that make image interaction with the framework much easier.

### Application-wide configuration

[](#application-wide-configuration)

This integration package comes with a global configuration file that is recognized by Tempest. It is therefore possible to store the settings for Intervention Image once centrally and not have to define them individually each time you call the image manager.

The configuration file can be copied to the application with the following command.

```
php tempest install image
```

The call will publish the configuration file `image.config.php` to your local application. Here you can set the desired driver and its configuration options for Intervention Image.

The configuration files looks like this.

```
use Intervention\Image\Drivers\Gd\Driver as GdDriver;
use Intervention\Image\Tempest\Config as ImageConfig;

return new ImageConfig(
    /*
    |--------------------------------------------------------------------------
    | Image Driver
    |--------------------------------------------------------------------------
    |
    | Intervention Image supports “GD Library” and “Imagick” to process images
    | internally. Depending on your PHP setup, you can choose one of them.
    |
    | Included options:
    |   - \Intervention\Image\Drivers\Gd\Driver::class
    |   - \Intervention\Image\Drivers\Imagick\Driver::class
    |   - \Intervention\Image\Drivers\Vips\Driver::class
    */

    driver: \Tempest\env('IMAGE_DRIVER', GdDriver::class),

    /*
    |--------------------------------------------------------------------------
    | Configuration Options
    |--------------------------------------------------------------------------
    |
    | These options control the behavior of Intervention Image.
    |
    | - "autoOrientation" controls whether an imported image should be
    |    automatically rotated according to any existing Exif data.
    |
    | - "decodeAnimation" decides whether a possibly animated image is
    |    decoded as such or whether the animation is discarded.
    |
    | - "backgroundColor" Defines the default background & blending color.
    |
    | - "strip" controls if meta data like exif tags should be removed when
    |    encoding images.
    */

    autoOrientation: true,
    decodeAnimation: true,
    backgroundColor: 'ffffff',
    strip: false,
);
```

You can read more about the different options for [driver selection](https://image.intervention.io/v4/basics/configuration-drivers#driver-selection), setting options for [auto orientation](https://image.intervention.io/v4/modifying-images/effects#image-orientation-according-to-exif-data), [decoding animations](https://image.intervention.io/v4/modifying-images/animations) and [background color](https://image.intervention.io/v4/basics/colors#transparency).

### Injecting Dependencies

[](#injecting-dependencies)

The following code example shows how to inject an image manager into your controller. The instance has already been automatically configured according to the config file. Of course you are not limited to inject into controller.

```
use Intervention\Image\Format;
use Intervention\Image\Interfaces\ImageManagerInterface;
use Tempest\Router\Get;
use Tempest\View\View;

use function Tempest\View\view;

final readonly class HomeController
{
    public function __construct(private ImageManagerInterface $imageManager)
    {
        //
    }

    #[Get(uri: '/')]
    public function __invoke(): View
    {
        // process image
        $image = $this->imageManager
            ->decode('./example.jpg')
            ->scale(height: 300)
            ->encodeUsingFormat(Format::WEBP);

        return view('./home.view.php', dataUri: $image->toDataUri());
    }
}
```

Authors
-------

[](#authors)

This library is developed and maintained by [Oliver Vogel](https://intervention.io)

Thanks to the community of [contributors](https://github.com/Intervention/image-tempest/graphs/contributors) who have helped to improve this project.

License
-------

[](#license)

Intervention Image Tempest is licensed under the [MIT License](LICENSE).

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance94

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

52d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7d172b42b2c5b53e71e56589fed3fb3467234a1c266d31b697b1d7b451f4cfe8?d=identicon)[olivervogel](/maintainers/olivervogel)

---

Top Contributors

[![olivervogel](https://avatars.githubusercontent.com/u/884642?v=4)](https://github.com/olivervogel "olivervogel (11 commits)")

---

Tags

gdimageimagickinterventiontempestthumbnailimagegdimagickresizewatermarktempest

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/intervention-image-tempest/health.svg)

```
[![Health](https://phpackages.com/badges/intervention-image-tempest/health.svg)](https://phpackages.com/packages/intervention-image-tempest)
```

###  Alternatives

[intervention/image

PHP Image Processing

14.8k203.8M2.5k](/packages/intervention-image)[intervention/image-laravel

Laravel Integration of Intervention Image

1558.1M158](/packages/intervention-image-laravel)[sybio/image-workshop

Powerful PHP class using GD library to work easily with images including layer notion (like Photoshop or GIMP)

879936.5k12](/packages/sybio-image-workshop)[intervention/image-symfony

Symfony Integration of Intervention Image

1084.3k](/packages/intervention-image-symfony)[folklore/image

Image manipulation library for Laravel 5 based on Imagine and inspired by Croppa for easy url based manipulation

269248.6k5](/packages/folklore-image)[jbzoo/image

A PHP class that simplifies working with images

174128.5k3](/packages/jbzoo-image)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
