aportela/remote-thumbnail-cache-wrapper

generate & cache thumbnails of remote images

2.1.0 2025-10-09 19:52 UTC

Requires

• php: >=8.4
• aportela/httprequest-wrapper: ^2.1
• psr/log: ^3.0
• sybio/image-workshop: ^2.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.88
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^10.5

AGPL-3.0-only

• alex

README

generate & cache thumbnails of remote & local images

Requirements

• mininum php version 8.4
• curl extension must be enabled
• gd extension must be enabled

Limitations

At this time only JPEG & PNG formats are supported.

Install (composer) dependencies:

composer require aportela/remote-thumbnail-cache-wrapper

Code example (from remote picture):

<?php

    require "vendor/autoload.php";

    $logger = new \Psr\Log\NullLogger("");

    // cached thumbnails will be stored on this path
    $localPath = "./data/";

    $thumbnail = new \aportela\RemoteThumbnailCacheWrapper\JPEGThumbnail($logger, $localPath);
    $thumbnail->setDimensions(250, 250);
    $thumbnail->setQuality(\aportela\RemoteThumbnailCacheWrapper\JPEGThumbnail::DEFAULT_IMAGE_QUALITY);

    if ($thumbnail->getFromRemoteURL("https://i.imgur.com/1bo3VaU.jpeg")) {
        header("Content-Type: image/jpeg");
        readfile($thumbnail->path);
    } else {
        header("HTTP/1.1 404 Not Found");
    }

Code example (from local filesystem picture):

<?php

    require "vendor/autoload.php";

    $logger = new \Psr\Log\NullLogger("");

    // cached thumbnails will be stored on this path
    $localPath = "./data/";

    $thumbnail = new \aportela\RemoteThumbnailCacheWrapper\PNGThumbnail($logger, $localPath);
    $thumbnail->setDimensions(250, 250);
    $thumbnail->setQuality(\aportela\RemoteThumbnailCacheWrapper\PNGThumbnail::DEFAULT_IMAGE_QUALITY);

    if ($thumbnail->getFromLocalFilesystem("/tmp/test.jpg")) {
        header("Content-Type: image/png");
        readfile($thumbnail->path);
    } else {
        header("HTTP/1.1 404 Not Found");
    }