exif_thumbnail

Function • Params and return types changed in PHP 8.0

Retrieve the embedded thumbnail of an image.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1-8.2
PHP 8.3-8.4
PHP 8.5
PHP 8.6

exif_thumbnail Function synopsis

exif_thumbnail(
    $file,
    &$width = null,
    &$height = null,
    &$image_type = null
  ): string|false

Parameters

$file

The location of the image file. This can either be a path to the file or a stream resource.

$width

Passed by reference, OptionalDefault valuenull

The return width of the returned thumbnail.

$height

Passed by reference, OptionalDefault valuenull

The returned height of the returned thumbnail.

$image_type

Passed by reference, OptionalDefault valuenull

The returned image type of the returned thumbnail. This is either TIFF or JPEG.

Note that the parameters $width, $height, and $image_type are passed by reference, and contain additional/updated context data that may be useful.

Return value

Typestring|false

Returns the embedded thumbnail, or false if the image contains no thumbnail.

Changes to the exif_thumbnail Function

PHP 8.0

  • Return type added: string|false
  • Parameter name of parameter #1 changed: $filename to $file
  • Parameter default value added for position #2 ($width): null
  • Parameter default value added for position #3 ($height): null
  • Parameter name of parameter #4 changed: $imagetype to $image_type
  • Parameter default value added for position #4 ($image_type): null
  exif_thumbnail(
-     $filename,
+     $file,
-     &$width,
+     &$width = null,
-     &$height,
+     &$height = null,
-     &$imagetype
+     &$image_type = null
-   )
+   ): string|false

exif_thumbnail Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Supported Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Security-Fixes Only 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