inteve/simple-image-storage

v1.5.0 2017-09-11 09:03 UTC

README

Image storage for Nette.

Installation

Download a latest package or use Composer:

composer require inteve/simple-image-storage

Library requires PHP 5.3.0 or later.

Usage

use Inteve\SimpleImageStorage\ImageStorage;

Register in config

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

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

Store image

<?php
$image = $imageStorage->upload($fileUpload);
// $image = 'image-name.jpg'

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

Delete image

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

Get original path

<?php
$path = $imageStorage->getPath('upload/avatar/image-name.jpg');
// $path = '/path/to/directory/storageName/upload/avatar/image-name.jpg'

Get original public path

<?php
$path = $imageStorage->getPublicPath('upload/avatar/image-name.jpg');
// $path = 'http://www.example.com/storageName/upload/avatar/image-name.jpg'

Thumbnails

<?php
$path = $imageStorage->thumbnail($file, $width, $height, $flags = NULL, $quality = NULL);
$path = $imageStorage->thumbnail('upload/avatar/image-name.jpg', 512, 256);
// $path = 'http://www.example.com/storageName/upload/avatar/image-name.jpg'

In template

class BasePresenter extends Nette\Application\UI\Presenter
{
	/** @var  Inteve\SimpleImageStorage\ImageStorage  @inject */
	public $imageStorage;


	protected function beforeRender()
	{
		parent::beforeRender();
		$this->template->img = $this->imageStorage;
	}
}
<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, http://www.janpecha.cz/