php 8.5 的 exif 扩展完全不支持 heic/heif,因底层仅依赖 libjpeg/libtiff/libpng,未集成 libheif 且无法识别 heif 容器结构;需改用 ext-vips、heif-convert 或 exiftool 等替代方案。

PHP 8.5 的 exif 扩展根本不支持 HEIC/HEIF
直接说结论:exif_read_data() 在 PHP 8.5(包括所有已发布版本)中完全无法读取 .heic 或 .heif 文件的元数据。这不是配置问题,是底层依赖限制——PHP 的 exif 扩展只基于 libjpeg/libtiff/libpng 等传统图像库,不链接 libheif,也不识别 HEIF 容器结构。
为什么 exif_read_data() 对 HEIC 文件返回 false 或警告
调用 exif_read_data('photo.heic') 通常会静默返回 false,或触发 Warning: exif_read_data(): File not supported。这是因为:
-
exif_read_data()仅检查文件头是否匹配 JPEG/TIFF/RAW 等已知签名,HEIC 的 ISO Base Media File Format(ftypheic/ftyphevc)不在识别范围内 - 即使 HEIC 文件内嵌了 JPEG 缩略图(常见于 iPhone),
exif扩展也不会自动解包并读取它——它不解析容器,只读裸流 - PHP 8.5 未引入任何 HEIF 相关的 exif 补丁,官方 RFC 和 bug tracker 中均无此计划
真正可行的替代方案:用 heif-convert + shell_exec 或 ext-vips
要从 HEIC 提取元数据(如拍摄时间、GPS、相机型号),必须绕过 exif 扩展,走外部工具或专用扩展:
- 最轻量:用
heif-convert(来自libheif-utils)先转成 JPEG,再用exif_read_data()读——但会丢失原始 HEIC 特有字段(如深度图、多帧信息) - 推荐生产用:
ext-vips(vips PHP binding),支持直接读 HEIC 并提取 EXIF/XMP:use Jcupitt\Vips\Image;<br>$img = Image::newFromFile('photo.heic');<br>$exif = $img->get('exif-data'); // raw binary, 需额外解析 - 命令行兜底:
exiftool photo.heic最全,但需确保系统已安装exiftool且可执行,注意路径和权限
别踩坑:别试图用 fileinfo 或 imagecreatefromstring 欺骗 exif
有人试过用 finfo_file() 判断 MIME 类型为 image/heic 后强行传给 exif_read_data(),或用 imagecreatefromstring(file_get_contents()) 再传——都没用。原因很实在:
立即学习“PHP免费学习笔记(深入)”;
-
finfo只看文件头,不等于格式可被 exif 解析 -
imagecreatefromstring()在 PHP 8.5 中仍不支持 HEIC(GD/ImageMagick 默认也不开 HEIF 支持) - 强行传二进制进去,
exif_read_data()会因找不到 valid TIFF/JPEG APP1 段而立即退出
HEIC 元数据解析不是“开关没打开”,而是整个解析链路缺失。得换轮子,不是调参数。











