Wallogit.com
2017 © Pedro Peláez
Symfony DropzoneBundle
The DropzoneBundle adds support for a direct S3 upload in Symfony2 forms. It provides a form type for sending files directly to your Amazon AWS S3 bucket without touch your webserver., (*1)
Read more about this technique in Aws website., (*2)
Features include:, (*3)
This bundle is well unit tested by phpspec., (*4)
, (*5)
Installation is a quick (I promise!) 4 step process:, (*6)
Require the bundle with composer:, (*7)
$ composer require evoluta/dropzone-bundle "1.0.x-dev"
Composer will install the bundle to your project's vendor/evoluta/dropzone-bundle directory., (*8)
Enable the bundle in the kernel::, (*9)
<?php
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new Evoluta\DropzoneBundle\EvolutaDropzoneBundle(),
// ...
);
}
The next step is to configure the bundle to work with the specific needs of your application., (*10)
Add the following configuration to your parameters.yml file., (*11)
dropzone_endpoint: //s3-eu-west-1.amazonaws.com/ dropzone_accessKey: <aws_accesskey> dropzone_secret: <aws_secret> dropzone_bucket: <aws_bucket>
You can override configurations from parameters.yml in your type usage., (*12)
Add the following configuration to your config.yml file., (*13)
evoluta_dropzone:
endpoint: "%dropzone_endpoint%"
accessKey: "%dropzone_accessKey%"
secret: "%dropzone_secret%"
bucket: "%dropzone_bucket%"
Add in your config.yml file the follow line, (*14)
- 'EvolutaDropzoneBundle:Form:fields.html.twig'
Your config twig area will be like that, (*15)
twig:
debug: "%kernel.debug%"
strict_variables: "%kernel.debug%"
globals:
_guardian_company: "@guardian.company.identity_factory"
form_themes:
- bootstrap_3_layout.html.twig
- 'EvolutaDropzoneBundle:Form:fields.html.twig'
Todo: describe assets dump and declare in main template., (*16)
With this bundle, is available for you a new form field type called dropzoneS3File.
This field type extends the symfony default url field type., (*17)
class DropzoneController extends Controller
{
public function testAction(Request $request)
{
// ...
$form = $this->createFormBuilder()
->add(
'task1',
'dropzoneS3File'
)
->add(
'task2',
'dropzoneS3File',
array(
'acceptedFiles' => 'image/*',
'directory' => 'images/sub1/sub2'
)
)
->getForm();
// ...
}
}
You can override global aws endpoint configuration for this field., (*18)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'endpoint' => '//s3-eu-west-1.amazonaws.com/',
)
)
You can override global accessKey configuration for this field., (*19)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'accessKey' => '<your accessKey>',
)
)
You can override global secret configuration for this field., (*20)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'secret' => '<your secret>',
)
)
You can override global secret configuration for this field., (*21)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'bucket' => '<your bucket>',
)
)
Amazon S3 supports a set of predefined grants, known as canned ACLs. Each canned ACL has a predefined a set of grantees and permissions. You ca read more here, (*22)
You can override global all configuration for this field., (*23)
You can use one of these options:, (*24)
The default value is public-read, (*25)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'all' => 'public-read',
)
)
The sub directory where to put file. The default value is null., (*26)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'directory' => 'images/sub1/sub2'
)
)
The default implementation checks the file's mime type or extension against this list. This is a comma separated list of mime types or file extensions. Eg.: image/*,application/pdf,.psd. The default config allow to upload every kind of file., (*27)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'acceptedFiles' => 'image/*'
)
)
The expiration element specifies the expiration date and time of the POST policy. Indicate how long the user can wait from page loading to finish upload. It expects to be given a string containing an English date format. You can use this keywords:, (*28)
Internal this function use strtotime read more in php website., (*29)
$form = $this->createFormBuilder()
->add(
'File upload',
'dropzoneS3File',
array(
'expireAt' => '+1 hour'
)
)
Still in progress. Please help us!, (*30)
This bundle is under the MIT license. See the complete license in the bundle:, (*31)
Resources/meta/LICENSE
DropzoneBundle is a evolutasrl initiative coded by brainrepo proudly made in Sardinia with love :)., (*32)
Issues and feature requests are tracked in the Github issue tracker., (*33)
When reporting a bug, it may be a good idea to reproduce it in a basic project built using the Symfony Standard Edition to allow developers of the bundle to reproduce the issue by simply cloning it and following some steps., (*34)
Symfony DropzoneBundle
MIT
file upload dropzone