Use the powerful imagick to easily generate combined thumbnails under PHP, imagick thumbnails_PHP tutorial

<code class="language-meta">project: blog
target: use-imagick-to-composite-images-thumbnail.md
date: 2016-02-19
status: publish
tags:
    - php
    - imagick
    - thumbnail
categories:
    - php
</code>

<code class="language-sh">sudo pecl install imagick
</code>

<code class="language-php">namespace \clarence\thumbnail;
class Thumbnail extends \Imagick
{
    /**
     * @param array $images
     * @param int $width
     * @param int $height
     * @return static
     * @throws ThumbnailException
     */
    public static function createFromImages($images, $width, $height){
        if (empty($images)){
            throw new ThumbnailException("No images!");
        }

        $thumbnail = new static();
        $thumbnail->newImage($width, $height, &#39;white&#39;, &#39;jpg&#39;);
        $thumbnail->compositeImages($images);

        return $thumbnail;
    }

    public function compositeImages($images){
        $imagesKeys = array_keys($images);
        $compositeConfig = $this->calcCompositeImagesPosAndSize($images);

        foreach ($compositeConfig as $index => $cfg){
            $imgKey = $imagesKeys[$index];
            $img = new \Imagick($images[$imgKey]);
            $img = $this->makeCompositeThumbnail($img, $cfg);
            $this->compositeImage($img, self::COMPOSITE_OVER, $cfg[&#39;to&#39;][&#39;x&#39;], $cfg[&#39;to&#39;][&#39;y&#39;]);
        }
    }

    protected function makeCompositeThumbnail(\Imagick $img, $cfg){
        $img->cropThumbnailImage($cfg[&#39;size&#39;][&#39;width&#39;], $cfg[&#39;size&#39;][&#39;height&#39;]);
        return $img;
    }

    protected function calcCompositeImagesPosAndSize($images){
        $width = $this->getImageWidth();
        $height = $this->getImageHeight();

        switch(count($images)){
            case 0:
                throw new ThumbnailException("No images!");
            case 1:
                // | 0 |
                return [
                    0 => [
                        &#39;to&#39; => [ &#39;x&#39; => 0, &#39;y&#39; => 0 ],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width,
                            &#39;height&#39; => $height,
                        ]
                    ]
                ];
            case 2:
                // | 0 | 1 |
                return [
                    0 => [
                        &#39;to&#39; => [ &#39;x&#39; => 0, &#39;y&#39; => 0 ],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height,
                        ]
                    ],
                    1 => [
                        &#39;to&#39; => [ &#39;x&#39; => $width / 2, &#39;y&#39; => 0],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height,
                        ]
                    ]
                ];
            case 3:
                // | 0 | 1 |
                // | 2 |   |
                return [
                    0 => [
                        &#39;to&#39; => [ &#39;x&#39; => 0, &#39;y&#39; => 0 ],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height / 2,
                        ]
                    ],
                    1 => [
                        &#39;to&#39; => [ &#39;x&#39; => $width / 2, &#39;y&#39; => 0],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height,
                        ]
                    ],
                    2 => [
                        &#39;to&#39; => [ &#39;x&#39; => 0, &#39;y&#39; => $height / 2 ],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height / 2,
                        ]
                    ],
                ];
            default:
                // >= 4:
                // | 0 | 1 |
                // | 2 | 3 |
                return [
                    0 => [
                        &#39;to&#39; => [ &#39;x&#39; => 0, &#39;y&#39; => 0 ],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height / 2,
                        ]
                    ],
                    1 => [
                        &#39;to&#39; => [ &#39;x&#39; => $width / 2, &#39;y&#39; => 0],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height / 2,
                        ]
                    ],
                    2 => [
                        &#39;to&#39; => [ &#39;x&#39; => 0, &#39;y&#39; => $height / 2 ],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height / 2,
                        ]
                    ],
                    3 => [
                        &#39;to&#39; => [ &#39;x&#39; => $width / 2, &#39;y&#39; => $height / 2],
                        &#39;size&#39; => [
                            &#39;width&#39; => $width / 2,
                            &#39;height&#39; => $height / 2,
                        ]
                    ],
                ];
        }
    }
}

</code>

<code class="language-php">$thumbnail = \clarence\thumbnail\Thumbnail::createFromImages($srcImages, 240, 320);
$thumbnail->writeImage($outputDir."/example.jpg");

</code>