如何在PHP中实现HEIC/HEIF格式图片上传并转换为JPG格式

1. HEIC格式的MIME类型识别 #

HEIC/HEIF格式对应的标准MIME类型为image/heic、image/heif，部分低版本文件识别扩展可能识别不准，注意不要依赖客户端上传时携带的$_FILES['field']['type']参数做校验，该参数可伪造无参考价值，需通过服务器端工具做校验：

• 优先用PHP内置finfo扩展校验（PHP 5.3+默认启用），示例代码：

$tmpPath = $_FILES['upload_file']['tmp_name'];
$finfo = new Finfo(FILEINFO_MIME_TYPE);
$fileMime = $finfo->file($tmpPath);
// 合法格式白名单，加入HEIC相关类型
$allowMimes = ['image/jpeg', 'image/png', 'image/heic', 'image/heif'];
if (!in_array($fileMime, $allowMimes)) {
    // 非法格式，直接驳回上传
}

• 若finfo版本过低识别不了HEIC，可通过文件头判断：读取文件前12个字节，HEIC格式文件头会包含ftypheic、ftypheix、ftypmif1等特征字符串，匹配到即可判定为合法HEIC文件。

2. HEIC转JPG的实现方案 #

转换需要依赖libheif解码库，根据服务器环境可选两种实现方式：

方案1：Imagick扩展实现 #

前提是服务器安装的Imagick扩展编译时已加载libheif依赖，支持HEIC格式解析：

$heicPath = '/path/to/input.heic';
$jpgPath = '/path/to/output.jpg';

$imagick = new Imagick($heicPath);
$imagick->setImageFormat('jpg');
// 调整压缩质量，范围0-100，数值越大质量越高文件越大
$imagick->setImageCompressionQuality(85);
$imagick->writeImage($jpgPath);
$imagick->clear();
$imagick->destroy();

方案2：系统命令实现 #

若无法配置Imagick，可在服务器安装libheif工具包，通过heif-convert命令转换，注意做参数转义避免命令注入：

$heicPath = escapeshellarg('/path/to/input.heic');
$jpgPath = escapeshellarg('/path/to/output.jpg');

// 执行转换命令
exec("heif-convert {$heicPath} {$jpgPath}", $output, $code);
if ($code !== 0) {
    // 转换失败，做错误处理
}

3. 注意事项 #

• 转换后的JPG文件建议再做一次合法性校验，确认是有效图片后再存入业务存储，避免恶意文件注入
• 若使用exec调用系统命令，所有传入命令的路径参数必须用escapeshellarg转义，避免命令注入漏洞
• 大体积HEIC转换会占用较多内存，建议根据服务器配置做上传大小限制和超时时间调整

内容的提问来源于stack exchange，提问作者jtds