exif_read_data
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
exif_read_data — 從一個圖片檔案中讀取 EXIF 頭資訊
說明
resource|string
$file,?string
$required_sections = null,bool
$as_arrays = false,bool
$read_thumbnail = false): array|false
exif_read_data() 函式從一個圖片檔案中讀取 EXIF 頭資訊。這樣就可以讀取數碼相機產生的後設資料。
EXIF 頭資訊往往存在於數碼相機產生的 JPEG/TIFF 圖片中，但不幸的是每個數碼相機制造商的標記都不同，因此（編寫程式碼時）不能依賴於某個特定的 Exif 頭資訊。
Height 和 Width 是用和 getimagesize()
一樣的方法計算的，因此它們的值不能是任何返回的頭資訊的部分。此外
html 是一個可以用於普通的 HTML 中的 height/width 的文字字串。
當一個 Exif 頭資訊包含有一個 Copyright 時注意它本身可以包含兩個值。解決方案和
Exif 2.10 標準不一致，COMPUTED 區段會同時返回
Copyright.Photographer 和
Copyright.Editor，但是 IFD0
區段則包含有一個位元組陣列用 NULL 字元分隔開兩個專案。或者只有第一項如果數據型別錯誤的話（Exif
的正常行為）。COMPUTED 也會包含
Copyright，要麼是原始的版權字串，要麼是逗號分隔的攝像與編輯的版權資訊。
UserComment 標記和 Copyright
有同樣的問題。它也可以儲存兩個值，第一個是使用的編碼方式，第二個是其值本身。如果這樣則
IFD 區段僅包含編碼方式或者一個位元組陣列。COMPUTED
區段將儲存兩個值到 UserCommentEncoding 和
UserComment。UserComment
在兩種情況下都可用因此應該優先使用它而不是 IFD0 區段中的該值。
exif_read_data() 還會根據 EXIF 規範（» http://exif.org/Exif2-2.PDF，第 20 頁）來驗證 EXIF 數據。
參數
-
file -
圖片檔案的位置。這可以是一個檔案路徑（和往常一樣，流封裝也是支援的）， 或者是一個流式資源（stream resource）。
-
required_sections -
是需要存在於檔案中的逗號分隔的區段列表用來產生結果陣列。如果未找到所請求的區段則返回值為
false。FILE FileName, FileSize, FileDateTime, SectionsFound COMPUTED html，Width，Height，IsColor，可能有更多其它的。Height 和 Width 是用和 getimagesize() 一樣的方法計算的，因此它們的值不能是任何返回的頭資訊的部分。此外 html是一個可以用於普通的 HTML 中的 height/width 的文字字串。ANY_TAG 任何包含有標記的資訊，例如 IFD0，EXIF，...IFD0 所有 IFD0 的標記數據。在標準的影象檔案中這包含了影象大小及其它。 THUMBNAIL 如果有第二個 IFD，檔案應該包含有縮圖。所有有關嵌入縮圖的標記資訊都儲存在本區。COMMENT JPEG 影象的註釋頭資訊。 EXIF EXIF 區段是 IFD0的子區，包含有影象的更多詳細資訊。大多數內容都是數碼相機相關的。 -
as_arrays -
指定了是否每個區段都成為一個陣列。
required_sectionsCOMPUTED，THUMBNAIL和COMMENT區段總是成為陣列，因為它們裡面包含的名字和其它區段衝突。 -
read_thumbnail -
當設定為
true時，讀取縮圖本身。否則只讀取標記數據。
返回值
返回一個關聯陣列，鍵名是頭資訊名，值為與其相應的值。如果沒有可供返回的數據，exif_read_data()
將返回 false。
錯誤／異常
當遇到不支援的標籤，或其他潛在的錯誤情況時，將拋出E_WARNING
與E_NOTICE等級的錯誤，但這個函式依然會嘗試去讀取所有可理解的資訊。
更新日誌
| 版本 | 說明 |
|---|---|
| 8.0.0 |
required_sections 現在可以為空。
|
| 7.2.0 |
file 參數現在起支援本地檔案和流式資源。
|
| 7.2.0 |
新增了以下 EXIF 格式的支援：
|
範例
示例 #1 exif_read_data() 例子
<?php
echo "test1.jpg:<br />\n";
$exif = exif_read_data('tests/test1.jpg', 'IFD0');
echo $exif===false ? "No header data found.<br />\n" : "Image contains headers<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";
}
}
?>
第一個呼叫失敗了，因為影象沒有頭資訊。
以上例程的輸出類似於：
test1.jpg: No header data found. 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
示例 #2 exif_read_data() with streams available as of PHP 7.2.0
<?php
// Open a the file, this should be in binary mode
$fp = fopen('/path/to/image.jpg', 'rb');
if (!$fp) {
echo 'Error: Unable to open image for reading';
exit;
}
// Attempt to read the exif headers
$headers = exif_read_data($fp);
if (!$headers) {
echo 'Error: Unable to read exif headers';
exit;
}
// Print the 'COMPUTED' headers
echo 'EXIF Headers:' . PHP_EOL;
foreach ($headers['COMPUTED'] as $header => $value) {
printf(' %s => %s%s', $header, $value, PHP_EOL);
}
?>
以上例程的輸出類似於：
EXIF Headers: Height => 576 Width => 1024 IsColor => 1 ByteOrderMotorola => 0 ApertureFNumber => f/5.6 UserComment => UserCommentEncoding => UNDEFINED Copyright => Denis Thumbnail.FileType => 2 Thumbnail.MimeType => image/jpeg
註釋
注意:
If mbstring is enabled, exif will attempt to process the unicode and pick a charset as specified by exif.decode_unicode_motorola and exif.decode_unicode_intel. The exif extension will not attempt to figure out the encoding on its own, and it is up to the user to properly specify the encoding for which to use for decoding by setting one of these two ini directives prior to calling exif_read_data().
注意:
If the
fileis used to pass a stream to this function, then the stream must be seekable. Note that the file pointer position is not changed after this function returns.