lawondyss / imager
The library for manage images and thumbnails. Library uses ImageMagick in command line.
1.6.2
2016-10-15 16:30 UTC
Requires
- nette/utils: ~2.3
Requires (Dev)
- nette/application: 2.4.*
- nette/tester: 1.7.*
README
Imager is manager for images and thumbnails.
Installation
Installation performed by Composer. Write to command line composer require lawondyss/imager
.
CAUTION
Library used ImageMagick over command line. Is necessary have ImageMagick installed in system.
Generating image cannot be greater than 200 % of original image.
Examples
Create thumbnails
// Image accepts argument of image as instance of class Imager\ImageInfo (extends SplFileInfo) $imageInfo = new Imager\ImageInfo('path/to/image.jpg'); $image = new Imager\Image($imageInfo); // create over factory // ImageFactory::create() accepts image name in string or instance of ImageInfo $factory = new Imager\ImageFactory; $image = $factory->create('path/to/image.jpg'); /** Thumbnails **/ // resize by width $thumb = $image->resize(100); // instance of Imager\ImageInfo with temporary image var_dump($thumb->getPathname()); // path to thumbnail // resize by height $thumb = $image->resize(null, 100); // resize with crop, cropped image is centered $thumb = $image->resize(100, 100); // origin dimensions $thumb = $image->resize(0, 0); /** Quality **/ // set in third parameter, lower is worse, 0 is default quality $thumb = $image->resize(0, 0, 25); /** Send image to output **/ header('Content-Type: ' . $thumb->getMime()); header('Content-Length: ' . $thumb->getSize()); echo $thumb->getContent();
Repository for sources images and thumbnails
$factory = new Imager\ImageFactory; // first argument is required; is directory with sources // second argument is optional; is directory for thumbnails; if not set, then is same as directory for sources; autocreated $repository = new Imager\Repository('path/to/sources', 'path/to/thumbnails'); // create ImageInfo of source image $uploadImageInfo = $factory->createInfo('path/to/uploaded/image.jpg'); // source image has not source, therefore save to sources directory // second optional argument defined new name for saved image $sourceImageInfo = $repository->save($uploadImageInfo, 'image.jpg'); // instance of Imager\ImageInfo with saved source image // fetch source image only by name $imageInfo = $repository->fetch('image.jpg'); // instance of Imager\ImageInfo with source image // created thumbnail $thumb = $factory->create($imageInfo)->resize(100); // instance of Imager\ImageInfo with temporary thumbnail of image // thumbnail has source, therefore save to thumbnails directory $thumbImageInfo = $repository->save($thumb); // instance of Imager\ImageInfo with saved thumbnail
Nette extension
For registration Imager as Nette extension is required add this configuration.
extensions: imager: Imager\DI\Extension
Extension has this configuration:
imager: sourcesDir: %appDir%/../cdn/assets # required thumbsDir: %wwwDir%/images/thumbs baseUrl: http://cdn.example.com # if is your images in another URL basePath: images/thumbs/ # required; adds this path to URL errorImage: on # default on; displays error image if when generating an error occurred debugger: on # default as debugMode; display information in debug bar; WARNING! For every image send new HEAD request!
Example with extension
Presenter for upload and show images
class ImagerPresenter extends BasePresenter { /** @var \Imager\Repository @inject */ public $repository; /** @var \Imager\ImageFactory @inject */ public $factory; public function renderDefault($id) { if (isset($id)) { $this->template->imageFromString = $id; $this->template->imageFromRepository = $this->repository->fetch($id); } } protected function createComponentUploadForm() { $control = new Nette\Application\UI\Form; $control->addUpload('photo') ->setRequired(); $control->addSubmit('load', 'load image'); $control->onSuccess[] = $this->uploadFormSucceed; return $control; } public function uploadFormSucceed(Nette\Application\UI\Form $form, $values) { $upload = $this->factory->createInfo($values->photo->getTemporaryFile()); $source = $this->repository->save($upload); $this->redirect('default', $source->getFilename()); } }
Latte template
{block content}
{control uploadForm}
{ifset $image}
<img n:src="$imageFromRepository, 200, 0"> {* set width, origin height *}
<img n:src="$imageFromRepository, 200, 300"> {* set width and height *}
<img n:src="$imageFromRepository, null, 300"> {* resize by height *}
<img n:src="$imageFromRepository, 200"> {* resize by width *}
<img n:src="$imageFromRepository"> {* origin width and height *}
{* set quality *}
<img n:src="$imageFromRepository, null, null, 25"> {* origin width and height, but lowest quality *}
{* same parameters as for $imageFromRepository *}
<img n:src="$imageFromString">
{/ifset}
Link to image
If you required create link to image (example to e-mail), then is here method ImageFactory::createLink()
.
Create a link is only possible when integrating into the Nette.
class EmailPresenter extends BasePresenter { /** @var \Imager\ImageFactory @inject */ public $factory; public function actionSendEmail($email) { // ... defines $images as array with Imager\ImageInfo objects or names of images $linksHtml = []; foreach ($images as $image) { $linksHtml = $this->createImg($this, $image); } // ... functionality for send e-mail } private function createImg($image, $width = null, $height = null) { $link = $this->factory->createLink($this, $image, $width, $height); $img = Nette\Utils\Html::el('img', ['src' => $link]); return $img->render(); } }