library images {🖫 6,880, ⚐ 24, ★ 33}

webchemistry/images

Image storage for easier uploading, deleting and manipulation.

Wednesday, August 1, 2018
by Antik
Repository
8 Watchers
33 Stars
6,880 Installations

PHP
1 Dependents
1 Suggesters
10 Forks
2 Open issues
24 Versions
4 % Grown

The README.md

, _(*1)

Deprecated

Tento balíček se už dále vyvíjet nebude, budou maximálně opravy chyb. Použijte proto velmi podobný balíček https://github.com/contributte/imagist, který je bohatější., _(*2)

Instalace

Composer:, _(*3)

composer require webchemistry/images

config:, _(*4)

extensions:
    images: WebChemistry\Images\DI\ImagesExtension

Konfigurace

enable: yes
defaultImage: null
wwwDir: %wwwDir%
assetsDir: assets
modifiers: []
aliases: []
hashResolver: WebChemistry\Images\Resolvers\HashResolver ## Vysvětleno níže
namespaceResolver: WebChemistry\Images\Resolvers\NamespaceResolver ## Vysvětleno níže
registerControl: yes ## Zaregistruje UploadControl
registerType: yes ## Zaregistruje doctrine typ 'image' 
safeLink: %productionMode% ## metoda link() se zotavuje z chyb a loguje tyto chyby do tracy, web nespadne do 500 kvůli chybnému obrázku

Skladba cesty k obrázků

%wwwDir%/%assetsDir%/namespace/resize/image.png %wwwDir%/%assetsDir%/namespace/original/image.png, _(*5)

namespace/ - Má na starosti třída namespaceResolver resize/ - Má na starosti třída hashResolver, _(*6)

Tvorba aliasů

Aliasy umožnují snadnou modifikací obrazků, _(*7)

Použití jednoho modifieru, _(*8)

local:
    aliases:
      myAlias: "resize:12,50"

Více modifierů, _(*9)

local:
    aliases:
      myAlias: "resize:12,50,exact|sharpen"

Použití polí, _(*10)

cloudinary:
    aliases:
      myAlias: "border:[width: 4, color: #553311]"

Použití proměnných, _(*11)

local:
    aliases:
      resizeExact: "resize:$1,$2,exact"
      resize: "resize:$1,$2,$3"
      resizeSquare: "resize:$1,$1,exact"

Vlastní modifiery

V konfiguraci stačí zaregistrovat loader, _(*12)

local:
    modifiers:
      - ModifiersLoader

vytvořit třídu a přidávat modifiery, _(*13)

class ModifiersLoader implements WebChemistry\Images\Modifiers\ILoader {

    public function load(WebChemistry\Images\Modifiers\ModifierContainer $modifierContainer) {
        $modifierContainer->addModifier('custom', function (ModifierParam $param, $foo) {
            // zpracovani obrazku $param->getImage()
        });
    }

}

a použití, _(*14)

local:
    aliases:
      custom: "custom:param1"

Ukladaní obrázků

$upload - Instance Nette\Utils\Upload $location - Cesta obrázku uložená v řetězci $storage - Instance WebChemistry\Images\IImageStorage, _(*15)

Nette upload, _(*16)

// vytvorime zdroj pro obrazek
$resource = $storage->createUploadResource($upload);
// nebo z cesty
$resource = $storage->createLocalResource($location);

// pridame namespace
$resource->setNamespace('namespace');

// ulozime
$result = $storage->save($resource);

// zobrazime url adresu
echo $storage->link($result);

Před nahráním obrázku ho můžeme upravit, _(*17)

$resource->setAlias("custom");

// Kombinace více aliasů
$resource->setAliases(["custom", "custom2"]);

$id = $resource->getId(); // Ziskání id
// nebo
$id = (string) $resource;

Obrázek se uloží v namespace/original/obrazek.jpg, _(*18)

Získávání obrázků

$id Identifikátor ziskány z uloženeho obrázku viz sekce ukládání obrázků, _(*19)

$resource = $storage->createResource($id);

$link = $storage->link($resource);

Kopírování obrázků

$id Identifikátor ziskány z uloženeho obrázku viz sekce ukládání obrázků, _(*20)

$resource = $storage->createResource($id);
$dest = $storage->createResource("namespace/obrazek.jpg"); 

// Muzeme zmodifikovat
$dest->setAlias("custom");

$storage->copy($resource, $dest);

Zkopíruje se jen originální obrázek a v případně se zmodifikuje., _(*21)

Přesouvání obrázků

$id Identifikátor ziskány z uloženeho obrázku viz sekce ukládání obrázků, _(*22)

$resource = $storage->createResource($id);
$dest = $storage->createResource("namespace/obrazek.jpg"); 

