Veja neste artigo como desenvolver uma classe para tratar o upload de arquivos de imagem, redimensionando-as quando necessário para atender a requisitos do sistema.
É comum acharmos na internet procedures para upload de arquivos e imagens. Mas, em casos especiais, apenas o upload não resolve. Podemos precisar salvar as imagens com um tamanho máximo específico. Não é nada prático redimensionar as imagens manualmente para depois fazermos o upload. Vamos ver então, neste artigo, como resolver esse problema.
Além de uma pasta chamada upload, faremos apenas dois arquivos neste exemplo:
- classupload.php: arquivo que contém a classe UploadImagem, que salva a imagem, verifica o tamanho e, se necessário, redimensiona a imagem salva, retornando uma mensagem de erro ou sucesso das operações.
- index.php: arquivo que contém o formulário com o input file, que será o responsável por enviar nossa imagem. Recebemos a imagem também neste arquivo, chamamos nele a classe UploadImagem e exibimos uma mensagem de acordo com o resultado da operação.
Listagem 1: Arquivo classupload.php
<?php class UploadImagem{ public $width; // Definida no arquivo index.php, será a largura máxima da nossa imagem public $height; // Definida no arquivo index.php, será a altura máxima da nossa imagem protected $tipos = array("jpeg", "png", "gif"); // Nossos tipos de imagem disponíveis para este exemplo // Função que irá redimensionar nossa imagem protected function redimensionar($caminho, $nomearquivo){ // Determina as novas dimensões $width = $this->width; $height = $this->height; // Pegamos a largura e altura originais, além do tipo de imagem list($width_orig, $height_orig, $tipo, $atributo) = getimagesize($caminho.$nomearquivo); // Se largura é maior que altura, dividimos a largura determinada pela original e multiplicamos a altura pelo resultado, para manter a proporção da imagem if($width_orig > $height_orig){ $height = ($width/$width_orig)*$height_orig; // Se altura é maior que largura, dividimos a altura determinada pela original e multiplicamos a largura pelo resultado, para manter a proporção da imagem } elseif($width_orig < $height_orig) { $width = ($height/$height_orig)*$width_orig; } // -> fim if // Criando a imagem com o novo tamanho $novaimagem = imagecreatetruecolor($width, $height); switch($tipo){ // Se o tipo da imagem for gif case 1: // Obtém a imagem gif original $origem = imagecreatefromgif($caminho.$nomearquivo); // Copia a imagem original para a imagem com novo tamanho imagecopyresampled($novaimagem, $origem, 0, 0, 0, 0, $width, $height, $width_orig, $height_orig); // Envia a nova imagem gif para o lugar da antiga imagegif($novaimagem, $caminho.$nomearquivo); break; // Se o tipo da imagem for jpg case 2: // Obtém a imagem jpg original $origem = imagecreatefromjpeg($caminho.$nomearquivo); // Copia a imagem original para a imagem com novo tamanho imagecopyresampled($novaimagem, $origem, 0, 0, 0, 0, $width, $height, $width_orig, $height_orig); // Envia a nova imagem jpg para o lugar da antiga imagejpeg($novaimagem, $caminho.$nomearquivo); break; // Se o tipo da imagem for png case 3: // Obtém a imagem png original $origem = imagecreatefrompng($caminho.$nomearquivo); // Copia a imagem original para a imagem com novo tamanho imagecopyresampled($novaimagem, $origem, 0, 0, 0, 0, $width, $height, $width_orig, $height_orig); // Envia a nova imagem png para o lugar da antiga imagepng($novaimagem, $caminho.$nomearquivo); break; } // -> fim switch // Destrói a imagem nova criada e já salva no lugar da original imagedestroy($novaimagem); // Destrói a cópia de nossa imagem original imagedestroy($origem); } // -> fim function redimensionar() protected function tirarAcento($texto){ // array com letras acentuadas $com_acento = array('à','á','â','ã','ä','å','ç','è','é','ê','ë','ì','í','î','ï','ñ','ò','ó','ô','õ','ö','ù','ü','ú','ÿ','À','Á','Â','Ã','Ä','Å','Ç','È','É','Ê','Ë','Ì','Í','Î','Ï','Ñ','Ò','Ó','Ô','Õ','Ö','O','Ù','Ü','Ú','Ÿ',); // array com letras correspondentes ao array anterior, porém sem acento $sem_acento = array('a','a','a','a','a','a','c','e','e','e','e','i','i','i','i','n','o','o','o','o','o','u','u','u','y','A','A','A','A','A','A','C','E','E','E','E','I','I','I','I','N','O','O','O','O','O','0','U','U','U','Y',); // procuramos no nosso texto qualquer caractere do primeiro array e substituímos pelo seu correspondente presente no 2º array $final = str_replace($com_acento, $sem_acento, $texto); // array com pontuação e acentos $com_pontuacao = array('´','`','¨','^','~',' ','-'); // array com substitutos para o array anterior $sem_pontuacao = array('','','','','','_','_'); // procuramos no nosso texto qualquer caractere do primeiro array e substituímos pelo seu correspondente presente no 2º array $final = str_replace($com_pontuacao, $sem_pontuacao, $final); // retornamos a variável com nosso texto sem pontuações, acentos e letras acentuadas return $final; } // -> fim function tirarAcento() // Função que irá fazer o upload da imagem public function salvar($caminho, $file){ // Retiramos acentos, espaços e hífens do nome da imagem $file['name'] = $this->tirarAcento(($file['name'])); // Atribuímos caminho e nome da imagem a uma variável apenas $uploadfile = $caminho.$file['name']; // Guardamos na variável tipo o formato do arquivo enviado $tipo = strtolower(end(explode('/', $file['type']))); // Verifica se a imagem enviada é do tipo jpeg, png ou gif if (array_search($tipo, $this->tipos) === false) { $mensagem = "<font color='#F00'>Envie apenas imagens no formato jpeg, png ou gif!</font>"; return $mensagem; } // Se a imagem temporária não for movida para onde a variável com caminho e nome indica, exibiremos uma mensagem de erro else if (!move_uploaded_file($file['tmp_name'], $uploadfile)) { switch($file['error']){ case 1: $mensagem = "<font color='#F00'>O tamanho do arquivo é maior que o tamanho permitido.</font>"; break; case 2: $mensagem = "<font color='#F00'>O tamanho do arquivo é maior que o tamanho permitido.</font>"; break; case 3: $mensagem = "<font color='#F00'>O upload do arquivo foi feito parcialmente.</font>"; case 4: $mensagem = "<font color='#F00'>Não foi feito o upload de arquivo.</font>"; break; } // -> fim switch // Se a imagem temporária for movida } /* -> fim if */ else{ // Pegamos sua largura e altura originais list($width_orig, $height_orig) = getimagesize($uploadfile); //Comparamos sua largura e altura originais com as desejadas if($width_orig > $this->width || $height_orig > $this->height){ // Chamamos a função que redimensiona a imagem $this->redimensionar($caminho, $file['name']); } // -> fim if // Exibiremos uma mensagem de sucesso $mensagem = "<a href='".$uploadfile."'><font color='#070'>Upload realizado com sucesso!</font><a>"; } // -> fim else // Retornamos a mensagem com o erro ou sucesso return $mensagem; } // -> fim function salvar() } // -> fim classe ?>
Veremos nesse artigo as expressões public e protected. Vamos a uma breve explicação sobre elas e sobre a expressão private, que não está presente neste exemplo.
Public: quando uma variável ou função (método) é declarada como public, a mesma poderá ser acessada de qualquer lugar.
Protected: quando uma variável ou função (método) é declarada como protected, a mesma só poderá ser acessada de dentro de sua classe ou por classes filhas.
Private: quando uma variável ou função (método) é declarada como private, a mesma só poderá ser acessada de dentro de sua classe.
Vamos ver a lista de variáveis e funções utilizadas neste exemplo.
Variáveis:
- public $width – Variável que contém a largura máxima da nossa imagem. É definida no arquivo index.php.
- public $height – Variável que contém a altura máxima da nossa imagem. É definida no arquivo index.php.
- protected $extensoes = array(“jpg”, “png”, “gif”) – Array que contém as extensões permitidas neste exemplo.
Notem que as variáveis $width e $height estão declaradas como public. Portanto, podem ser acessadas e/ou determinadas de qualquer lugar. Já o array $extensoes foi declarado como protected. Isso significa que ele só pode ser acessado por funções (métodos) presentes na classe UploadImagem ou por uma classe filha desta, caso houvesse.
Funções:
- protected function redimensionar() – é chamada na função salvar(). Recebe o nome da imagem que foi salva e utiliza-se das variáveis $width e $height para calcular e redimensionar a imagem recebida, mantendo a proporção da mesma.
- protected function tirarAcento() – também é chamada na função salvar(). Recebe uma variável com texto e procura nele caracteres que possam ser substituídos, de acordo com alguns arrays presentes dentro da função.
- public function salvar() – é chamada quando o formulário presente no arquivo index.php é enviado. Recebe a superglobal $_FILES que contém a imagem enviada pelo formulário e o caminho onde a imagem será salva. Se a imagem for salva, a função obtém a largura e altura da imagem e compara com a largura e altura máxima permitida (determinadas também no arquivo index.php). Se a largura ou altura forem maiores que o permitido, chama a função redimensionar(). Retorna uma mensagem de sucesso ou erro do envio da imagem.
Notem que as funções tirarAcento() e redimensionar() foram declaradas como protected, sendo restritas apenas à classe e classes filhas, caso houvessem. Já a função salvar() foi declarada como public, podendo ser chamada de qualquer arquivo.
Notemos agora este bloco de código:
Listagem 2: Filtrando arquivo pela extensão
$tipo = strtolower(end(explode('/', $file['type']))); if (array_search($tipo, $this->tipos) === false) { $mensagem = "<font color='#F00'>Envie apenas imagens no formato jpeg, png ou gif!</font>"; return $mensagem; }
É comum fazer uma filtragem do arquivo pela extensão. Com este código, fazemos a filtragem pelo tipo de arquivo enviado. Capturamos o tipo do arquivo presente em $file[‘type’] e comparamos com o que queremos. Se for do tipo que queremos, continuamos com o upload. Se não for, retornamos uma mensagem de erro.
Listagem 3: Arquivo index.php, dentro da tag body
<form method="post" name="form1" enctype="multipart/form-data" action="index.php"> <fieldset> <legend>Upload de Imagem</legend> <strong>Fotografia:</strong> <input type="file" name="img" id="img" /> <input type="submit" value="Enviar" /> <!-- Determinamos via HTML um tamanho máximo para a nossa imagem--> <input type="hidden" name="MAX_FILE_SIZE" value="1024000" /> </fieldset> </form> <?php if(!empty($_FILES)){ // Se o array $_FILES não estiver vazio // Incluímos o arquivo com a classe include 'classupload.php'; // Associamos a classe à variável $upload $upload = new UploadImagem(); // Determinamos nossa largura máxima permitida para a imagem $upload->width = 250; // Determinamos nossa altura máxima permitida para a imagem $upload->height = 250; // Exibimos a mensagem com sucesso ou erro retornada pela função salvar. //Se for sucesso, a mensagem também é um link para a imagem enviada. echo $upload->salvar("upload/", $_FILES['img']); } ?>
Figura 1: Formulário de upload de imagem
Neste arquivo, temos o formulário que contém o input file que usaremos para procurar e enviar nossa imagem () e o botão submit (), responsável por enviar o formulário. Notem que, no formulário, determinamos um valor para o atributo enctype (enctype=”multipart/form-data”). O padrão para enctype é “application/x-www-form-urlencoded”, mas alteramos esse valor para “multipart/form-data” porque estamos enviando um arquivo pelo formulário. Sem esta alteração, nosso arquivo não seria enviado.
Temos também um campo oculto (), que é responsável por informar ao browser o tamanho máximo permitido. É fácil burlar esta limitação, por isso, no arquivo php.ini há uma limitação de tamanho de upload. Alguns podem perguntar: já que esta limitação é falha, por que utilizá-la? A resposta é simples: informando ao browser um tamanho máximo, o usuário não precisará esperar o arquivo ser enviado para o servidor para depois descobrir que ele era grande demais.
Depois, verificamos se a superglobal $_FILES não está vazia (if(!empty($_FILES))). Caso não esteja, incluímos o arquivo que contém a classe UploadImagem (include ‘classupload.php’;), chamamos a classe ($upload = new UploadImagem();) , determinamos a largura ($upload->width = 250;) e altura ($upload->height = 250;) máximas da nossa imagem e mostramos a mensagem retornada da função salvar (echo $upload->salvar(“upload/”, $_FILES[‘img’]);), passando como parâmetro, o caminho onde nossa imagem será salva (“upload/”) e a superglobal ($_FILES[‘img’]) enviada pelo formulário que a contém.
Fonte: devmedia
Gostei muito do artigo. Realmente estava com essa dificuldade no upload. Muito esclarecedor. Obrigado.
Gostaria de ver esse projeto adaptado para upload de mutiplas imagens, como seria?!