告别 HEIC/AVIF 图片兼容性烦恼：用 Composer 玩转 heif-converter
相信很多朋友都有过这样的经历：朋友用 iphone 拍了张照片发给你，结果你发现它是个
.heic文件。或者，你在网上下载了一些高质量的图片，发现它们是
.avif格式。这些新一代的图片格式虽然在压缩效率和画质上表现出色，但兼容性却是个大问题。在 windows、linux 系统上，或者一些旧版软件中，直接打开这些图片常常会遇到困难，更别提将它们集成到你的网站或应用中了。
我之前也深陷这种困境。每次遇到 HEIC 文件，要么得去网上找个在线转换器，上传下载不仅耗时，还总担心图片隐私；要么就得安装一个大型的桌面应用，只为偶尔的转换需求。作为一名 PHP 开发者，我一直在寻找一个更优雅、更自动化的解决方案，最好能直接集成到我的开发流程中。
救星驾到：maestroerror/heif-converter
与 Composer 的完美结合
直到我发现了
maestroerror/heif-converter这个宝藏！它是一个功能强大的命令行工具，专门用于将 HEIC (和 AVIF) 图片转换为 JPEG 或 PNG 格式，反之亦然。更棒的是，它不仅提供了独立的 CLI 应用和 Docker 镜像，还完美支持通过 Composer 在 PHP 项目中进行管理和使用。
heif-converter的核心是利用了
go-libheif模块，这是一个
libheif库的 GoLang 封装，这意味着它拥有高效且可靠的转换能力。
那么，如何将它引入你的 PHP 项目，解决图片转换的燃眉之急呢？
-
通过 Composer 轻松安装
首先，你需要将
heif-converter
添加到你的项目依赖中。打开你的项目根目录下的终端，运行以下命令：composer require maestroerror/heif-converter
Composer 会自动下载并安装
heif-converter
及其相关文件到你的vendor
目录。 -
安装底层依赖
libheif
heif-converter
依赖于系统上安装的libheif
库。这听起来可能有点复杂，但maestroerror/heif-converter
的作者已经为我们考虑到了！它在 Composer 包中提供了开箱即用的安装脚本。-
Linux 用户：
./vendor/maestroerror/heif-converter/install-libheif.sh
-
macOS 用户：
./vendor/maestroerror/heif-converter/install-libheif-macos.sh
-
Windows 用户：
.\vendor\maestroerror\heif-converter\install-libheif-windows.bat
运行对应平台的脚本，它会帮助你安装或配置
libheif
。请注意，这些脚本可能需要你的系统已经安装了git
和brew
(macOS) 或git
和 Visual Studio 的 C++ 桌面开发工具 (Windows)。
-
Linux 用户：
-
使用
heif-converter
进行转换安装完成后，你可以在
vendor/bin
目录下找到heif-converter
的可执行文件，它会根据你的操作系统提供不同版本：- Linux:
./vendor/bin/heif-converter-linux
- Windows:
./vendor/bin/heif-converter-windows.exe
- macOS:
./vendor/bin/heif-converter-macos
例如，要在 Linux 系统上将 HEIC 图片转换为 PNG，只需运行：
./vendor/bin/heif-converter-linux heic input.heic output.png
命令格式非常直观：
[可执行文件] [源格式] [输入文件] [输出文件]
。它会根据输出文件的扩展名自动检测目标格式。 - Linux:
heif-converter
的优势和实际应用
- 便捷性与集成度高： 通过 Composer 管理，你可以将图片转换功能无缝集成到你的 PHP 项目、自动化脚本或 CI/CD 流程中。无需手动下载、安装复杂的桌面软件。
- 跨平台支持： 提供 Linux、Windows 和 macOS 的可执行文件，无论你的开发环境或服务器环境是什么，都能轻松使用。
-
效率与可靠性： 借助于
libheif
库，转换速度快，质量有保障。 - 告别在线工具： 不再需要依赖那些可能存在隐私风险或速度限制的在线转换器。所有操作都在本地完成，更安全、更可控。
- 灵活性： 除了 Composer，它还支持作为独立的 CLI 工具使用，或者通过 Docker 容器运行，满足不同场景的需求。
实际应用场景：
-
图片上传处理： 在你的 PHP Web 应用中，用户上传了 HEIC 图片后，你可以通过
shell_exec()
或Symfony/Process
等方式调用heif-converter
，将其自动转换为 JPEG 或 PNG，确保所有图片都能被浏览器和下游系统兼容处理。 -
批处理脚本： 如果你需要处理大量 HEIC/AVIF 图片，可以编写一个 PHP 脚本，遍历目录中的图片，并使用
heif-converter
进行批量转换。 - 内容管理系统 (CMS)： 集成到 CMS 中，让用户上传任意格式图片，后台自动进行标准化转换。
有了
maestroerror/heif-converter和 Composer，处理 HEIC/AVIF 图片不再是令人头疼的问题。它提供了一个强大、灵活且易于集成的解决方案，让你的开发工作流更加顺畅。如果你也正被图片格式兼容性所困扰，不妨立即尝试一下这个工具，相信它会给你带来惊喜！
