Componette

Componette

inteve

inteve / simple-image-storage v2.0.0

Simple image storage for Nette

download-cloud-line composer require inteve/simple-image-storage

Simple Image Storage

Image storage for Nette.

Become a Patron! Buy me a coffee

Installation

Download a latest package or use Composer:

composer require inteve/simple-image-storage

Library requires PHP 5.6.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->getRealPath('upload/avatar/image-name.jpg');

Get original public path

<?php
$path = $imageStorage->getPublicPath('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);

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

$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

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, https://www.janpecha.cz/

  • v2.0.0 Version 2.0.0

    • fixed compatibility with PHP 7.2
    • uses Nette\SmartObject instead of Nette\Object
    • requires PHP 5.6 or newer
    • requires Nette 2.4 or newer
  • v1.6.0 Version 1.6.0

    • added support for custom thumbnail generator
  • v1.5.0 Version 1.5.0

    • added getDirectory()
  • v1.4.0 Version 1.4.0

    • added generateFilePath()
  • v1.3.0 Version 1.3.0

    • added getRealThumbnailPath() & getPublicThumbnailPath()
    • added getRealPath(), deprecated getPath()
  • v1.2.0 Version 1.2.0

    • added new method save()
  • v1.1.1 Version 1.1.1

    • Nette\Utils\Strings::random() is deprecated (fixed compatibility with Nette 2.4)
  • v1.1.0 Version 1.1.0

    • upload() - added support for non-standard MIME-types
  • v1.0.0 Version 1.0.0

    First public release.

price-tag-2-line

Badges

guide-fill

Dependencies

php (>=5.6.0)
Componette Componette felix@nette.org