// Muzeme zmodifikovat
$dest->setAlias("custom");

$storage->move($resource, $dest);

Odstranění obrázků

$id Identifikátor ziskány z uloženeho obrázku viz sekce ukládání obrázků, _(*23)

$resource = $storage->createResource($id);

$storage->delete($id);

Odstraní se jak originální obrázek, tak i jeho modifikace., _(*24)

Modifikace obrázků

$id Identifikátor ziskány z uloženeho obrázku viz sekce ukládání obrázků, _(*25)

1) Uložením, _(*26)

$resource = $storage->createResource($id);
$resource->setAlias("custom");
$storage->save($resource);

Uloží se do namespace/custom/obrazek.jpg, _(*27)

2) Získáním adresy, _(*28)

$resource = $storage->createResource($id);
$resource->setAlias("custom");
echo $storage->link($resource);

Uloží se do namespace/custom/obrazek.jpg, _(*29)

Šablony

Zobrazení obrázku, _(*30)

{img 'image.jpg'}
<img n:img="'image.jpg'">

Zobrazení s použitím modifikátorů obrázků, _(*31)

{img 'image.jpg', custom}
<img n:img="'image.jpg', custom">

{* Kombinace dvou aliasů *}
{img image.jpg, custom, custom1}

{* Použití proměnných v aliasu *}
{img $resource, customVariables(15,15,exact)}

Dávkování obrázků

$batch = $storage->createBatch();

$entity->image = $batch->save($resource);
$this->em->persist($entity);

$entity2->image = $batch->save($resource2);
$this->em->persist($entity2);

$batch->flush();
$this->em->flush();

Formuláře

Automatickou registraci provede extenze. S touto komponentou odpadá povinnost vytvoření třídy pro obrázek., _(*32)

$form->addImageUpload('image', 'Obrazek')
    ->setRequired()
    ->setNamespace('namespace');

$form->onSuccess[] = function ($form, array $values) use ($storage) {
    $storage->save($values['image']);
};

Pro náhledový obrázek a input pro odstranění obrázků:, _(*33)

$form->addImageUpload('image', 'Obrázek')
    ->setDelete('Odstranit obrázek')
    ->setNamespace('namespace');

$form->onSuccess[] = function ($form, array $values) use ($storage) {
    $image = $values['image'];
    if ($image->getDelete()) {
        $storage->delete($image->getDelete());
    }
    if ($image->getUpload()) {
        $resource = $storage->save($image->getUpload());
    } else {
        $resource = $image->getDefaultValue();
    }
};

Doctrine typ

Automatickou registraci provede extenze. Položku pro obrázek lze vytvořit přes anotaci typ image:, _(*34)

class Entity {

    /**
     * @ORM\Column(type="image")
     */
    protected $image;

}

nullable=true změna obrázku z povinného na nepovinný, _(*35)

Uložení nového obrázku, bere jen instaci IFileStorage nebo NULL v případě nastaveného nullable v anotaci Column, _(*36)

$form->onSuccess[] = function ($form, $values) {
    $en = new Entity();
    $en->image = $this->storage->save($values->image);

    $this->em->persist($en);
    $this->em->flush();
};

Získání obrázku, _(*37)

$en = $this->em->getRepository(Entity::class)->find(1);
if ($en->image !== NULL) { // V pripade nullable
    $link = $this->storage->link($en->image);
}

The Versions

01/08 2018

dev-master

9999999-dev

Image storage for easier uploading, deleting and manipulation.

library images

Image storage for easier uploading, deleting and manipulation.

webchemistry/images

The README.md

Deprecated

Instalace

Konfigurace

Skladba cesty k obrázků

Tvorba aliasů

Vlastní modifiery

Ukladaní obrázků

Získávání obrázků

Kopírování obrázků

Přesouvání obrázků

Odstranění obrázků

Modifikace obrázků

Šablony

Dávkování obrázků

Formuláře

Doctrine typ

The Versions

dev-master

The Requires

The Development Requires

by Antik

4.0.0

The Requires

The Development Requires

v3.x-dev

The Requires

The Development Requires

by Antik

3.0.1

The Requires

The Development Requires

by Antik

3.0

The Requires

The Development Requires

by Antik

3.0-beta

The Requires

The Development Requires

by Antik

v2.2.x-dev

The Requires

The Development Requires

by Antik

v2.1.x-dev

The Requires

The Development Requires

by Antik

2.1.4

The Requires

The Development Requires

by Antik

2.1.3

The Requires

The Development Requires

by Antik

2.1.2

The Requires

The Development Requires

by Antik

2.1.1

The Requires

The Development Requires

by Antik

2.1

The Requires

The Development Requires

by Antik

2.0

by Antik

1.0.x-dev

by Antik

1.4.3

by Antik

1.4.2

by Antik