PNGMetadata is a library which is able to extract the metadata of an image in png format.
It is important to mention that PNGMetadata does not use the software ExifTool so it is completely native.
The v2 line is a ground-up rewrite with a typed, immutable API. It is not
the default version yet: this master branch keeps v1 stable, while v2 lives
on the 2.x branch and the
v2.0.0-beta.1 tag.
Requirements: PHP 8.3+, ext-exif, ext-mbstring, ext-xml, ext-zlib. GD is
no longer required.
$ composer require joserick/png-metadata:2.0.0-beta.1Scope of this beta: IHDR, tEXt, iTXt/XMP, eXIf, sRGB and bKGD.
The Phase 2 chunks (zTXt, iCCP, gAMA, cHRM, tRNS, tIME, pHYs,
sBIT, PLTE) and Phase 3 (APNG/HDR signaling) are follow-ups and are not
part of this beta.
Feedback: use the v2 Beta Feedback issue template (or prefix the issue
title with [v2-beta]) and include the version, PHP version, input type
(path/string/stream), reader mode (lenient/strict), and expected vs. actual
behavior. The API may still change before 2.0.0 stable.
Read the v2 README, the upgrade guide, the CHANGELOG and the documentation.
- PHP >= 7.4
- XML PHP Extension
- JSON PHP Extension
- GD PHP Extension
- EXIF PHP Extension
Use the package manager Composer to install PNGMetadata.
$ composer require joserick/png-metadata// include composer autoload
require 'vendor/autoload.php';
// import the Joserick PNGMetadata
use PNGMetadata\PNGMetadata;
// build PNGMetadata object with a image path.
$png_metadata = new PNGMetadata('Photo.png'); // return a 'ArrayObject' or 'Exception'In case you don't want to see any errors (Exception) generated you can used the static function 'extract()' which returns a 'false' in case of error.
$png_metadata = PNGMetadata::extract('Photo.png'); // return a 'ArrayObject' or 'False'If you want work with simple array without any other function you can call to 'toArray()'.
$png_metadata = new PNGMetadata('Photo.png');
$metadata_array = $png_metadata->toArray(); // return simple 'Array'
//or
$metadata_array = PNGMetadata::extract('Photo.png')->toArray(); // return simple 'Array'Print all the metadata.
$png_metadata = new PNGMetadata('../Photo.png');
echo $png_metadata; // Print metadata in 2 colums.Out:
| Metadata | Value |
|---|---|
| exif:DateTime | 2019:09:08 23:01:23 |
| exif:Make | SONY |
| exif:MimeType | image/png |
| ... | ... |
Get specific metadata.
$png_metadata = new PNGMetadata(___DIR___.'/Photo.png');
echo $png_metadata->get('exif:DateTime'); // Return a value, a array or false.Print the metadata types (IHDR, sRGB, BKGD, EXIF, XMP, CRS, DATE, DC, ICC, AUX, ...).
$png_metadata = new PNGMetadata('./Path/Photo.png');
// or
$png_metadata = PNGMetadata::extract('./Path/Photo.png');
foreach($png_metadata as $key => $value){
echo $key . "<br>"; // Metadata types
}$png_metadata = new PNGMetadata('../Photo.png');
// or
$png_metadata = PNGMetadata::extract('../Photo.png');
$thumb = $png_metadata->getThumbnail();
if ($thumb !== false) {
header('Content-Type: image/png');
imagepng($thumb);
imagedestroy($thumb);
}if (PNGMetadata::isPNG('./Photo_jpg.png')){
echo 'Yes, it is a PNG.';
}else{
echo 'No, it is not a PNG.'
}| GIF(1) | JPEG(2) | PNG (3) | SWF(4) | PSD(5) | BMP(6) |
| TIFF_II(7) | TIFF_MM(8) | JP2 (10) | JPX(11) | JB2(12) | SWC(13) |
| IFF(14) | WBMP(15) | XBM(16) | ICO(17) | WEBP(18) |
return PNGMetadata::getType('./Photo') == 1 // GIF?
The GNU Public License (GPLv3). Please see License File for more information.