萬盛學電腦網

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

PHP 讀取 Photoshop 寫入圖片 IPTC 元數據完整指南

背景

攝影師、設計師常在 Photoshop 中通過「文件 → 文件信息」寫入標題、關鍵詞、版權等 IPTC 元數據。PHP 可通過 getimagesize() 獲取 APP13 區塊,再用 iptcparse() 解析出結構化信息。

核心代碼

<?php
function readIptcFromImage(string $imagePath): array {
    $imageInfo = [];
    $size = @getimagesize($imagePath, $info);
    
    if (!$size || empty($info['APP13'])) {
        return $imageInfo; // 無 IPTC 數據
    }

    $iptc = iptcparse($info['APP13']);
    if (!$iptc) return $imageInfo;

    // IPTC 標籤映射(常用字段)
    $tagMap = [
        '2#005' => 'title',           // 標題
        '2#015' => 'category',        // 類別
        '2#020' => 'keywords',        // 關鍵詞(數組)
        '2#025' => 'copyright',       // 版權
        '2#055' => 'created_date',    // 創建日期
        '2#080' => 'byline',          // 作者
        '2#085' => 'byline_title',    // 作者職稱
        '2#090' => 'city',            // 城市
        '2#095' => 'state',           // 省/州
        '2#101' => 'country',         // 國家
        '2#116' => 'credit',          // 信用/來源
        '2#120' => 'caption',         // 說明/描述
        '2#122' => 'caption_writer',  // 說明撰寫者
    ];

    foreach ($tagMap as $tag => $key) {
        if (isset($iptc[$tag])) {
            // 部分標籤可能有多個值(如 keywords)
            $values = $iptc[$tag];
            $imageInfo[$key] = (count($values) === 1) ? $values[0] : $values;
        }
    }

    return $imageInfo;
}

// 使用
$info = readIptcFromImage('photo.jpg');
print_r($info);
/*
Array
(
    [title] => 日落海灘
    [keywords] => Array ( [0] => 海灘 [1] => 日落 [2] => 風景 )
    [copyright] => © 2024 Photographer Name
    [caption] => 晚霞映照海面,波光粼粼
    [byline] => 張三
)
*/

完整標籤參考

IPTC 標籤採用 Record#DataSet 格式,常用記錄號 2#(應用記錄)。完整列表請參考 IPTC 標準文檔。常用映射已在上方 $tagMap 列出。

常見問題

1. 中文亂碼

IPTC 歷史標準使用 Latin-1 (ISO-8859-1) 或 UTF-8(需標記)。若讀出亂碼,嘗試轉換:

$value = mb_convert_encoding($value, 'UTF-8', 'ISO-8859-1');

2. JPEG 無 APP13 區塊

圖片可能被壓縮工具剝離元數據,或原本未寫入 IPTC。可用 exif_read_data() 同時檢查 EXIF/XMP。

3. PNG/WebP 格式

IPTC 主要存在於 JPEG。PNG 使用 iTXt/tEXt/zTXt 區塊,WebP 使用 EXIF/XMP。需針對格式選擇解析方法。

擴展:寫入 IPTC(需 PECL iptc)

$iptc = [
    '2#005' => '新標題',
    '2#020' => ['關鍵詞1', '關鍵詞2'],
    '2#120' => '新描述',
];
$iptcData = iptcembed(iptcencode($iptc), $imageContent);
file_put_contents('new_photo.jpg', $iptcData);

注意:iptcembed 僅支援 JPEG,且會增加文件體積。

總結

PHP 內建 getimagesize() + iptcparse() 可零依賴讀取 JPEG 的 IPTC 元數據。配合標籤映射表,即可輕鬆提取標題、關鍵詞、版權等核心字段,適用於圖庫管理、版權保護、自動標籤等場景。

copyright © 萬盛學電腦網 all rights reserved