حل مشکل پشتیبانی از فرمت HEIC در ImageMagick PECL در نسخه‌های ea-php

کتابخانه‌ی ImageMagick یکی از محبوب‌ترین ابزارها برای پردازش تصاویر در سرورهای لینوکسی است. برای استفاده از این کتابخانه در PHP، معمولاً از افزونه PECL ImageMagick استفاده می‌شود. اما در برخی موارد کاربران متوجه می‌شوند که فرمت تصویر HEIC در این افزونه پشتیبانی نمی‌شود. این مشکل به‌خصوص هنگام استفاده از نسخه‌های ea-php در WHM رایج است. در این آموزش، دلایل بروز این مشکل و راهکار رفع آن را بررسی می‌کنیم.

مشکل عدم پشتیبانی HEIC در ImageMagick PECL

زمانی که افزونه‌ی PECL ImageMagick از طریق WHM Module Installer یا خط فرمان نصب می‌شود، فرمت HEIC توسط سرور شناسایی نمی‌گردد. دلیل اصلی این موضوع آن است که بسته‌های آماده‌ی ImageMagick PECL بدون پشتیبانی از کتابخانه‌ی libheif ارائه می‌شوند.

چرا HEIC در ImageMagick شناسایی نمی‌شود؟

• ماژول‌های پیش‌فرض WHM فاقد libheif هستند.
• ImageMagick تنها در صورتی از HEIC پشتیبانی می‌کند که در هنگام کامپایل، کتابخانه‌ی HEIC در دسترس باشد.
• در نتیجه، پس از نصب عادی افزونه، تصاویر HEIC در PHP قابل پردازش نخواهند بود.

روش رفع مشکل HEIC در ImageMagick PECL برای ea-php

در حال حاضر، این مشکل به صورت رسمی توسط سی‌پنل در حال بررسی است (Case: ZC-12484). تا انتشار نسخه‌ی رسمی، می‌توان از روش دستی برای فعال‌سازی HEIC استفاده کرد.

نصب کتابخانه libheif روی سرور

yum install libheif libheif-devel

کامپایل مجدد ImageMagick با پشتیبانی HEIC

./configure --with-heic
make
make install

نصب دستی PECL Imagick Extension

pecl install imagick

فعال‌سازی افزونه در PHP

extension=imagick.so

نتیجه‌گیری

مشکل عدم پشتیبانی HEIC در ImageMagick PECL مربوط به عدم وجود کتابخانه‌ی libheif در بسته‌های پیش‌فرض است. برای رفع این مشکل باید ImageMagick را با پشتیبانی HEIC کامپایل کرده و سپس افزونه‌ی PECL را به‌صورت دستی نصب کنید. تا ارائه‌ی نسخه‌ی رسمی توسط سی‌پنل، این بهترین روش برای استفاده از HEIC در PHP روی سرورهای ea-php است.