如何解决HEIC/AVIF图片转换难题？使用Composer和heif-converter轻松搞定！-composer-PHP中文网

如何解决HEIC/AVIF图片转换难题？使用Composer和heif-converter轻松搞定！

王林

发布： 2025-09-05 10:51:21

原创

521人浏览过

可以通过一下地址学习composer：学习地址

告别 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
```
登录后复制
添加到你的项目依赖中。打开你的项目根目录下的终端，运行以下命令：
```
<pre class="brush:php;toolbar:false;">composer require maestroerror/heif-converter
```
登录后复制
Composer 会自动下载并安装
```
heif-converter
```
登录后复制
及其相关文件到你的
```
vendor
```
登录后复制
目录。
安装底层依赖
```
libheif
```
登录后复制
```
heif-converter
```
登录后复制
依赖于系统上安装的
```
libheif
```
登录后复制
库。这听起来可能有点复杂，但
```
maestroerror/heif-converter
```
登录后复制
的作者已经为我们考虑到了！它在 Composer 包中提供了开箱即用的安装脚本。

图像转图像AI
利用AI轻松变形、风格化和重绘任何图像

65

查看详情
- Linux 用户：
```
<pre class="brush:php;toolbar:false;">./vendor/maestroerror/heif-converter/install-libheif.sh
```
  登录后复制
- macOS 用户：
```
<pre class="brush:php;toolbar:false;">./vendor/maestroerror/heif-converter/install-libheif-macos.sh
```
  登录后复制
- Windows 用户：
```
<pre class="brush:php;toolbar:false;">.\vendor\maestroerror\heif-converter\install-libheif-windows.bat
```
  登录后复制
  运行对应平台的脚本，它会帮助你安装或配置
```
libheif
```
  登录后复制
  。请注意，这些脚本可能需要你的系统已经安装了
```
git
```
  登录后复制
  和
```
brew
```
  登录后复制
  (macOS) 或
```
git
```
  登录后复制
  和 Visual Studio 的 C++ 桌面开发工具 (Windows)。
使用
```
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，只需运行：
```
<pre class="brush:php;toolbar:false;">./vendor/bin/heif-converter-linux heic input.heic output.png
```
登录后复制
命令格式非常直观：
```
[可执行文件] [源格式] [输入文件] [输出文件]
```
登录后复制
。它会根据输出文件的扩展名自动检测目标格式。

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 中，让用户上传任意格式图片，后台自动进行标准化转换。