{
  "id": "php/imagick-format-not-supported",
  "signature": "Fatal error: Uncaught ImagickException: Unsupported image format /tmp/phpXXXXXX in /var/www/app/src/Image/Converter.php:12",
  "signature_zh": "致命错误：未捕获的 ImagickException：不支持的图像格式 /tmp/phpXXXXXX，位于 /var/www/app/src/Image/Converter.php 第 12 行",
  "regex": "Fatal error: Uncaught ImagickException: Unsupported image format [^\\s]+ in .+:\n",
  "domain": "php",
  "category": "runtime_error",
  "subcategory": null,
  "root_cause": "The ImageMagick library cannot decode the given file because the format is not recognized, the file is corrupt, or the ImageMagick installation lacks support for the required format (e.g., HEIC, WebP).",
  "root_cause_type": "generic",
  "root_cause_zh": "ImageMagick 库无法解码给定文件，因为格式不被识别、文件损坏，或 ImageMagick 安装缺少对所需格式的支持（例如 HEIC、WebP）。",
  "versions": [
    {
      "version": "php 8.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "php 8.2",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "ImageMagick 7.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Imagick 3.7",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Reinstalling the Imagick PHP extension without updating ImageMagick",
      "why_fails": "The PHP extension is just a wrapper; the underlying ImageMagick library must be installed with the required delegates (e.g., libheif for HEIC).",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    },
    {
      "action": "Increasing PHP memory limit",
      "why_fails": "The error is about format support, not memory; increasing memory will not make ImageMagick recognize an unsupported format.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Check supported formats with `convert -list format` on the server, then install missing delegates, e.g., `apt-get install libheif-dev` and recompile ImageMagick.",
      "success_rate": 0.85,
      "how": "Check supported formats with `convert -list format` on the server, then install missing delegates, e.g., `apt-get install libheif-dev` and recompile ImageMagick.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Convert the file to a supported format before processing using an external tool like `ffmpeg` or `gd` as a fallback.",
      "success_rate": 0.75,
      "how": "Convert the file to a supported format before processing using an external tool like `ffmpeg` or `gd` as a fallback.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Check supported formats with `convert -list format` on the server, then install missing delegates, e.g., `apt-get install libheif-dev` and recompile ImageMagick.",
    "Convert the file to a supported format before processing using an external tool like `ffmpeg` or `gd` as a fallback."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://imagemagick.org/script/formats.php",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.86,
  "fix_success_rate": 0.8,
  "resolvable": "partial",
  "first_seen": "2024-03-05",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}