utopia-php / image

0.8.12 2026-09-07 10:00 UTC

Requires

• php: >=8.1
• ext-gd: *
• ext-imagick: *

Suggests

• ext-imagick: Imagick extension is required for Imagick adapter

MIT

• framework
• php
• image
• upf
• utopia

Published on Packagist.org on 2026-09-07 10:01 UTC

README

Important

This repository is a read-only mirror of the utopia-php monorepo. Development happens in packages/image — please open issues and pull requests there.

Utopia Image is a lightweight PHP library for common image manipulations. It is maintained by the Appwrite team.

Getting started

Install using Composer:

composer require utopia-php/image

<?php

require_once '../vendor/autoload.php';

use Utopia\Image\Image;

//crop image
$image = new Image(\file_get_contents('image.jpg'));
$target = 'image_100x100.jpg';
$image->crop(100, 100, Image::GRAVITY_TOP_LEFT);
$image->save($target, 'jpg', 100);

$image = new Image(\file_get_contents('image.jpg'));
$target = 'image_border.jpg';
$image->setBorder(2, "#ff0000"); //add border 2 px, red
$image->setRotation(45); //rotate 45 degree
$image->save($target, 'jpg', 100);


$image = new Image(\file_get_contents('image.jpg'));
$target = 'image_border.jpg';
$image->setOpacity(0.2); //set opacity
$image->save($target, 'png', 100);

System requirements

Utopia Image requires PHP 8.1 or later. We recommend using the latest PHP version whenever possible.

Testing

composer test

Copyright and license

The MIT License (MIT) http://www.opensource.org/licenses/mit-license.php