README

Gerenciador de arquivos carregados para laravel. Gera um novo ambiente amigavél para tratamento de arquivos carregados, edição de imagens e outras manipulações para diversos tipos e extenções de arquivos.

Instalação

Via composer

composer required wiidoo/filemanager

Por padrão o diretório de arquivos carregados é storage/upload, isso pode ser alterado no arquivo de configurações.

Crie o diretório de arquivos carregados

mkdir storage/uploads

Esse diretório deve ter permissão de leitura e escrita, em caso de dúvida, algo como isso deve ajudar:

chmod -R 777 storage/uploads

Arquivo de configuração

Você pode alterar as configurações padrões dessa biblioteca em config/wiidoo.php (Illuminate\Support\Facades\Config::get("wiidoo.filemanager")). Nesse arquivo, você pode criar valores padrões para todas as propriedades tanto publicas (public) como protegidas (protected) das classes dessa biblioteca.

Exemplo:

<?php

return [
    'filemanager' => [
        'upload' => [
            'basePath' => storage_path('arquivos') //padrão storage_path('uploads')
        ],
        'image' => []
    ]
];

Wiidoo\FileManager\Upload

Tem como foco resumir o trabalho de mover e renomear arquivos carregados a partir de Illuminate\Http\Request. É usado como base para outras classes dessa biblioteca.

Estrutura

Propriedades

Propiedade	Valor	Descrição
$name	`null`	Nome do arquivo
$sufix	`' (%number%)'`	Carcteres adicionais concatenados como sufixo do nome caso um arquivo com o mesmo nome já exista. Você pode implementar adicionando a variavel curinga `%number%`, exemplo `' - %number%'`.
$overwrite	`false`	Caso `true` sobrescreve arquivos se eles existirem
$basePath	`storage_path('uploads')`	`storage_path('uploads')`
$useRelativePath	`true`	Usar caminhos relativos no metodo de seleção de diretório `dir()`
$forceCreateDir	`true`	Força a criação de diretórios declarados caso eles não existão

Métodos

Método	Descrição
`file($key = null, $default = null)`	Define o arquivo de entrada.
`dir($directory, $forceCreate = true)`	Define o diretório do arquivo em `$directory` e força a criação do mesmo caso não exista em `$forceCreate`.
`path($directory, $forceCreate = true)`	Um link para `dir()`.
`name($name, $ext = true)`	Define o nome do arquivo quando salvo em `$name`. $ext permite herdar a extenssão do arquivo carregado.
`unique()`	O mesmo que $overwrite = true;
`overwrite()`	O mesmo que $overwrite = true;
`prepare($callback)`	Executa uma função depois das instruções serem definidas, porém antes serem finalizadas
`save()`	Salva o arquivo
`forceCreateFolder($mode = 0777, $recursive = true)`	Força a criação de um diretório ou arquivo

Wiidoo\FileManager\Image

Manipula a imagem facilitando a aplicação de filtros, redimensionamentos e multiplos salvamentos

Estrutura

Herda metodos e propriedades de Upload.

Propriedades

Propriedade	Valor	Descrição
$saveOriginal	`null`	Se `true` gera salva o arquivo original no diretório declado em `dir()`.
$mode	`0777`	Ajusta permissão dos arquivos e diretórios gerados pela classe.
$quality	`80`	Qualidade em que a imagem editada será salva.
$size	array sizes	Listagem de tamanhos de imagem

Métodos

Método	Descrição
`manySizes($sizes, $filter = 'Resize', $dir = '')`	Permite o multi-redimensionamento do arquivo, gerando arquivos com seus respectivos tamanhos em diretórios nominados.
`filter(Array	String $filters, $complement = null)`
`make($callback = null)`	Permite a manipulação do arquivo após ser definido como um `Intervention\Image`.
`image($key = false)`	Pega o retorno de uma imagem gerada.
`contentType($type = null)`	Define o contentType da página baseado no mimeType do arquivo.
`encode()`	Retorna o arquivo pronto para ser exibido.
`data($type = 'all')`	Retorna todos os dados disponíveis do arquivo manipulado e suas ramificações. Recebe dois tipos de instrução `all` para retornar todas as informações disponíveis e `simple` para retornar as principais informações sobre os arquivos gerados, como nome, diretório relativo e caminho real do arquivo.
`success()`	Para uso com Ajax, retorna um array dois ponteiros: `success:true` e `data('simple')`

Wiidoo\FileManager\Image\ManySizes

Links para declaração do metodo manySizes() com filtros padrões da classe

Estrutura

####Métodos

Métodos	Descrição
`resize($sizes, $dir = 'resize')`	Redimensiona imagens aplicando o filtro `Resize`
`fit($sizes, $dir = 'fit')`	Redimensiona imagens aplicando o filtro `Fit`
`canvas($sizes, $dir = 'canvas')`	Redimensiona imagens aplicando o filtro `Canvas`

A fazer

Adicionar recursos para leitor de PDF
Adicionar recursos para leitores e geradores de .xls

Adicional

$sizes

Por padão a propriedade sizes recebe esses tamanhos

public $sizes = [
        'favicon' => [16, 16],
        'icon' => [64, 64],
        'icon_h' => [null, 64],
        'icon_w' => [64, null],
        'thumb' => [256, 256],
        'thumb_h' => [null, 256],
        'thumb_w' => [256, null],
        'medium' => [800, 800],
        'medium_h' => [null, 800],
        'medium_w' => [800, null],
        'large' => [1200, 1200],
        'large_h' => [null, 1200],
        'large_w' => [1200, null],
        'xlarge' => [1980, 1980],
        'xlarge_h' => [null, 1980],
        'xlarge_w' => [1980, null]
    ];

wiidoo / file-manager

Maintainers

Details

README

Instalação

Arquivo de configuração

Wiidoo\FileManager\Upload

Estrutura

Propriedades

Métodos

Wiidoo\FileManager\Image

Estrutura

Propriedades

Métodos

Wiidoo\FileManager\Image\ManySizes

Estrutura

A fazer

Adicional

$sizes