Image management

LiipImagineBundle (frontend)

The media library module uses the Liip Imagine Bundle to serve the images.

Default image filters

  • The media library in fork comes with 5 predefined filters. The 5 predefined filters can be found in app/config/config.yml, view config.yml here. Each filter starts with an auto_rotate and strip filter to ensure that uploaded images are rotated correctly (based on EXIF metadata) and stripped from that EXIF metadata as that data can contain sensitive information.

Custom image filters

Cropper (backend)

When you upload an image with the media library you get the option to crop or rotate the image. But in some cases you might want that crop to have a specific aspect ratio.

Screenshow of the Backend Meda Helper

To set a fixed aspect ratio you need to use the option aspect_ratio of the MediaGroupType (Backend\Modules\MediaLibrary\Domain\MediaGroup\MediaGroupType). This option accepts an AspectRatio (Backend\Modules\MediaLibrary\Domain\MediaItem\AspectRatio).

The height and width of the final image will depend match the height and width of the cropped area of the original image to prevent stretching or compressing.

class MyFormType extends AbstractType
    public function buildForm(FormBuilderInterface $builder, array $options): void
                    'label' => 'lbl.MediaConnected',
                    'constraints' => [new \Symfony\Component\Validator\Constraints\Valid()],
                    'required' => false,
                    'aspect_ratio' => \Backend\Modules\MediaLibrary\Domain\MediaItem\AspectRatio::fromWidthAndHeight(16, 9)