leongrdic/imgman

simple php image manipulator that can downscale and compress e.g. thumbnails and profile pictures

Maintainers

Details

github.com/leongrdic/php-imgman

Homepage

Source

Issues

Installs: 70

Dependents: 0

Suggesters: 0

Security: 0

Stars: 9

Watchers: 1

Forks: 0

Open Issues: 0

1.0.0 2022-01-26 21:07 UTC

Requires

  • ext-exif: *
  • ext-gd: *

MIT 360aa609682d32583f04d46e4fce4816912b1c5d

  • Leon <leongrdic.woop@gmail.com>

This package is auto-updated.

Last update: 2024-12-16 03:11:10 UTC

README

This library uses GD and EXIF (optional) PHP extensions so make sure you have them installed.

It also uses the latest PHP 8.1 features and backwards compatibility isn't yet supported.

Install:

composer require leongrdic/imgman

use \Le\ImgMan\{ImgMan, ImageFormat};

Supported formats

Input

  • any image format supported by php-gd

Input methods: fromDataUrl(), fromString(), fromFile()

Output

Call the output() method with the wanted output format:

  • ImageFormat::jpeg
  • ImageFormat::png
  • ImageFormat::webp (make sure your php-gd is configured to work with webp)

After that use: toDataUrl(), toString(), toFile()

Example usages

$rawImageBytes = (new ImgMan)
    ->fromDataUrl($dataUrlFromJS)
    ->cacheExif()
    ->downscale(2048)
    ->rotateFromExif() // rotating after downscaling should use less memory and be a bit faster
    ->output(ImageFormat::jpeg, quality: 75)
    ->toString();
(new ImgMan)
    ->fromFile('example.png')
    ->downscale(1920, 1080)
    ->output(ImageFormat::png)
    ->toFile(); // use input filename (replace original file)
$dataUrl = (new ImgMan)
    ->fromString($rawImageBytes)
    ->output(ImageFormat::webp, quality: 80)
    ->toDataUrl();

Notice

This library hasn't yet been fully tested and is to be used at your own responsibility. Any feedback and improvement suggestions are appreciated!