zmc/image-bundle

Symfony2 bundle for files uploading and images processing

ZmcImageBundle Documentation

Basics, _(*1)

• Installation
• Usage

, _(*2)

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:, _(*3)

``` php <?php // app/AppKernel.php, <sub>(*4)</sub>

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

### Step 3) Import routing:
``` yml
# 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.

, <sub>(*6)</sub>

Usage

Firstly you need to create FormType class and just use our form type as field:, <sub>(*7)</sub>

``` php <?php // src/Acme/DemoBundle/Form/Type/DemoType.php, <sub>(*8)</sub>

// ... /** * {@inheritdoc} */ public function buildForm(FormBuilderInterface $builder, array $options) { $builder ->add('image', 'file_upload_hidden', array(, <sub>(*9)</sub>

            /* 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',  
        ))
    ;
}

// ... ```, <sub>(*10)</sub>