Download the PHP package gregwar/image-bundle without Composer
On this page you can find all versions of the php package gregwar/image-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download gregwar/image-bundle
More information about gregwar/image-bundle
Files in gregwar/image-bundle
Package image-bundle
Short Description Image handling bundle
License MIT
Homepage https://github.com/Gregwar/ImageBundle
Informations about the package image-bundle
Gregwar's ImageBundle
GregwarImageBundle
provides easy Image manipulation and API for Symfony and Twig
If you use older version than Symfony 4, please use the 2.*
version, else you can
use 3.*
.
Installation
Step 1: Download the GregwarImageBundle
Run the following composer command:
Step 2: Configure the bundle and set up the directories
Adds the following configuration to your app/config/config.yml
:
gregwar_image: ~
If you want to customize the cache directory name, you can specify it:
gregwar_image:
cache_dir: my_cache_dir
Creates the cache directory and change the permissions so the web server can write in it:
mkdir web/cache
chmod 777 web/cache
You can also enable the exception thrown if the given file does not exist:
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:
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:
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:
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:
And that's all ! The helper will automatically create the cached file on-the-fly if it doesn't exists yet.
The available methods are the same as the Gregwar's Image.
You can also use the logical file names for bundle resources :
If you use web_image()
helper, the image file path will be prefixed by the web/
absolute
directory of your application:
Using Image API
The image instance provides also a simple API, you can call some methods to get informations about the handled image:
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:
Requirements
GregwarImageBundle
needs GD
and exif extension for PHP to be installed on the web server
License
This bundle is under MIT license
All versions of image-bundle with dependencies
ext-gd Version *
symfony/framework-bundle Version ^2.3 || ^3.0 || ^4.0 || ^5.0 || ^6.0
symfony/asset Version *
twig/twig Version ^2.0 || ^3.0
gregwar/image Version 2.*