avaibook/phumbor

A minimal Thumbor library for PHP (webfactory/phumbor)

1.2.4 2023-08-07 08:52 UTC

Requires (Dev)

• phpunit/phpunit: ^4.8|^5.0

Replaces

• 99designs/phumbor: *

MIT

• Stuart Campbell
• webfactory GmbH

• php
• Thumbnails
• thumbor
• webfactory

README

A minimal PHP client for generating Thumbor URLs.

This repo was forked out of the original 99designs/phumbor library after the 1.2.2 release.

Usage

You construct a Thumbor\Url using a Thumbor\Url\Builder:

$server = 'http://thumbor.example.com:1234';
$secret = 'my-secret-key';

echo Thumbor\Url\Builder::construct($server, $secret, 'http://images.example.com/llamas.jpg')
    ->fitIn(640, 480)
    ->addFilter('fill', 'green');

// => http://thumbor.example.com:1234/OFDRoURwi9WVbZNfeOJVfIKr1Js=/fit-in/640x480/filters:fill(green)/http://images/example.com/llamas.jpg

To reuse your server/secret combination, create a Thumbor\Url\BuilderFactory:

$thumbnailUrlFactory = Thumbor\Url\BuilderFactory::construct($server, $secret);

echo $thumbnailUrlFactory
    ->url('http://images.example.com/llamas.jpg')
    ->fitIn(640, 480)
    ->addFilter('fill', 'green');

echo $thumbnailUrlFactory
    ->url('http://images.example.com/butts.png')
    ->crop(20, 20, 300, 300)
    ->valign('middle');

// etc

License

MIT; see LICENSE