PHP iptcparse 怎样从 JPEG 的 APP13 数据读取标签

先调用 getimagesize($path, $info)，从第二个参数取得JPEG的APP标记数据；存在 $info['APP13'] 时，把这个二进制块传给 iptcparse。成功结果以标签标记为键，保留对应的多值数组；返回 false 时，表示解析错误或没有找到IPTC数据，不能直接断定图片损坏。

官方地址：https://www.php.net/manual/en/function.iptcparse.php

先把空结果分成可统计的状态

给图库做导入时，“标签为空”可能包含几种不同结果：文件读取没有成功、不是本例处理的JPEG、缺少APP13，或者APP13没有解析出IPTC。若全部变成一个空数组，后续只能看到零标签，却不知道该检查原文件还是读取逻辑。

本文把改动目标定为保留这些状态，并统计标签键数与标签值数，不声称代码更快或内存占用更低。示例未运行，也没有实际样本的基线数据。

从JPEG提取APP13再解析

getimagesize 的返回数组主要包含尺寸和图片类型；APP13并不在那个普通返回数组里，而在通过引用传出的第二个参数中。把这两个数组混用，是读取代码中容易忽略的地方。

iptcparse 接收二进制IPTC块，不接收路径。把 sample.jpg 这个字符串传进去，不会让函数自行打开图片；把整张JPEG文件内容交给它，也不等价于按手册提取APP13。

官方手册还说明，image_info 扩展信息只支持JFIF；因此本文不是所有图片格式、所有元数据容器的通用读取器。iptcparse 本身不要求GD图像库，不需要为了读取标签先把整张图解码成GD图片对象。

完整示例保留标签和多值结构

下面的PHP示例返回状态和原始标签数组。运行者需要自行提供本地 sample.jpg；代码展示的是读取逻辑，不会下载或修改图片。

 'image_read_failed', 'tags' => []];
    }
    if (($size[2] ?? null) !== IMAGETYPE_JPEG) {
        return ['state' => 'not_jpeg', 'tags' => []];
    }
    if (!isset($app['APP13'])) {
        return ['state' => 'no_app13', 'tags' => []];
    }

    // 传入APP13二进制块，不传文件名或整张JPEG的字节。
    $tags = iptcparse($app['APP13']);
    if ($tags === false) {
        // false同时覆盖解析错误和未发现IPTC，不能擅自诊断为文件损坏。
        return ['state' => 'no_parsed_iptc', 'tags' => []];
    }
    return ['state' => 'parsed', 'tags' => $tags];
}

$record = readIptcTags(__DIR__ . '/sample.jpg');
echo 'state=', $record['state'], PHP_EOL;

// 标签值保留数组，不只取第一个值，也不按逗号重新拆分。
$valueCount = 0;
foreach ($record['tags'] as $marker => $values) {
    $valueCount += count($values);
    printf("%s: %d value(s)\n", $marker, count($values));
}
printf("tag_keys=%d, values=%d\n", count($record['tags']), $valueCount);

读取函数不会把所有失败强行包装成“图片没有标签”。文件不可读是调用前提错误，代码抛出异常；读取函数返回false、缺少APP13和IPTC未解析出结果则分别记录。PHP自身可能产生的读取警告也没有被静默隐藏。

标签标记保持原样，是为了避免未经确认就猜测业务字段。一个标记可能有多个值，所以 count($tags) 代表标签键数，不代表全部值的数量。代码累计每个值数组的长度，得到另一项统计。

用样本计数比较读取结果

可以准备几类已知来源的本地样本：有IPTC的JPEG、无APP13的JPEG，以及不属于本例范围的图片。逐个记录状态、标签键数、总值数，再与预先掌握的样本信息对照。这是建议的测量设计，本文没有执行这些读取。

例如手工构造一个只用于解释数据结构的数组，若它含两个标签键，其中一个值数组长度为2、另一个为1，则标签键数为2，总值数为3。这只是计数演算，不是任何图片的解析输出，也不能拿它证明读取成功率。

比较改动前后时，重点看原来合并为“空”的情况是否被区分、重复标签值是否被完整保留。若关心性能，必须额外在同一批文件和相同环境下测量时间与内存；不能从“少写几行代码”推导性能结论。

标签读取与业务字段的边界

解析出标签以后，再由业务层决定哪些标记需要映射成标题、说明或关键字列表。原始值的字符编码、显示方式和业务语义，需要独立约定；解析成数组不表示已经完成文本标准化。

缺少APP13是否代表图片完全没有元数据？不能。这里只说明本次APP13读取路径没有取得数据，不能据此给图片的其他信息下结论。

iptcparse返回false能否区分没有数据与格式错误？单凭这个返回值不能，所以示例使用合并状态 no_parsed_iptc，保留进一步排查空间。

为什么不把多个值直接拼成字符串？读取层保留结构，业务层才有机会分别展示、筛选或保存；过早拼接容易丢失原有多值边界。

getimagesize成功就证明文件完全有效吗？不是。PHP手册明确说明它不是图片有效性验证工具；本例只是应用内已选定样本的元数据读取片段。

参考：iptcparse手册；getimagesize手册。