FileUploadBundle

File Upload integration for Symfony 2.4+ and 3+., _(*1)

Installation using Composer

Run the following command to add the package to the composer.json of your project:, _(*2)

``` bash $ composer require connectholland/file-upload-bundle, _(*3)


### Enable the bundle
Enable the bundle in the kernel:

``` php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new ConnectHolland\FileUploadBundle(),
        // ...
    );
}

Usage

1. Configure the FileUploadBundle for file uploads

The bundle requires a location to store the file uploads. Configure the location with the existing FileUploadBundle configuration in your config.yml file:, _(*4)

``` yml, _(*5)

app/config/config.yml

file_upload: path: "%kernel.root_dir%/../../some-directory-outside-of-the-project/%kernel.environment%", _(*6)


#### 2. Modify your Doctrine entity class
To activate file uploads for a Doctrine entity you need to implement the `UploadObjectInterface` and add getters and setters for the form fields.

For ease of use the FileUploadBundle provides an `UploadTrait` to implement both the interface and the getters and setters:

``` php
namespace AppBundle\Entity;

use ConnectHolland\FileUploadBundle\Model\UploadObjectInterface;
use ConnectHolland\FileUploadBundle\Model\UploadTrait;

class Entity implements UploadObjectInterface
{
    use UploadTrait {
        getFileUpload as getImageUpload;
        setFileUpload as setImageUpload;
        getFileUpload as getAnotherImageUpload;
        setFileUpload as setAnotherImageUpload;
    }
}

In the above example you see the UploadTrait with getters and setters for two file upload fields implemented. Here the getImageUpload method maps to a field called 'image' and getAnotherImageUpload maps to 'another_image'., _(*7)