Download the PHP package pavlista/palette without Composer
On this page you can find all versions of the php package pavlista/palette. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package palette
Palette v 2.7.8
PHP rozšíření umožňující pokročilou manipulaci s obrázky, vytváření jejich miniatur a verzí.
K čemu Palette slouží a jak funguje?
- Palette slouží k jednoduchému tvoření různých variant obrázku.
- Varianta daného obrázku je vždy generovaná při první požadavku na požadovanou variantu obrázku.
- Generování varianty obrázku se neprovádí při běhu spušťěného PHP scriptu, Palette pouze vygeneruje url adresu na které bude požadovaná varianta dostupná. Až při naštívění této url se tato varianta (pokud nebyla již vytvořena dříve) vygeneruje. Díky tomuto principu vytváření variant obrázku není problém na jedné stránce generovat klidně 100+ variant bez toho, aby PHP došly prostředky, nebo načítání stránky trvalo delší dobu.
Instalace a nastavení
1. Palette naistalujeme do projektu nejlépe pomocí composeru.
php composer.phar require pavlista/palette2. Vytvoříme instanci služby Palette\Service, která zajišťuje přístup k funkcím Palette.
Třída má pouze jeden povinný parametr a to instanci třídy, která implementuje interface Palette\Generator\IPictureGenerator v Palette je již připravená implementace a to třída Palette\Generator\Server.
Argumenty Palette\Generator\Server jsou:
- storagePath: Relativní nebo absolutní cesta ke složce do které se mají vygenerované miniatury a obrázky ukládat. Tato složka musí existovat a musí být do ní možné zapisovat!
- storageUrl Absolutní url adresa s lomítkem na konci na které je složka s miniatury veřejně dostupná.
- basePath: Absolutní cesta k document rootu webu. Tento parametr je nepovinný.
- signingKey: Jedinečný řetězec, kterým se podepisují požadavky.
Vytvoření instance Palette by tedy mělo vypadat takto:
3. Vytvoříme a připravíme backend pro Palette
V umístění, které jsme si zvolily jako úložiště vygenerovaných variant (storagePath) je nutné vytvořit soubor palette-server.php (jméno může být libovolné), v kterém na instanci služby Palette (Palette\Service) zavoláme metodu serverResponse.
Kód souboru by měl vypadat například takto:
4. Přesměrujeme neexistující soubory a adresáře na backend
V umístění, které jsme si zvolily jako úložiště nastavíme přesměrování všech neexistujících souborů a adresářů na vytvořený soubor s backendem.
Vzorové Nastavení v Apache
Do složky úložiště přidáme následující soubor .httacess:
Vzorové Nastavení Nginx
Do sekce nastavení aktuálního serveru přidáme sekci:
Používání Palette
Varianty obrázku se tvoří ze zdrojového obrázku pomocí zápisu image query. Pomocí image query se určuje které všechny effekty a transformace chceme na obrázek použít a v jakém pořadí to má být.
Zápis Image Query
1) Image query začíná relativní nebo absolutní cestou k souboru zdrojového obrázku, po ní následuje znak @.
Tato část image query nemusí být zadána, pokud již máme nějakým způsobem nastavené z kterého obrázku chceme vytvářet variantu.
Příklad: files/obrazek.png@
2) Po té následuje výčet filtrů které chceme na obrázek aplikovat. Jednotlivé filtry se oddělují znakem & nebo |
Příklad: files/obraze.png@Resize;100;200&Grayscale
Přehled jednotlivých filtrů s popisem a příklady je k nalezení zde.
3) Některé filtry používají parametry, pomocí kterých se nastavují další vlastnosti filtru.
Tyto parametry oddělují pomocí středníku ;.
Příklad: files/obrazek.png@Resize;150&Grayscale&Contrast;-50
4) U některých parametrů filrů které jsou nepovinné, nebo mají defaultní hodnotu lze jejich vyplnění v query přeskočit pomocí střeníku.
Příklad: files/obrazek.png@Resize;150;;crop
Příklady reálného použití V PHP
1) Různé možnosti zápisu pro získání url adresy k obrázku zmenšeného na 150 x 120px:
2) Zápis složitějšího příkazu v image query:
3) Příklad zobrazení miniatury v základním PHP a HTML:
Důležité odkazy
All versions of palette with dependencies
ext-gd Version *
ext-mbstring Version *
ext-json Version *
ext-fileinfo Version *