simplejs-upload v1.0.2

simpleUpload Jquery Ajax upload

simpleUpload é um simples Jquery plugin para facilitar o envio de arquivos sem depender de um formulário.

Usage

Html

<input type="file" name="arquivo" id="simpleUpload" multiple >
<button type="button" id="enviar">Enviar</button>

Javascript

$('#simpleUpload').simpleUpload({
	url: 'upload.php',
	trigger: '#enviar',
	success: function(data){
		alert('Envio com sucesso');
	}
});

PHP

	$arquivo = $_FILES['arquivo'];

Se o parâmetro trigger não for definido o envio será iniciado no evento change do elemento.

Data atribute

Todos os parâmetros podem ser enviados via atributo

<input type="file" name="arquivo_1" class="upload" data-trigger="#enviar1" data-url="upload1.php" multiple >
<button type="button" id="enviar1">Enviar 1</button>

<input type="file" name="arquivo_2" class="upload" data-trigger="#enviar1" data-url="upload2.php" multiple >
<button type="button" id="enviar2">Enviar 2</button>

$('.upload').simpleUpload();

On file change

Callback no evento change do elemento com retorno dos metadados do arquivo

$('#simpleUpload').simpleUpload({
	url: 'upload.php',
	change: function(files){
		$.each(files, function(i, file){
			alert('Nome: '+file.name+' - Tamanho: '+file.size+' - Tipo: '+file.type);
		});
	}
});

Valores extras

O parâmetro fields recebe um json com campos a serem enviados ao Backend

$('#simpleUpload').simpleUpload({
	fields: {
		valor : 'Valor 1',
		array : ['array 1', 'array 2']
	}
});

	$arquivo = $_FILES['arquivo'];
	$valor = $_POST['valor'];
	$array = $_POST['array'];

	echo $valor;
	echo $array[0];
	echo $array[1];

Adicionando valores antes de enviar

Podemos adicionar mais valores no momento antes de envio ( Esse recurso pode ser utilizado para qualquer Ajax )

$('#simpleUpload').simpleUpload({
	fields: {
		valor : 'Valor 1',
		array : ['array 1', 'array 2']
	},
	beforeSend: function(xhr, settings){
		settings.data.append('valorAdicional1', 1);
		settings.data.append('valorAdicional2', 'Valor adicional a ser enviado');
	},
});

Arquivos permitidos

O parâmetro types recebe a lista de extensões permitidas, em caso de arquivo inválido retorna o método error com o parametro erro e o atributo type com o valor 'fileType'

$('#simpleUpload').simpleUpload({
	types: ['jpg', 'png', 'pdf'],
	error: function(erro){
		if(error.type == 'fileType') alert('Arquivo inválido.');
	}
});

Tamanho permitido

O tamanho máximo por arquivo por padrão é 5mb para mudar use o parâmetro size o valor deve ser passado em kb, em caso de tamanho inválido retorna o método error com o parametro erro e o atributo type com o valor 'size'

$('#simpleUpload').simpleUpload({
	size: 3072, // 3 mb
	types: ['jpg', 'png', 'pdf'],
	error: function(erro){
		if(error.type == 'size'){
			alert('Tamanho não permitido.');
		}else if(error.type == 'fileType'){
			alert('Arquivo inválido.');
		}else{
			...
		}
	}
});

O método error chamado para arquivos inválidos fora o tamanho e para erro no retorno do Ajax

Outros parâmetros

O simpleUpload suporta a maioria dos parâmetros que o $.ajax() suporta.

Os parâmetros são:

• url ( string: Caminho do arquivo Backend )
• change ( function: método onChange do input file )
• types ( array: lista de extensões permitidas )
• size ( int: tamanho permitido em kb )
• fields ( json: campos extra a serem enviados aceita array )
• error ( function: retorno de erro )
• success ( function: retorno de sucesso )
• beforeSend ( function: executado antes de enviar )
• async
• global
• dataType
• contents
• jsonp
• jsonpCallback
• password
• username
• statusCode

Exemplo back-end PHP

Com o seguinte cenário vamos fazer o upload de multiplos arquivos e resgatar com o PHP

<input type="file" name="arquivo" id="simpleUpload" multiple >
<button type="button" id="enviar">Enviar</button>
<script>
	$(document).ready(function(){
		$('#simpleUpload').simpleUpload({
			url: 'upload.php',
			trigger: '#enviar',
			success: function(data){
				alert('Envio com sucesso');
			}
		});
	});
</script>

Eu costumo criar um função que organiza os arquivos recebidos para ficar mais fácil a manipulação

function orderUpload(&$file){
	$orderedFiles = array();
	$count = count($file['name']);
	$keys = array_keys($file);

	for ($i=0; $i<$count; $i++) foreach ($keys as $key){
		if('name' == $key){
			$file_ary[$i]['extension'] =  strtolower(strrchr($file[$key][$i],"."));
		}
		$orderedFiles[$i][$key] = $file[$key][$i];
	}

	return $orderedFiles;
}

Vamos criar o arquivo upload.php que ira receber os aruquivos e salvar em uma pasta

	$arquivos = orderUpload($_FILES['arquivo']); // Chama a função que retorno os arquivos de forma organizada
	$path     = '/tmp';

	foreach ($arquivos as $k => $arquivo) {

		$fileName = $path . '/arquivo-' . $k . $arquivo['extension'];
		$uploaded = move_uploaded_file($arquivo['tmp_name'], $fileName );

		if($uploaded){
			echo "Arquivo salvo com sucesso!";
		}else{
			echo "Erro ao salvar o arquivo!";
		}
	}

Autor

• Email: rodrigowbazevedo@yahoo.com.br
• GitHub: https://github.com/rodrigowbazevedo