Simple Image Storage

Image storage for Nette., _(*1)

, _(*2)

Installation

Download a latest package or use Composer:, _(*3)

composer require inteve/simple-image-storage

Library requires PHP 5.6.0 or later., _(*4)

Usage

``` php use Inteve\SimpleImageStorage\ImageStorage;, _(*5)



### Register in config

``` yaml
parameters:
    imageStorage:
        directory: %wwwDir%
        publicDirectory: @httpRequest::getUrl()::getBaseUrl()
        storageName: images # optional

services:
    - Inteve\SimpleImageStorage\ImageStorage(%imageStorage.directory%, %imageStorage.publicDirectory%, %imageStorage.storageName%)

Store image

``` php <?php $image = $imageStorage->upload($fileUpload); // $image = 'image-name.jpg', _(*6)

$avatar = $imageStorage->upload($fileUpload, 'upload/avatars'); // $avatar = 'upload/avatars/image-name.jpg';, _(*7)



### Delete image

``` php
<?php
$imageStorage->delete('upload/avatar/image-name.jpg');

Get original path

``` php <?php $path = $imageStorage->getRealPath('upload/avatar/image-name.jpg');, _(*8)



### Get original public path

``` php
<?php
$path = $imageStorage->getPublicPath('upload/avatar/image-name.jpg');

Thumbnails

``` php <?php $path = $imageStorage->thumbnail($file, $width, $height, $flags = NULL, $quality = NULL); $path = $imageStorage->thumbnail('upload/avatar/image-name.jpg', 512, 256);, _(*9)


It uses `Nette\Utils\Image` by default but you can provide custom thumbnail generator in constructor:

``` php
$imageStorage = new ImageStorage(..., ..., ..., function ($sourcePath, $outputPath, array $thumbnailData) {
    $im = new Imagick;
    $im->readImage($sourcePath);
    $im->crop(...);
    $im->writeImage($outputPath);
});

string $sourcePath - path to original image
string $outputPath - thumbnail path
array $thumbnailData
- int|NULL width - width of thumbnail or NULL
- int|NULL height - height of thumbnail or NULL
- int|NULL quality - quality of output image or NULL
- int flags - see constants ImageStorage::SHRINK_ONLY, STRETCH, FIT, FILL & EXACT

In template

``` php class BasePresenter extends Nette\Application\UI\Presenter { /** @var Inteve\SimpleImageStorage\ImageStorage @inject */ public $imageStorage;, _(*10)

protected function beforeRender()
{
    parent::beforeRender();
    $this->template->img = $this->imageStorage;
}

}, _(*11)


``` smarty
<img src="{$img->thumbnail($avatar, 512, 256)}">
<img src="{$img->thumbnail($avatar, 512, 256, $img::SHRINK_ONLY)}">
<img src="{$img->thumbnail($avatar, 512, 256, $img::STRETCH)}">
<img src="{$img->thumbnail($avatar, 512, 256, $img::FILL)}">
<img src="{$img->thumbnail($avatar, 512, 256, $img::EXACT)}">

License: New BSD License
Author: Jan Pecha, https://www.janpecha.cz/, _(*12)