2017 © Pedro PelĂĄez
 

symfony-bundle image-bundle

Image handling bundle

image

gregwar/image-bundle

Image handling bundle

  • Thursday, May 17, 2018
  • by Gregwar
  • Repository
  • 13 Watchers
  • 176 Stars
  • 498,167 Installations
  • PHP
  • 12 Dependents
  • 0 Suggesters
  • 40 Forks
  • 25 Open issues
  • 31 Versions
  • 6 % Grown

The README.md

Gregwar's ImageBundle

paypal, (*1)

GregwarImageBundle provides easy Image manipulation and API for Symfony and Twig, (*2)

If you use older version than Symfony 4, please use the 2.* version, else you can use 3.*., (*3)

Installation

Step 1: Download the GregwarImageBundle

Run the following composer command:, (*4)

    composer req gregwar/image-bundle

Step 2: Configure the bundle and set up the directories

Adds the following configuration to your app/config/config.yml:, (*5)

gregwar_image: ~

If you want to customize the cache directory name, you can specify it:, (*6)

gregwar_image:
    cache_dir:  my_cache_dir

Creates the cache directory and change the permissions so the web server can write in it:, (*7)

mkdir web/cache
chmod 777 web/cache

You can also enable the exception thrown if the given file does not exist:, (*8)

gregwar_image:
    throw_exception: true

If you don't throw an exception, you can set the fallback_image, to set the image that should be rendered in this case:, (*9)

gregwar_image:
    fallback_image: /path/to/your/fallback.jpg

If you have to change directories hierarchy or Web's name (e.g. web => public_html), you can set the web_dir to your new Web path:, (*10)

gregwar_image:
    web_dir: %kernel.root_dir%/../../public_html

With Symfony Flex

With Symfony Flex architecture, you can create the config/packages/gregwar_image.yaml file with the following contents:, (*11)

gregwar_image:
    web_dir: %kernel.root_dir%/../public

Usage

Basics

This bundle is based on the Gregwar's Image class and provides simple but powerful Twig extension. You can for instance use it this way:, (*12)

<img src="{{ image('linux.jpg').resize(100,100).negate }}" />

And that's all ! The helper will automatically create the cached file on-the-fly if it doesn't exists yet., (*13)

The available methods are the same as the Gregwar's Image., (*14)

You can also use the logical file names for bundle resources :, (*15)

<img src="{{ image('@AcmeDemoBundle/Resources/images/linux.jpg').resize(100,100).negate }}" />

If you use web_image() helper, the image file path will be prefixed by the web/ absolute directory of your application:, (*16)

<!-- The image some/image.jpg will be prefixed by web directory prefix -->
<img src="{{ web_image('some/image.jpg').resize('10%') }}" />

Using Image API

The image instance provides also a simple API, you can call some methods to get informations about the handled image:, (*17)

Image width: {{ image('linux.jpg').width }}px

Manipulating Image in Controllers

The Image Handler is accessible via a service called image.handling. So you can do in your controllers:, (*18)

<?php
...
$this->get('image.handling')->open('linux.jpg')
    ->grayscale()
    ->rotate(12)
    ->save('out.jpg')

Requirements

GregwarImageBundle needs GD and exif extension for PHP to be installed on the web server, (*19)

License

This bundle is under MIT license, (*20)

The Versions

17/05 2018

dev-master

9999999-dev https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

17/05 2018

v2.2.2

2.2.2.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

17/05 2018

v2.1.4

2.1.4.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

13/04 2018

2.2.1

2.2.1.0 https://github.com/Sentence/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

26/02 2018

v2.2.0

2.2.0.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

06/01 2017

v2.1.3

2.1.3.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

21/10 2016

v2.1.2

2.1.2.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

03/01 2016

v2.0.23

2.0.23.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

03/01 2016

v2.1.1

2.1.1.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

The Development Requires

by Grégoire Passault

symfony image

22/12 2015

v2.1.0

2.1.0.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony image

19/10 2015

v2.0.22

2.0.22.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

25/08 2015

v2.0.21

2.0.21.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

31/05 2015

v2.0.20

2.0.20.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

03/02 2015

v2.0.19

2.0.19.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

13/12 2014

v2.0.18

2.0.18.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

28/09 2014

v2.0.17

2.0.17.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

06/02 2014

v2.0.16

2.0.16.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

06/02 2014

v2.0.15

2.0.15.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

12/12 2013

v2.0.14

2.0.14.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

01/12 2013

v2.0.13

2.0.13.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

29/11 2013

v2.0.12

2.0.12.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

06/11 2013

v2.0.10

2.0.10.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

06/11 2013

v2.0.9

2.0.9.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

06/11 2013

v2.0.8

2.0.8.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

25/10 2013

v2.0.7

2.0.7.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

21/10 2013

v2.0.5

2.0.5.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

18/10 2013

v2.0.4

2.0.4.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

02/10 2013

v2.0.0

2.0.0.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

 

by Grégoire Passault

symfony2 image

15/08 2013

v1.0.3

1.0.3.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

  • php >=5.3.0
  • ext-gd *

 

by Grégoire Passault

symfony2 image

13/08 2013

v1.0.2

1.0.2.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

  • php >=5.3.0
  • ext-gd *

 

by Grégoire Passault

symfony2 image

09/04 2012

v1.0.0

1.0.0.0 https://github.com/Gregwar/ImageBundle

Image handling bundle

  Sources   Download

MIT

The Requires

  • php >=5.3.0
  • ext-gd *

 

by Grégoire Passault

symfony2 image