jakjr/dropzone

Integration between dropzone and laravel5.

dropzone

Este pacote para Laravel5 serve para persistir temporáriamente arquivos submetidos através da biblioteca DropzoneJS., _(*1)

Ao realizar o upload de um arquivo, este será armazenado em uma área temporária., _(*2)

Caso ocorra um reload na página, o componente irá repopular os arquivos previamente carregados, previnindo que seu usuário tenha que inserir os arquivos novamente., _(*3)

Estes casos de reload de página podem ocorrer por falha na validação de algum campo após submeter o formulário, ou por qualquer outro erro no lado so servidor., _(*4)

Existe a restrição de que um formulário contenha apenas um componente., _(*5)

Install

composer require jakjr/dropzone, _(*6)

config/app.php, _(*7)

'providers' => [
    ...
    Jakjr\Dropzone\DropzoneServiceProvider::class,
]

'aliases' => [
    ...
    'Dropzone'  => Jakjr\Dropzone\DropzoneFacade::class,
]

Publicando os assets:, _(*8)

$php artisan vendor:publish --provider="Jakjr\Dropzone\DropzoneServiceProvider"

Uso

routes.php:

Route::post('dropzone', function(){
    app('dropzone')->upload();
});

Route::delete('dropzone', function(){
    app('dropzone')->delete();
});

São os endpoints que receberão os arquivos carregados pelo DropzoneJS., _(*9)

O método upload irá armazenar o arquivo em um diretrio temporário do sistema, e em um diretório com o nome do ID da sessão do usuário., _(*10)

Views (carregando os assets):

@section('css')
    <link rel="stylesheet" href='/vendor/dropzone/css/dropzone.min.css'>
@endsection

@section('js')
    <script src="/vendor/dropzone/js/dropzone.min.js"></script>
    <script>
        $('.dropzone').lightDropzone({!! Dropzone::getConfig() !!});
    </script>
@endsection

Views (criando o componente)

Os atributos data-* são utilizados para configurar o componente DropzoneJS., _(*11)

Seus nomes são auto-explicativos., _(*12)

O attributo data-url deve é a URL do endpoint definido no routes.php, _(*13)

Middleware

Registro o middleware do pacote:, _(*14)

app\Http\Kernel.php:, _(*15)

protected $routeMiddleware = [
    ...
    'dropzone' => \Jakjr\Dropzone\Middleware\Dropzone::class,
];

Este middleware é responsável por injetar no request de um submit os arquivos previamente carregados., _(*16)

Controllers:

Aplique o middleware no método do controller que utilizará o carregamento de arquivos:, _(*17)

class FormController extends Controller
{
    public function __construct()
    {
        $this->middleware('dropzone', ['only'=>['postForm']]);
    }
...
}

Utilize o Request para obter uma instância UploadedFile dos aquivos préviamente carregados:, _(*18)

public function store(Request $request)
{
    ...
    //Use the methods from Laravel
    $request->file('files.0')->move ....
    ...
}

O arquivo permanecerá disponível no componente enquanto não foi movido para seu destino permanente., _(*19)

Exemplo para mover todos os arquivos:, _(*20)

if (!empty($files = $request->files->get('files'))) {

    /** @var UploadedFile $file */
    foreach($files as $file) {
        $file->move(
            storage_path(),
            $file->getClientOriginalName()
        );
    }

}