https://github.com/intervention/image-symfony

Symfony Integration for Intervention Image
https://github.com/intervention/image-symfony

gd image imagick intervention php symfony

Last synced: 4 days ago
JSON representation

Symfony Integration for Intervention Image

• Host: GitHub
• URL: https://github.com/intervention/image-symfony
• Owner: Intervention
• License: mit
• Created: 2024-04-04T14:21:03.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-08-10T06:38:17.000Z (3 months ago)
• Last Synced: 2024-08-10T16:03:19.451Z (3 months ago)
• Topics: gd, image, imagick, intervention, php, symfony
• Language: PHP
• Homepage: https://image.intervention.io
• Size: 21.5 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Intervention Image Symfony

## Symfony Integration for Intervention Image

[![Latest Version](https://img.shields.io/packagist/v/intervention/image-symfony.svg)](https://packagist.org/packages/intervention/image-symfony)

[![Monthly Downloads](https://img.shields.io/packagist/dm/intervention/image-symfony.svg)](https://packagist.org/packages/intervention/image-symfony/stats)

[![Support me on Ko-fi](https://raw.githubusercontent.com/Intervention/image-symfony/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 [Symfony](https://symfony.com) framework

application. Although the use of this integration library is not absolutely

necessary, it offers a convenient way of central configuration in the Symfony

framework.

## Requirements

- Symfony >= 6.4

## Installation

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

```bash

composer require intervention/image-symfony

```

After successful installation, you can activate the bundle in the file

`config/bundes.php` of your application by inserting the following line into

the array.

```php

return [

    // ...

    Intervention\Image\Symfony\InterventionImageBundle::class => ['all' => true],

];

```

## Configuration

By default, the bundle is configured to use the GD library with Intervention

Image. However, the package also offers other drivers. This and other options of the 

library can be easily configured by creating a file `config/packages/intervention_image.yaml` and

setting the driver class as follows. 

```yaml

intervention_image:

  driver: Intervention\Image\Drivers\Imagick\Driver

  options:

    autoOrientation: true

    decodeAnimation: true

    blendingColor: 'ffffff'

```

You can choose between the two supplied drivers `Intervention\Image\Drivers\Gd\Driver` and

`Intervention\Image\Drivers\Imagick\Driver` for example.

You can read more about the different options for

[auto orientation](https://image.intervention.io/v3/modifying/effects#image-orientation-according-to-exif-data), 

[decoding animations](https://image.intervention.io/v3/modifying/animations) and 

[blending color](https://image.intervention.io/v3/basics/colors#transparency).

## Getting Started

The integration is now complete and it is possible to access the [ImageManager](https://image.intervention.io/v3/basics/instantiation)

via dependency injection.

```php

namespace App\Controller;

use Intervention\Image\ImageManager;

use Symfony\Component\HttpFoundation\Response;

use Symfony\Component\Routing\Annotation\Route;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;

class ExampleController extends AbstractController

{

    #[Route('/')]

    public function example(ImageManager $manager): Response

    {

        $image = $manager->read('images/example.jpg');

    }

}

```

Read the [official documentation of Intervention Image](https://image.intervention.io) for more information.

## Authors

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

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

## License

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