萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP Exif 擴展啟用完整指南:php.ini 設定、載入順序、常見錯誤排查

Exif 擴展讓 PHP 能讀取 JPEG/TIFF 圖片的交換式影像檔案格式資訊(拍攝時間、相機型號、光圈、快門、GPS 座標等)。本文詳述啟用步驟、關鍵載入順序、執行階段驗證與常見問題。

啟用步驟 (Windows / Linux 通用)

1. 修改 php.ini

; 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

2. 關鍵:載入順序

mbstring 必須在 exif 之前載入,因為 exif 內部依賴 mbstring 處理多位元組字串編碼轉換。php.ini 中擴展載入順序即為啟用順序。

; 正確順序
extension=mbstring
extension=exif

; 錯誤順序 (會導致 exif 函式無法使用或編碼錯誤)
extension=exif
extension=mbstring

3. 重啟 Web 伺服器 / PHP-FPM

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

常見錯誤與解決

進階:搭配 Imagick 讀取 Exif (效能更好)

<?php
$imagick = new Imagick('photo.jpg');
$exif = $imagick->getImageProfiles('exif:*'); // 取得所有 exif 標籤

// 或針對性讀取
$dateTime = $imagick->getImageProperty('exif:DateTimeOriginal');
$gpsLat = $imagick->getImageProperty('exif:GPSLatitude');
$gpsLon = $imagick->getImageProperty('exif:GPSLongitude');

// Imagick 可處理更多格式 (HEIC, RAW 等需對應編碼器)

安全性考量

  • 用戶上傳圖片可能包含敏感 GPS 座標、裝置資訊,公開前應 剝離 Exif
  • 剝離方法:Imagick::stripImage() 或 exif_read_data 後重新儲存不帶 Exif
  • 上傳處理流程建議:驗證型別 → 剝離 Exif → 壓縮/縮圖 → 儲存

替代方案:ExifTool (CLI)

對於批次處理、視頻 Exif、RAW 格式、效能敏感場景,呼叫 ExifTool 更強大:

<?php
$output = shell_exec('exiftool -j ' . escapeshellarg($imagePath));
$exifData = json_decode($output, true)[0] ?? [];
copyright © 萬盛學電腦網 all rights reserved
錯誤現象原因解決
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.dllPHP 8.2+ 將 exif 併入核心無需 dll,直接確認 extension=exif 啟用