Exif 擴展讓 PHP 能讀取 JPEG/TIFF 圖片的交換式影像檔案格式資訊(拍攝時間、相機型號、光圈、快門、GPS 座標等)。本文詳述啟用步驟、關鍵載入順序、執行階段驗證與常見問題。
; 1. 找到並啟用 mbstring (必須在 exif 之前載入!)
extension=mbstring
; 2. 啟用 exif
extension=exif
; 3. [可選] 設定 exif 編碼相關 (通常預設即可)
[exif]
exif.encode_unicode = ISO-8859-15
exif.decode_unicode_motorola = UCS-2BE
exif.decode_unicode_intel = UCS-2LE
exif.encode_jis =
exif.decode_jis_motorola = JIS
exif.decode_jis_intel = JIS
mbstring 必須在 exif 之前載入,因為 exif 內部依賴 mbstring 處理多位元組字串編碼轉換。php.ini 中擴展載入順序即為啟用順序。
; 正確順序
extension=mbstring
extension=exif
; 錯誤順序 (會導致 exif 函式無法使用或編碼錯誤)
extension=exif
extension=mbstring
# Apache
sudo systemctl restart apache2
# 或
sudo apachectl restart
# Nginx + PHP-FPM
sudo systemctl restart php8.2-fpm # 版本號依實際調整
# Windows IIS
iisreset
<?php
// 1. 檢查模組載入
var_dump(extension_loaded('exif')); // bool(true)
var_dump(extension_loaded('mbstring')); // bool(true)
// 2. 檢查可用函式
$funcs = get_extension_funcs('exif');
print_r($funcs);
/*
Array
(
[0] => exif_read_data
[1] => exif_thumbnail
[2] => exif_imagetype
[3] => exif_tagname
...
)
*/
// 3. 實際讀取測試
$exif = @exif_read_data(__DIR__ . '/test.jpg');
if ($exif === false) {
echo "無 Exif 資料或檔案錯誤\n";
} else {
echo "相機: " . ($exif['Model'] ?? 'N/A') . "\n";
echo "拍攝時間: " . ($exif['DateTimeOriginal'] ?? 'N/A') . "\n";
echo "GPS: " . json_encode($exif['GPS'] ?? []) . "\n";
}
| 錯誤現象 | 原因 | 解決 |
|---|---|---|
Call to undefined function exif_read_data() | 擴展未載入 | 檢查 php.ini、重啟服務、確認 php -m 包含 exif |
| Exif 資料中文亂碼 | 編碼設定錯誤 | 確認 mbstring 載入順序、設定 exif.encode_unicode |
| exif_read_data() 返回 false | 檔案無 Exif / 非 JPEG/TIFF / 檔案損壞 | 用 exif_imagetype() 先判斷型別 |
| 大檔案 (>2GB) 讀取失敗 | 32 位元 PHP 整數溢位 | 升級 64 位元 PHP 或用 ExifTool CLI |
| Windows PHP 8.2+ 找不到 php_exif.dll | PHP 8.2+ 將 exif 併入核心 | 無需 dll,直接確認 extension=exif 啟用 |