imagepng

Function • Params and return types changed in PHP 8.0

Output a PNG image to either the browser or a file.

PHP 5
PHP 7.0
Improved
PHP 7.1
Improved
PHP 7.2-7.4
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

imagepng Function synopsis

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

Parameters

$image

TypeGdImage

$file

OptionalDefault valuenull

The path or an open stream resource (which is automatically closed after this function returns) to save the file to. If not set or null, the raw image stream will be output directly.

$quality

OptionalTypeintDefault value-1

Compression level: from 0 (no compression) to 9. The default (-1) uses the zlib compression default. For more information see the zlib manual.

$filters

OptionalTypeintDefault value-1

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.

Return value

Typebool

Returns true on success, false on failure

Changes to the imagepng Function

PHP 8.0

  • Return type added: bool
  • Parameter name of parameter #1 changed: $im to $image
  • Parameter type added for parameter #1 ($image): GdImage
  • Parameter name of parameter #2 changed: $to to $file
  • Parameter default value added for position #2 ($file): null
  • Parameter type added for parameter #3 ($quality): int
  • Parameter default value added for position #3 ($quality): -1
  • Parameter type added for parameter #4 ($filters): int
  • Parameter default value added for position #4 ($filters): -1
  imagepng(
-     $im,
+     GdImage $image,
-     $to,
+     $file = null,
-     $quality,
+     int $quality = -1,
-     $filters
+     int $filters = -1
-   )
+   ): bool

PHP 7.1

  • Parameter name of parameter #2 changed: $filename to $to
  imagepng(
      $im,
-     $filename,
+     $to,
      $quality,
      $filters
    )

PHP 7.0

  • Optional parameter added - #3: $quality
  • Optional parameter added - #4: $filters
-imagepng($im, $filename)
+imagepng(
+    $im,
+    $filename,
+    $quality,
+    $filters
+  )

imagepng Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes