zmc/image-bundle

Symfony2 bundle for files uploading and images processing

dev-master / 1.0.x-dev 2016-04-16 12:20 UTC

Requires

• liip/imagine-bundle: ~1.4
• symfony/framework-bundle: ~2.3|~3.0

MIT

• Contributors

• symfony
• upload
• images
• crop

README

Basics

• Installation
• Usage

Installation

Step 1) Get the bundle

Simply use composer to install the bundle

composer require zmc/image-bundle:dev-master

Step 2) Register new bundle

Place new line into AppKernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Liip\ImagineBundle\LiipImagineBundle(),
        new Zmc\ImageBundle\ZmcImageBundle(),
    );
    // ...
}

Step 3) Import routing:

# app/config/routing.yml

# some routes can go here...
zmc_image:
    resource: "@ZmcImageBundle/Resources/config/routing.xml"
    prefix:   /zmc-image

# ... and some can go here. It's doesen't matter

Step 4) Configure LiipImagineBundle.

Usage

Firstly you need to create FormType class and just use our form type as field:

<?php
// src/Acme/DemoBundle/Form/Type/DemoType.php

// ...
/**
     * {@inheritdoc}
     */
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add('image', 'file_upload_hidden', array(
            
                /* required parameters */
                'save_path' => '/../web/uploads',
                'web_path' => '/uploads',
                
                /* optional parameters */
                'imagine_filter' => 'thumb', // filter name configured for LiipImagineBundle
                
                /* acceptable files to upload. Patterns and acceptable parameters you can see there http://www.w3schools.com/tags/att_input_accept.asp */
                'accept_file_type' => 'image/*',
                
                // here provided default value, you can pass any service name which implements
                /* \Zmc\ImageBundle\Form\Handler\HandlerInterface */
                'handler' => 'zmc_image.form.handler.upload',  
            ))
        ;
    }
// ...