BowTieImages

Installation

1) Na instalaci použíjte Composer:, _(*1)

$ composer require mamiksik/bowtie-images @dev

2) Registruje extension v config.neon:, _(*2)

extensions:
    bowtieImages: BowtieImages\ImageExtension

3) Užíjte si Just-in-time generování obrázků!, _(*3)

About

BowtieImages(BTI) je JIT generátor pro různé velikosti obrázku., _(*4)

Cache

Veškeré vygenerované obrázky jsou uloženy. Tím, že se obrázky uloží do cache zvýšíme razantně rychlost načítání. Skvěle je zde vyřešena i invalidace nepoužívaných obrázků., _(*5)

Životní cyklus

Request pro požadovanou velikost.
Provider se pokusí nalézt odpovídající obrázek v cache.
1. Obrázek byl nalezen v cache, odešle se.
2. Obrázek nebyl nalezen v cache, vyhledá se originál, vygeneruje se požadovaná velikost, uloží se do cache a obrázek se odešle.

Použití

example.cz/images/WidthxHeight/flag/nameOfimage.type

url prefix "images" je konfigurovatelný (více sekce config)
šířka[width] a výška[height] jsou volitelné (lze uvést i pouze šířku)
flag je volitený, implementovány jsou tyto: fit(výchozí), fill, exact(vyžaduje šířku i výšku) a stretch(vyžaduje šířku i výšku) (v pozadí se používá nette Image)

Routa v "nette/route" zápisu

/<namespace>[/<width>x[<height>]][/<flag>]/<filename><type .png|.gif|.jpg|.jpeg>

Storage

Je jednoduchý nástroj pro ukládání a mazání originálních obrázků, _(*6)

Config

BTI lze konfigurovat, ale není to nuté. Vše funguje "out of the box"., _(*7)

bowtieImages:
    tempDir: %tempDir%
    wwwDir: %wwwDir%
    urlPrefix: images #prefix v url
    dataPrefix: data #prefix pro www složku. Nesmí být stejné jako urlPrefix!
    cacheInvalidationTime: 7 days #nette cache expire time

Cache používá Cache:SLIDING, takže pokaždém načtení konkrétního obrázku je expirace pro konkrétní obrázek resetována a navíc Cache:FILES což zapřičiní že po smazání originálu se smažou i ostatní verze obrázku., _(*8)

Co je v plánu

Testy, testy a texy! :), _(*9)

Pravidla pro velikosti generovaných obrázků, _(*10)

Rozhraní pro ukládání, obměnu, či mazání originálních položek, _(*11)

Podpora pro latte, s možnosti volby LQIP, _(*12)

20/09 2016

dev-master

9999999-dev

Just-in-time images generator for Nette Framework

Sources Download

BSD-3-Clause

The Requires

by Martin Mikšík

routing nette images jit

library bowtie-images