exif_read_data

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

exif_read_data — 從一個(gè)圖片文件中讀取 EXIF 頭信息

說(shuō)明

exif_read_data(
    resource|string $file,
    ?string $required_sections = null,
    bool $as_arrays = false,
    bool $read_thumbnail = false
): array|false

exif_read_data() 函數(shù)從一個(gè)圖片文件中讀取 EXIF 頭信息。這樣就可以讀取數(shù)碼相機(jī)產(chǎn)生的元數(shù)據(jù)。

EXIF 頭信息往往存在于數(shù)碼相機(jī)生成的 JPEG/TIFF 圖片中，但不幸的是每個(gè)數(shù)碼相機(jī)制造商的標(biāo)記都不同，因此（編寫(xiě)代碼時(shí)）不能依賴于某個(gè)特定的 Exif 頭信息。

Height 和 Width 是用和 getimagesize() 一樣的方法計(jì)算的，因此它們的值不能是任何返回的頭信息的部分。此外 html 是一個(gè)可以用于普通的 HTML 中的 height/width 的文本字符串。

當(dāng)一個(gè) Exif 頭信息包含有一個(gè) Copyright 時(shí)注意它本身可以包含兩個(gè)值。解決方案和 Exif 2.10 標(biāo)準(zhǔn)不一致，COMPUTED 區(qū)段會(huì)同時(shí)返回 Copyright.Photographer 和 Copyright.Editor，但是 IFD0 區(qū)段則包含有一個(gè)字節(jié)數(shù)組用 NULL 字符分隔開(kāi)兩個(gè)項(xiàng)目?；蛘咧挥械谝豁?xiàng)如果數(shù)據(jù)類型錯(cuò)誤的話（Exif 的正常行為）。COMPUTED 也會(huì)包含 Copyright，要么是原始的版權(quán)字符串，要么是逗號(hào)分隔的攝像與編輯的版權(quán)信息。

UserComment 標(biāo)記和 Copyright 有同樣的問(wèn)題。它也可以存儲(chǔ)兩個(gè)值，第一個(gè)是使用的編碼方式，第二個(gè)是其值本身。如果這樣則 IFD 區(qū)段僅包含編碼方式或者一個(gè)字節(jié)數(shù)組。COMPUTED 區(qū)段將存儲(chǔ)兩個(gè)值到 UserCommentEncoding 和 UserComment。UserComment 在兩種情況下都可用因此應(yīng)該優(yōu)先使用它而不是 IFD0 區(qū)段中的該值。

exif_read_data() 還會(huì)根據(jù) EXIF 規(guī)范（? http://exif.org/Exif2-2.PDF，第 20 頁(yè)）來(lái)驗(yàn)證 EXIF 數(shù)據(jù)。

參數(shù)

file

圖片文件的位置。這可以是一個(gè)文件路徑（和往常一樣，流封裝也是支持的）， 或者是一個(gè)流式資源（stream resource）。

required_sections

是需要存在于文件中的逗號(hào)分隔的區(qū)段列表用來(lái)產(chǎn)生結(jié)果數(shù)組。如果未找到所請(qǐng)求的區(qū)段則返回值為 false。

FILE FileName, FileSize, FileDateTime, SectionsFound
COMPUTED html，Width，Height，IsColor，可能有更多其它的。Height 和 Width 是用和 getimagesize() 一樣的方法計(jì)算的，因此它們的值不能是任何返回的頭信息的部分。此外 html 是一個(gè)可以用于普通的 HTML 中的 height/width 的文本字符串。
ANY_TAG 任何包含有標(biāo)記的信息，例如 IFD0，EXIF，...
IFD0 所有 IFD0 的標(biāo)記數(shù)據(jù)。在標(biāo)準(zhǔn)的圖像文件中這包含了圖像大小及其它。
THUMBNAIL 如果有第二個(gè) IFD，文件應(yīng)該包含有縮略圖。所有有關(guān)嵌入縮略圖的標(biāo)記信息都存儲(chǔ)在本區(qū)。
COMMENT JPEG 圖像的注釋頭信息。
EXIF EXIF 區(qū)段是 IFD0 的子區(qū)，包含有圖像的更多詳細(xì)信息。大多數(shù)內(nèi)容都是數(shù)碼相機(jī)相關(guān)的。

as_arrays

指定了是否每個(gè)區(qū)段都成為一個(gè)數(shù)組。required_sections COMPUTED，THUMBNAIL 和COMMENT 區(qū)段總是成為數(shù)組，因?yàn)樗鼈兝锩姘拿趾推渌鼌^(qū)段沖突。

read_thumbnail

當(dāng)設(shè)定為 true 時(shí)，讀取縮略圖本身。否則只讀取標(biāo)記數(shù)據(jù)。

返回值

返回一個(gè)關(guān)聯(lián)數(shù)組，鍵名是頭信息名，值為與其相應(yīng)的值。如果沒(méi)有可供返回的數(shù)據(jù)，exif_read_data() 將返回 false。

錯(cuò)誤／異常

當(dāng)遇到不支持的標(biāo)簽，或其他潛在的錯(cuò)誤情況時(shí)，將拋出E_WARNING 與E_NOTICE等級(jí)的錯(cuò)誤，但這個(gè)函數(shù)依然會(huì)嘗試去讀取所有可理解的信息。

更新日志

版本 說(shuō)明
8.0.0 required_sections 現(xiàn)在可以為空。
7.2.0 file 參數(shù)現(xiàn)在起支持本地文件和流式資源。
7.2.0 新增了以下 EXIF 格式的支持：
  • Samsung
  • DJI
  • Panasonic
  • Sony
  • Pentax
  • Minolta
  • Sigma/Foveon
  • AGFA
  • Kyocera
  • Ricoh
  • Epson

范例

示例 #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";
    }
}
?>

第一個(gè)調(diào)用失敗了，因?yàn)閳D像沒(méi)有頭信息。

以上例程的輸出類似于：

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 file is 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.

參見(jiàn)