pvlima/img-manager

Plugin para gerenciamento e upload de imagens

pvlima/img-manager

Plugin para gerenciamento e upload de imagens. Muito simples e fácil de utilizar em qualquer projeto., _(*1)

Instalação

É recomendável instalar o pacote usando o composer. Basta digitar o seguinte comando no terminal:, _(*2)

  composer require pvlima/img-manager

Pré-requisitos

É necessário estar com a biblioteca GD ativada no php, _(*3)

Descomentar a seguinte linha no arquivo php.ini, _(*4)

  ;extension=php_gd2.dll

Basta retirar o ponto e vírgula ";" no início da linha e em seguida, reiniciar o servidor, _(*5)

Exemplo:

### Formulário HTML, _(*6)

<form action="" method="post" enctype="multipart/form-data">
    <input type="file" name="img">
    <input type="submit" value="Enviar" name="submit">
</form>

### Arquivo PHP, _(*7)

O construtor da classe Pvlima\ImgManager\ImgManager() deve receber uma imagem codificada em base64, pois agiliza todo o processo, além de facilitar a implementação com plugins javascript no front-end, já que a maioria deles repassa ao back-end justamente uma imagem codificada em base64. Caso você não esteja trabalhando com nenhum plugin no front-end (como plugins de corte, por exemplo) você deve codificar a imagem no próprio PHP. Como no exemplo:, _(*8)

include 'vendor/autoload.php';

$data = base64_encode(file_get_contents($_FILES['img']['tmp_name']));

$img = new Pvlima\ImgManager\ImgManager($data);

#Diretório onde a imagem vai ser salva
$img->setFilePath(__DIR__ . '/imgs');

#Salva a imagem e retorna o nome do arquivo
echo $img->save();

### Outras Configurações, _(*9)

include 'vendor/autoload.php';

$data = base64_encode(file_get_contents($_FILES['img']['tmp_name']));

$img = new Pvlima\ImgManager\ImgManager($data);

O segundo parâmetro de ->setFilePath() é o nome personalizado do arquivo (Opcional), _(*10)

  $img->setFilePath(__DIR__ . '/imgs', 'nome-da-imagem')

Você pode também especificar a extensão de saída da imagem (".png", ".gif", ".wbmp"). O padrão é ".jpg", _(*11)

->setExt('.png')

Resolução da imagem (largura, altura) em pixels. O segundo parâmetro (altura) é opcional, ou seja, se não for informado, será calculado um valor proporcional à imagem original. Se for informado e não estiver dentro das proporções, a imagem porderá ser cortada mirando o centro, a não ser que a função ->distort() seja chamada logo em seguida, pois nesse caso, a imagem será distorcida., _(*12)

->setResolution(640)

OU, _(*13)

->setResolution(640, 800)

Para que a imagem sejá distorcida e não seja cortada, caso os valores de largura e altura não estiverem nas proporções:, _(*14)

->distort()

Salva a imagem e retorna o nome do arquivo, _(*15)

echo $img->save();