inteve / simple-image-storage
Simple image storage for Nette
Installs: 2 122
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: >=5.6.0
- nette/http: ^2.4
- nette/utils: ^2.4
README
Image storage for Nette.
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 imagestring $outputPath
- thumbnail patharray $thumbnailData
int|NULL width
- width of thumbnail or NULLint|NULL height
- height of thumbnail or NULLint|NULL quality
- quality of output image or NULLint 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/