Home/ Manual/ image / functions/ imagepng

imagepng

PHP function Edit on GitHub ✎

(PHP 4, PHP 5, PHP 7, PHP 8)

Output a PNG image to either the browser or a file

Description

imagepng(GdImage $image, resource|string|null $file = null, int $quality = -1, int $filters = -1): bool

Outputs or saves a PNG image from the given image.

file: Path
Note
null is invalid if the quality and filters arguments are not used.
quality: Compression level: from 0 (no compression) to 9. The default (-1) uses the zlib compression default. For more information see the zlib manual.
filters: Allows reducing the PNG file size. It is a bitmask field which may be set to any combination of the PNG_FILTER_* constants. PNG_NO_FILTER or PNG_ALL_FILTERS may also be used to respectively disable or activate all filters. The default value (-1) disables filtering.
Caution
The filters parameter only has an effect when PHP uses the bundled libgd. It is ignored when PHP is built against a system libgd. Check GD_BUNDLED or gd_info() to see which one is in use.

Success

Trueonerror

Throws a ValueError if quality is invalid.

Version	Description
8.4.0	Now throws a `ValueError` if `quality` is invalid.

php

<?php
$im = imagecreatefrompng("test.png");

header('Content-Type: image/png');

imagepng($im);
?>