Solo Image

Solo ImageDecode once. Encode every variant.

Immutable GD images for PHP. EXIF orientation, bounded resizing, JPEG, PNG and WebP encoding, and optimization that keeps a result only when it is smaller.

Get started
API reference
Solo Image
  • 🧭

    Photos the right way up

    All eight EXIF orientations are applied on decoding, mirrored ones included, from JPEG, PNG and WebP metadata. Width and height describe the picture as people see it.

  • 🧊

    Immutable images

    An image never changes after decoding. One source produces a thumbnail, a preview and a full-size copy, each with its own pixels.

  • 📐

    Bounded resizing

    Fit inside a width, a height or both, or into an exact canvas with transparent margins. The aspect ratio is kept. An image that already fits is returned without copying.

  • 🪶

    Smaller or nothing

    Optimizer offers a re-encoded image only when it is strictly smaller than the input. Otherwise you keep the original bytes.

  • 🛡️

    Limits before decoding

    Byte and pixel limits are read from the headers and enforced before GD allocates a raster. Animated PNG and WebP are rejected, or give their first frame when you ask.

  • 📦

    Bytes in, bytes out

    No files, uploads, storage or framework. The library takes a string and returns a string with its format, MIME type, extension and dimensions.

Turn an upload into two variants ​

php
use Solo\Image\Format;
use Solo\Image\Image;

$image = Image::fromBytes($bytes);

$thumbnail = $image->resize(width: 320)->encode(Format::Webp);
$preview = $image->resize(width: 1200, height: 900)->encode(Format::Jpeg, quality: 85);

$storage->put("photos/{$id}-thumb.{$thumbnail->extension()}", $thumbnail->bytes);
$storage->put("photos/{$id}.{$preview->extension()}", $preview->bytes);

fromBytes() detects the format from the contents, checks the limits and turns the photo the right way up. Each variant has its own pixels, and $image stays as it was decoded. Read the getting-started guide for optimization, limits and errors.

Installation ​

PHP 8.3+ is required, with the gd and exif extensions. GD must be built with support for the formats you use: JPEG, PNG and WebP.

Version 1.0 is a release candidate, so Composer needs to be told that a pre-release is acceptable:

sh
composer require "solophp/image:^1.0@rc"

Continue with the getting-started guide.

MIT licensed.

Copyright © 2026 SoloPHP