(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — Crop an image to the given rectangle
Crops an image to the given rectangular area and returns the resulting image.
The given image is not modified.
imageA GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().
rectangle
The cropping rectangle as array with keys
x, y, width and
height.
Return cropped image object on success or false on failure.
| Version | Description |
|---|---|
| 8.0.0 |
image expects a GdImage
instance now; previously, a resource was expected.
|
| 8.0.0 | On success, this function returns a GDImage instance now; previously, a resource was returned. |
Example #1 imagecrop() example
This example shows how to crop an image to a square area.
<?php
$im = imagecreatefrompng('example.png');
$size = min(imagesx($im), imagesy($im));
$im2 = imagecrop($im, ['x' => 0, 'y' => 0, 'width' => $size, 'height' => $size]);
if ($im2 !== FALSE) {
imagepng($im2, 'example-cropped.png');
imagedestroy($im2);
}
imagedestroy($im);
?>