Statistics
51
3
2
70d
Badges

Resize

High Performance Image Processing Component for Nette Framework

Build Status Coverage Status Code Climate Scrutinizer Code Quality

Installation

Download the latest package manually or better use the composer

composer require rostenkowski/resize

Configuration

The best way is to use the built-in Nette DI container extension in application configuration, usually located in app/config.neon. You can place the imageStore part of the configuration to your local configuration file.

extensions:
    resize: Rostenkowski\Resize\Extension

resize:
    storageDir: %baseDir%/data/images
    cacheDir:   %baseDir%/www/images
    basePath:   /images/

Manual configuration

If you aren't using the the DI extension the image macros should be registered to the Latte engine as described in the docs:

nette:
    latte:
        macros:
            - Rostenkowski\Resize\Macro\ImageMacro::install

The storage can be created manually in presenter or registered as service this way:

services:
    - images: Rostenkowski\ImageStore\ImageStorage("%baseDir%/data/images", "%baseDir%/www/images", "/images/")

Requirements

  • PHP Suggested 5.6, Minimal 5.5
  • Nette Suggested 2.3, Minimal 2.2

The library is tested against PHP 5.5, 5.6 and 7.0 and Nette 2.3 but it should be compatible with previous stable Nette 2.2 and the latest Nette 2.4-dev as well.

For the full list of dependencies see the composer.json file.

API

For the full API documentation navigate to the docs/api/ directory and open index.html file.

Storage

<?php

use Rostenkowski\Resize\Meta;
use Rostenkowski\Resize\File;
use Rostenkowski\Resize\Request;
use Rostenkowski\Resize\ImageStorage;
use Nette\Application\Responses\FileResponse;
use Nette\Http\FileUpload;
use Nette\Utils\Image;

// create storage
$storage = new ImageStorage('/data/images', '/www/images', '/images/');

// add an image from file
$storage->add(File $image, Meta $meta);

// add a HTTP uploaded file
$storage->upload(FileUpload $file, Meta $meta);

// check that an image already exists in the storage
$storage->contains(Meta $meta);

// fetch original
$storage->original(Meta $meta);

// rotate image
$storage->rotate(Meta $meta, 90); // Meta

// downloaded requested thumbnail
$storage->download(Request $request); // Nette\Application\Responses\FileResponse

// fetch requested thumbnail
$storage->fetch(Request $request);

// link requested thumbnail
$storage->link(Request $request);

// output requested thumbnail to stdout
$storage->send(Request $request);

Technical overview

  • The images are stored in regular files in the given directory.
  • The files are organized in a directory tree with maximum of 256² directories in two level structure so with ~1K files in a directory the storage is able to store ~6.5M of images without performance impact.
  • The directory tree is well balanced thanks to image hashes used for the directory path creation.
  • The storage stores only one file even if the same image is stored multiple times.
  • The image thumbnails are created on demand and cached in the cache directory.

Contribution

Feel free to open an Issue or Pull Request.

The source code of the library is fully covered by Nette Tester tests.

To run the test suite simply install the dependencies using composer and then run the bin/run-tests.sh script on linux. On windows u can run in eg. git bash: bin/run-tests-win.sh.

bin/run-tests.sh
 _____ ___  ___ _____ ___  ___
|_   _/ __)( __/_   _/ __)| _ )
  |_| \___ /___) |_| \___ |_|_\  v2.0.x

PHP 5.6.5 (cgi-fcgi) | php-cgi -n -c tests/php.ini | 1 thread

.............

OK (13 tests, 2.7 seconds)

To check the code coverage see the docs/coverage.html file.

Example code

Please see the Usage wiki page.

  • v4.0 PHP 7

  • v3.0.8

  • v3.0.7

  • v3.0.6

  • v3.0.5 PHP 7

  • v3.0.4

  • v3.0.3

  • v3.0.2 PHP 7.1 compatibility

  • v3.0.1 PHP 7.1 compatibility

  • 3.0.0 v3.0.0

  • v2.1 Version 2.1

    fixed php.ini used for the code coverage report (PHP 7 compatibility)
    fixed ignoring of temporary stuff

  • v1.9.1 Version 1.9.1

    • added test for Storage::add() with image downloaded from URL
    • libraries updated
    • tests updated
  • v2.0.0 Version 2.0

    • added test for Storage::add() with image downloaded from URL
    • libraries updated
    • tests updated
  • v1.9 version 1.9

    version 1.9

  • v1.8 version 1.8

    version 1.8

  • v1.7 docs

  • v1.6 version 1.6

  • v1.5 added ability to rotate image

  • v1.4 added Nette DI Extension

  • v1.3 version 1.3

  • v1.2 Windows compatibility

  • v1.1

    version 1.1

Is this addon outdated? Did you find an issue? Please report it.

Componette Componette admin@componette.com