wiidoo/file-manager

File Manager uploaded to laravel

0.1.6 2016-04-07 22:38 UTC

Requires

• php: ^5.5 || ^7.0
• intervention/image: ^2.3
• intervention/imagecache: ^2.3
• wiidoo/support: ^0.1.0

MIT

• Philippe Assis

• file
• manager

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]
    ];