[edit] Last updated: Fri, 23 Mar 2012

exif_read_data

(PHP 4 >= 4.2.0, PHP 5)

exif_read_data — Bir JPEG veya TIFF resminden EXIF başlıklarını okur

Açıklama

array exif_read_data ( string $dosya [, string $bölümler = NULL [, bool $diziler = false [, bool $küçük_örnek = false ]]] )

exif_read_data() işlevi bir JPEG veya TIFF resminden EXIF başlıklarını okur. Böylece sayısal kameralar tarafından üretilen temel veriler okunabilir.

Exif başlıkları sayısal kameralar tarafından üretilen JPEG/TIFF resimlerde bulunması için tasarlanmışlarsa da ne yazık ki, her sayısal kamera imalatçısı resim başlıklarının elde edilmesi konusunda farklı yaklaşımlara sahiptirler. Bu bakımdan bazı Exif başlıkları resim üzerinde mevcut olmayabilir.

Height ve Width başlıkları getimagesize() işlevinin yaptığı gibi hesaplandığından döndürülen başlığın birer parçası olmamalıdırlar. html başlığı normal HTML içinde kullanılacak metnin yükseklik/genişlik dizgesidir.

Bir Exif başlığı bir telif hakkı bilgisi içerdiği takdirde, bu iki değerden oluşur. Çözüm Exif 2.10 standadıyla uyumsuz olup COMPUTED bölümü hem Copyright.Photographer hem de Copyright.Editor başlıklarını içerirken IFD0 bölümleri iki girdiyi ayıran NULL karakterli bayt dizisini içerir. Eğer veri türü yanlışsa sadece ilk girdi döner (Exif'in normal davranışı). COMPUTED bölümü ayrıca, Copyright dizgesini de içerir ve bu dizge ya özgün telif hakkı dizgesini ya da fotoğraf ve eser düzenleyici telif haklarını içeren dizgeyi içerir.

UserComment yaftası Copyright yaftası ile aynı sorunlara sahiptir. O da iki değer saklayabilir. İlki kullanılan kodlama, ikincisi değerin kendisidir. Bu durumda, IFD bölümü sadece kodlamayı ve bayt dizisini içerir. COMPUTED bölümü UserCommentEncoding ve UserComment girdilerinin ikisini de saklar. UserComment girdisi her iki durumda da mevcuttur, dolayısıyla IFD0 bölümündeki değere tercihan kullanılmış olmalıdır.

exif_read_data() işlevi ayrıca, EXIF belirtimine uygun olarak EXIF veri başlıklarını da doğrular.

Bilginize:
Windows ME/XP bir kameraya bağlanırken Exif başlıklarını temizler.

Değiştirgeler

dosya

Okunacak resim dosyasının ismi. Bir URL belirtilemez.

bölümler

Sonuç dizisinin üretiminde kullanılmak üzere dosyadaki başlıkların virgül ayraçlı listesi. Belirtilen başlıkların hiçbiri bulunamazsa işlev FALSE döndürür.

FILE	FileName, FileSize, FileDateTime, SectionsFound (Dosyaİsmi, DosyaBoyu, DosyaTarihiSaati, BölümlarVar)
COMPUTED	html, Width, Height, IsColor (html, genişlik, yükseklik, Renklidir) ve varsa başkaları. Height ve Width, getimagesize() işlevinin yaptığı gibi hesaplanır, dolayısıyla bunlar döndürülen başlığın parçaları olmamalıdır. Ayrıca, html, normal HTML içinde kullanılacak height/width dizgesidir.
ANY_TAG	IFD0, EXIF, ... gibi bir yaftaya sahip her türlü bilgi
IFD0	IFD0'ın tüm yaftalanmış bilgisi. Normal resim dosyalarında burada resim boyutu ve saire bulunur.
THUMBNAIL	Dosya ikinci bir IFD'ye sahipse resmin küçük bir örneğini içerdiği varsayılır. Küçük resim örneği ile ilgili tüm veriler bu bölümde saklanır.
COMMENT	JPEG resimlerin açıklama başlıkları.
EXIF	EXIF bölümü IFD0 bölümünün bir alt bölümüdür. Burada resim hakkında çok daha fazla bilgi bulunur. Bu girdilerin çoğu sayısal kamera ile ilgilidir.

diziler

Her bölümün bir dizi haline getirilip getirilmeyeceğini belirler. COMPUTED, THUMBNAIL ve COMMENT bölümleri, diğer bölümlerle karışmaması için daima bir dizi haline getirilirler.

küçük_örnek

TRUE belirtilmişse küçük resim örneğinin kendisi okunur. Aksi takdirde, sadece yaftalı veriler okunur.

Dönen Değerler

Dönen değer bir dizi olup, dizi indisleri başlık isimlerini, değerler bu başlıklarla ilgili verileri içerir. Eğer hiçbir veri döndürülemezse exif_read_data() işlevi FALSE döndürür.

Sürüm Bilgisi

Sürüm:	Açıklama
4.3.0	Diziler dahil gömülü tüm IFD verisi okunabilir oldu. Ayrıca, gömülü küçük resim örneğinin THUMBNAIL alt dizisinde döndürülebilmesi mümkün oldu. Ayrıca, dönen değerlerle ilgili bir azami uzunluk artık söz konusu değil (bellek miktarı ile sınırlı).
4.3.0	PHP mbstring desteğine sahipse, kullanıcı açıklamalarının kodlaması özdevinimli olarak değiştirilebiliyor. Ayrıca, eğer kullanıcı açıklaması Evrenkod veya JIS kodlaması kullanıyorsa kodlama `php.ini` içindeki ayara uygun olarak özdevinimli değiştirilebiliyor.
4.3.0	Eğer resim bir IFD0 verisi içeriyorsa COMPUTED bölümü artık, kıymetli baytın başta olduğu bayt sıralamasının kullanıldığı (motorola) bayt sıralaması için 1, diğeri (intel) için 0 değerini içeren bir ByteOrderMotorola girdisine sahip. Eğer veri türü yanlışsa, COMPUTED ve UserComment artık herhangi bir telif hakkı girdisi içermiyor.

Örnekler

Örnek 1 - exif_read_data() örneği


<?php
echo "test1.jpg:<br />\n";
$exif = exif_read_data('tests/test1.jpg', 'IFD0');
echo $exif===false ? "<Başlık verisi bulunamadı.<br />\n" : "Resim başlıkları içeriyor<br />\n";

$exif = exif_read_data('tests/test2.jpg', 0, true);
echo "test2.jpg:<br />\n";
foreach ($exif as $key => $section) {
    foreach ($section as $name => $val) {
        echo "$key.$name: $val<br />\n";
    }
}
?>

Resim başlık bilgisi içermediğinden ilk çağrı başarısız olur.

Yukarıdaki örnek şuna benzer bir çıktı üretir:

test1.jpg:
Başlık verisi bulunamadı.
test2.jpg:
FILE.FileName: test2.jpg
FILE.FileDateTime: 1017666176
FILE.FileSize: 1240
FILE.FileType: 2
FILE.SectionsFound: ANY_TAG, IFD0, THUMBNAIL, COMMENT
COMPUTED.html: width="1" height="1"
COMPUTED.Height: 1
COMPUTED.Width: 1
COMPUTED.IsColor: 1
COMPUTED.ByteOrderMotorola: 1
COMPUTED.UserComment: Exif test image.
COMPUTED.UserCommentEncoding: ASCII
COMPUTED.Copyright: Photo (c) M.Boerger, Edited by M.Boerger.
COMPUTED.Copyright.Photographer: Photo (c) M.Boerger
COMPUTED.Copyright.Editor: Edited by M.Boerger.
IFD0.Copyright: Photo (c) M.Boerger
IFD0.UserComment: ASCII
THUMBNAIL.JPEGInterchangeFormat: 134
THUMBNAIL.JPEGInterchangeFormatLength: 523
COMMENT.0: Comment #1.
COMMENT.1: Comment #2.
COMMENT.2: Comment #3end
THUMBNAIL.JPEGInterchangeFormat: 134
THUMBNAIL.Thumbnail.Height: 1
THUMBNAIL.Thumbnail.Height: 1

Ayrıca Bakınız

exif_thumbnail() - Bir TIFF veya JPEG resminin içinde gömülü küçük örneği döndürür
getimagesize() - Bir resmin boyutlarını döndürür

exif_tagname

exif_imagetype

[edit] Last updated: Fri, 23 Mar 2012

add a note User Contributed Notes exif_read_data

drpain at webster dot org dot za 13-Mar-2012 11:40


Please note that when resizing images with GD and most image processing scripts or applications you will loose the EXIF information. What I did as a workaround is book this information into MySQL before I re-size images. 



<?php



// This function is used to determine the camera details for a specific image. It returns an array with the parameters.

function cameraUsed($imagePath) {



    // Check if the variable is set and if the file itself exists before continuing

    if ((isset($imagePath)) and (file_exists($imagePath))) {

    

      // There are 2 arrays which contains the information we are after, so it's easier to state them both

      $exif_ifd0 = read_exif_data($imagePath ,'IFD0' ,0);       

      $exif_exif = read_exif_data($imagePath ,'EXIF' ,0);

      

      //error control

      $notFound = "Unavailable";

      

      // Make 

      if (@array_key_exists('Make', $exif_ifd0)) {

        $camMake = $exif_ifd0['Make'];

      } else { $camMake = $notFound; }

      

      // Model

      if (@array_key_exists('Model', $exif_ifd0)) {

        $camModel = $exif_ifd0['Model'];

      } else { $camModel = $notFound; }

      

      // Exposure

      if (@array_key_exists('ExposureTime', $exif_ifd0)) {

        $camExposure = $exif_ifd0['ExposureTime'];

      } else { $camExposure = $notFound; }



      // Aperture

      if (@array_key_exists('ApertureFNumber', $exif_ifd0['COMPUTED'])) {

        $camAperture = $exif_ifd0['COMPUTED']['ApertureFNumber'];

      } else { $camAperture = $notFound; }

      

      // Date

      if (@array_key_exists('DateTime', $exif_ifd0)) {

        $camDate = $exif_ifd0['DateTime'];

      } else { $camDate = $notFound; }

      

      // ISO

      if (@array_key_exists('ISOSpeedRatings',$exif_exif)) {

        $camIso = $exif_exif['ISOSpeedRatings'];

      } else { $camIso = $notFound; }

      

      $return = array();

      $return['make'] = $camMake;

      $return['model'] = $camModel;

      $return['exposure'] = $camExposure;

      $return['aperture'] = $camAperture;

      $return['date'] = $camDate;

      $return['iso'] = $camIso;

      return $return;

    

    } else {

      return false; 

    } 

}



?>



An example of it's use follows:



<?php



$camera = cameraUsed("/img/myphoto.jpg");

echo "Camera Used: " . $camera['make'] . " " . $camera['model'] . "<br />";

echo "Exposure Time: " . $camera['exposure'] . "<br />";

echo "Aperture: " . $camera['aperture'] . "<br />";

echo "ISO: " . $camera['iso'] . "<br />";

echo "Date Taken: " . $camera['date'] . "<br />";



?>



Will display the following, depending on the data:



Camera Used: SONY DSC-S930

Exposure Time: 1/400

Aperture: f/4.3

ISO: 100

Date Taken: 2010:12:10 18:18:45



If the image has been re-sized and the information is no longer available then you should receive the following when echoing the same:



Camera Used: Unavailable

Exposure Time: Unavailable

Aperture: Unavailable

ISO: Unavailable

Date Taken: Unavailable



Some cameras do not capture all the information, for instance Blackberry phones do not record an aperture, or iso and you will get Unavailable for those fields.  



I hope you find this helpful.

michael [at[ thisiswilson [dot[ com 20-Nov-2008 09:01


From - darkain at darkain dot com 's example.



If all the data is from the same image - simply



<?php

        $exif_data = exif_read_data ( $_FILES['photo']



        $emake =$exif_data['Make'];

        $emodel = $exif_data['Model'];

        $eexposuretime = $exif_data['ExposureTime'];

        $efnumber = $exif_data['FNumber'];

        $eiso = $exif_data['ISOSpeedRatings'];

        $edate = $exif_data['DateTime'];

?>



will work, I tried using the PEL library, and while pretty cool, I can't for the life understand how to call some things, this is simpler if your system is pretty basic or if you're in a rush.  If you have time, try playing with PEL.  It's not maintained at the moment though..



http://pel.sourceforge.net/

lincolnzsilva at gmail dot com 26-Sep-2008 04:57


Get some EXIFs fields (easy way):





<?php


        $exif_make = exif_read_data ( $_FILES['photo']['tmp_name'] ,'IFD0' ,0 );


        $emake = $exif_make['Make'];


        


        $exif_model = exif_read_data ( $_FILES['photo']['tmp_name'] ,'IFD0' ,0 );


        $emodel = $exif_model['Model'];


        


        $exif_exposuretime = exif_read_data ( $_FILES['photo']['tmp_name'] ,'EXIF' ,0 );


        $eexposuretime = $exif_exposuretime['ExposureTime'];


        


        $exif_fnumber = exif_read_data ( $_FILES['photo']['tmp_name'] ,'EXIF' ,0 );


        $efnumber = $exif_fnumber['FNumber'];





        $exif_iso = exif_read_data ( $_FILES['photo']['tmp_name'] ,'EXIF' ,0 );


        $eiso = $exif_iso['ISOSpeedRatings'];


                


        $exif_date = exif_read_data ( $_FILES['photo']['tmp_name'] ,'IFD0' ,0 );


        $edate = $exif_date['DateTime'];


?>

darkain at darkain dot com 28-Jul-2008 11:33


I wanted some quick and easy functions for computing the shutter speed and f-stop.  I couldn't find any anywhere, so I made some.  It took some research :





<?php


function exif_get_float($value) {


  $pos = strpos($value, '/');


  if ($pos === false) return (float) $value;


  $a = (float) substr($value, 0, $pos);


  $b = (float) substr($value, $pos+1);


  return ($b == 0) ? ($a) : ($a / $b);


}





function exif_get_shutter(&$exif) {


  if (!isset($exif['ShutterSpeedValue'])) return false;


  $apex    = exif_get_float($exif['ShutterSpeedValue']);


  $shutter = pow(2, -$apex);


  if ($shutter == 0) return false;


  if ($shutter >= 1) return round($shutter) . 's';


  return '1/' . round(1 / $shutter) . 's';


}





function exif_get_fstop(&$exif) {


  if (!isset($exif['ApertureValue'])) return false;


  $apex  = exif_get_float($exif['ApertureValue']);


  $fstop = pow(2, $apex/2);


  if ($fstop == 0) return false;


  return 'f/' . round($fstop,1);


}


?>

wdierkes at 5dollarwhitebox dot org 04-Sep-2007 06:20


Using the exif methods to read WINXP data returns unexpected results unless both exif and mbstring are compiled statically.  Please reference the following bug reports:



Bug #31980

Bug #23105



 

Specifically, the last comment on #23105:



"[8 Apr 2003 4:26pm UTC] edink@php.net



This cannot be fixed due to the fact that mbstring has been removed from PHP core (it has been 'unbundled') and the rest of core files and other extensions cannot use mbstring functionality when it is compiled as a shared library (dll).

"



If exif is compiled statically (--enable-exif) and mbstring compiled as a DSO module (--enable-mbstring=shared) then exif_read_data may only return a single character rather than the entire string.



Compiling both exif and mbstring statically (--enable-exif --enable-mbstring) resolves the issue.

mafo at mafo removethis dot sk 08-Aug-2007 01:57


some cameras (most higher models) have position senzor (gyroskope?) and taking-position is wrote in EXIF, here is simple script for automatic rotating images



<?php

$exif = exif_read_data($filename);

$ort = $exif['IFD0']['Orientation'];

    switch($ort)

    {

        case 1: // nothing

        break;



        case 2: // horizontal flip

            $image->flipImage($public,1);

        break;

                                

        case 3: // 180 rotate left

            $image->rotateImage($public,180);

        break;

                    

        case 4: // vertical flip

            $image->flipImage($public,2);

        break;

                

        case 5: // vertical flip + 90 rotate right

            $image->flipImage($public, 2);

                $image->rotateImage($public, -90);

        break;

                

        case 6: // 90 rotate right

            $image->rotateImage($public, -90);

        break;

                

        case 7: // horizontal flip + 90 rotate right

            $image->flipImage($public,1);    

            $image->rotateImage($public, -90);

        break;

                

        case 8:    // 90 rotate left

            $image->rotateImage($public, 90);

        break;

    }



?>



$image->rotateImage() is inspired by example of http://php.net/manual/en/function.imagerotate.php

$image->flipImage() is inspired by http://php.net/manual/en/function.imagecopy.php#42803 (thank you)

05-Mar-2007 11:50


When reading EXIF information from the 'WINXP' group, you may need to change used encoding from the default "ISO-8859-15" to "UTF-8". This can be done in php.ini or in your code:



<?php

    ini_set('exif.encode_unicode', 'UTF-8');



    $exif = exif_read_data('TEST.JPG', 0, true);

    echo $exif['WINXP']['Title'];

?>



Useful documentation about EXIF:

http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/EXIF.html

See also comments next to XPTitle and XPAuthor.

09-Aug-2004 10:11


I've just released the "PHP JPEG Metadata Toolkit" which allows reading, writing and displaying of EXIF information, and does not need the --enable-exif option in PHP4. 



It has been tested on 466 different models of digital cameras!



It can decode the following EXIF makernotes:

Agfa, Canon, Casio, Contax, Epson, Fujifilm, Konica, Minolta, Kyocera, Nikon, Olympus, Panasonic, Pentax (Asahi), Ricoh and Sony



Additionaly it can decode IPTC, XMP, Photoshop IRB and many other types of JPEG metadata



Try it out, and download it at: 

http://www.ozhiker.com/electronics/pjmt/index.html

gimpster at gimpster dot com 17-May-2004 04:24


I've written a library in pure PHP5 for editing EXIF tags. It deals with both reading and writing EXIF tags, and can be downloaded from http://pel.sourceforge.net/

noway at nowaysoft dot com 23-Feb-2004 08:44


Exif is very unstable under php4.1.2



If you have some problem, (the function didnt return anything, like a blocking call) try this:



$file = './image.jpg';

getimagesize ( $file , $info);



$exif = array();

if (isset($info)) {

    foreach($info as $key => $val) {

        if ($key != 'APP1') { $exif = read_exif_data($file); break; }

    }

}



-- Sharp

pekka at photography-on-the dot net 19-Nov-2003 05:50


For reading EXIF from XMP data embedded by Adobe Photoshop CS, see  http://www.photography-on-the.net/ee/beta/cs_xmp_to_exif.php

add a note