README

Get the bundle using composer

Add GlavwebUploaderBundle by running this command from the terminal at the root of your Symfony project:

php composer.phar require glavweb/uploader-bundle

Enable the bundle

To start using the bundle, register the bundle in your application's kernel class:

// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new Glavweb\UploaderBundle\GlavwebUploaderBundle(),
        // ...
    );
}

Configure the bundle

This bundle was designed to just work out of the box. The only thing you have to configure in order to get this bundle up and running is a mapping.

# app/config/config.yml

glavweb_uploader:
    mappings:
        entity_images:
            providers :
                - glavweb_uploader.provider.image
            use_orphanage: true
            upload_directory: '%kernel.project_dir%/public/uploads/entity_images'
            upload_directory_url: uploads/entity_images
            max_size: 4194304 # 4Mb
            allowed_mimetypes: [image/jpeg, image/gif, image/png]
            
    orphanage:
        lifetime: 86400

To enable the dynamic routes, add the following to your routing configuration file.

#  app/config/routing.yaml

glavweb_uploader:
    resource: '@GlavwebUploaderBundle/config/routing.yaml'
    prefix:   /

Basic Usage

Added attributes for the entity which needs to support "GlavwebUploadable". "#[Glavweb\Uploadable]" before you can define an entity class:

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;
use Glavweb\UploaderBundle\Entity\Media;
use Glavweb\UploaderBundle\Mapping\Attribute as Glavweb;

#[ORM\Entity]
#[Glavweb\Uploadable()]
class Entity
{
}

And another attribute "#[Glavweb\UploadableField]" before defining the properties of a many-to-many:

#[ORM\ManyToMany(targetEntity: Media::class, inversedBy: "entities", orphanRemoval: true)]
#[ORM\OrderBy(["position" => "ASC"])]
#[Glavweb\UploadableField([mapping => "entity_images"])]
private Collection $images;

public function __construct()
{
    ...
    $this->images = new ArrayCollection();
}

Or many-to-one:

#[ORM\OneToOne(targetEntity: Media::class, orphanRemoval: true)]
#[ORM\JoinColumn(name: "image_id", referencedColumnName: "id", nullable: true, onDelete: "SET NULL")]
#[Glavweb\UploadableField([mapping => "entity_images"])]
private ?Media $image = null;

For build form, you can use GlavwebUploaderDropzoneBundle.

Events

Bundle has 3 events:

glavweb_uploader.validation; // First event, will execute before your file will be uploaded
glavweb_uploader.pre_upload; // Will execute before your file will be uploaded
glavweb_uploader.post_upload. // Will execute after your file will be uploaded

Example

As example we use post upload event.

services.yml:

post_upload_listener:
    class: AppBundle\Listener\PostUploadListener
    tags:
        - { name: kernel.event_listener, event: glavweb_uploader.post_upload, method: onPostUpload }

Listener class:

namespace AppBundle\Listener;

use Glavweb\UploaderBundle\Event\PostUploadEvent;

class PostUploadListener
{
    /**
     * @param PostUploadEvent $event
     */
    public function onPostUpload(PostUploadEvent $event)
    {
        // Some logic
    }
}

Other listeners work on a similar logics.

Also you can define listeners only for your context, as example if context is "article":

article_post_upload_listener:
    class: AppBundle\Listener\ArticlePostUploadListener
    tags:
        - { name: kernel.event_listener, event: glavweb_uploader.post_upload.article, method: onPostUpload }

glavweb / uploader-bundle

Maintainers

Package info

Statistics

Security