PHP: imagescale - Manual

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

imagescaleScale an image using the given new width and height

Description

Note:

Unlike many of other image functions, imagescale() does not modify the passed image; instead, a new image is returned.

Return Values

Return the scaled image object on success or false on failure.

Errors/Exceptions

Throws a ValueError if width or height would cause over-/underflow.

Throws a ValueError if mode is invalid.

Changelog

Version Description
8.4.0 Now throws a ValueError if width or height would cause over-/underflow.
8.4.0 Now throws a ValueError if mode is invalid.
8.0.0 On success, this function returns a GDImage instance now; previously, a resource was returned.
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

See Also

Found A Problem?

Anonymous

2 years ago

Seemingly, you can't omit the width the same way you do with the height. If you write -1 for the width and specify a number for the height it will return false

cognettings at gmail dot com

10 months ago

To resize height without specifying a width you can rotate the image by 90 degrees, resize, then rotate by 270 degrees.

        $outputImage = imagerotate($image, 90, 0);
        $outputImage = imagescale($outputImage, $minSize);
        $outputImage = imagerotate($outputImage, 270, 0);