PHP使用libvips转换HEIC为JPG后文件类型识别异常求助

我使用以下PHP代码，借助libvips库实现HEIC格式文件到JPG格式的转换：

// Write image to temp file
$raw_photo = $request->getBody();
$temp = tmpfile();
fwrite($temp, $raw_photo);

// Get the file path
$temp_meta = stream_get_meta_data($temp);
$temp_path = $temp_meta['uri'];
    
// Create image using Vips library
$image = Image::newFromFile($temp_path);
         
// Convert to JPG
$image->jpegsave($temp_path . '.jpg');        
// $image->writeToFile($temp_path . '.jpg');      <-- I also tried this, but didn't work

代码执行后，Mac的Finder显示输出文件为JPG格式，但Slack、checkfiletype.com等应用或工具识别该文件仍为HEIF格式，请问我在实现过程中遗漏了什么？

可能的原因及解决方法 #

• libvips未启用HEIC解码支持
  如果你的libvips编译时没添加HEIC插件，newFromFile根本没解码HEIC内容，只是把原文件复制了一份改了后缀名。可以在PHP里打印$image->format属性，看输出是不是heic；也可以在终端运行vips --version，检查编译选项里有没有HEIC相关标识。

• 临时文件状态异常导致写入不完整
  tmpfile()创建的文件在打开状态下可能存在缓冲问题，建议先关闭临时文件再进行转换：

  fclose($temp);
  $image = Image::newFromFile($temp_path);
  

  或者改用tempnam()创建临时文件，更方便管理：

  $temp_path = tempnam(sys_get_temp_dir(), 'heic_conv');
  file_put_contents($temp_path, $raw_photo);
  

• 保存时未强制指定JPG格式
  用writeToFile时，显式指定格式参数避免自动推断出错：

  $image->writeToFile($temp_path . '.jpg', ['format' => 'jpg']);
  

  用jpegsave时可以加上质量参数确保输出正确：

  $image->jpegsave($temp_path . '.jpg', ['Q' => 80]);
  

• 输出路径存在缓存或旧文件干扰
  检查$temp_path . '.jpg'是否真的生成了新文件，手动删除旧的输出文件后重新运行代码，或者换一个明确的输出路径测试，避免临时文件系统的缓存影响。

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