حل مشکل لود نشدن imagick.so در PHP Selector با CloudLinux

مقدمه

Imagick یک افزونه مهم PHP است که برای پردازش تصاویر استفاده می‌شود. با کمک این ماژول می‌توان تصاویر را تغییر اندازه داد، فیلترگذاری کرد و یا فرمت‌ها را تبدیل نمود. در سرورهای CloudLinux که از Alt‑PHP و PHP Selector استفاده می‌شود، ممکن است هنگام اجرای PHP یا ابزارهایی که به Imagick نیاز دارند، خطای زیر مشاهده شود:

PHP Warning: PHP Startup: Unable to load dynamic library 'imagick.so' - suitable only for internal use

این خطا نشان می‌دهد که PHP نمی‌تواند فایل imagick.so را بارگذاری کند. در این مقاله، به بررسی علل، روش‌های حل مشکل و نکات امنیتی می‌پردازیم.

ریشه مشکل

بر اساس مستند CloudLinux، دلایل اصلی این مشکل عبارتند از:

1. عدم نصب یا نصب ناقص PECL‑ext
   افزونه Imagick معمولاً از طریق پکیج PECL نصب می‌شود (مثلاً alt-phpXX-pecl-imagick). اگر این پکیج برای نسخه Alt‑PHP نصب نشده باشد، PHP نمی‌تواند ماژول را لود کند.
2. نبود کتابخانه‌های ImageMagick یا ناسازگاری نسخه‌ها
   ماژول Imagick به کتابخانه‌های داخلی ImageMagick مانند libMagickWand نیاز دارد. اگر این کتابخانه‌ها نصب نباشند یا نسخه ناسازگار داشته باشند، لود شدن ماژول شکست می‌خورد.
3. تضاد نسخه‌ها یا مخازن تست (testing)
   اگر پکیج‌های Imagick یا ImageMagick از مخازن تست نصب شده باشند، ممکن است با نسخه PHP یا دیگر پکیج‌ها ناسازگار باشند.
4. تنظیمات نادرست PHP Selector یا CageFS
   گاهی پیکربندی Selector یا محدودیت‌های CageFS باعث می‌شود PHP نتواند مسیر imagick.so یا کتابخانه‌های وابسته را پیدا کند.

بررسی وضعیت فعلی

برای بررسی مشکل، مراحل زیر را دنبال کنید:

1. بررسی نسخه PHP فعال

php -v
php -i | head

این کار نشان می‌دهد که کاربر از کدام نسخه Alt‑PHP استفاده می‌کند و مسیر php.ini را مشخص می‌کند.

2.بررسی وجود ماژول Imagick
با دستور زیر مطمئن شوید که PHP Imagick را می‌شناسد یا خیر:

php -m | grep imagick

اگر نتیجه‌ای ندهد، یعنی ماژول لود نشده است.

3.بررسی مسیر فایل imagick.so
مسیر معمول برای نسخه‌های Alt‑PHP:

/opt/alt/phpXX/usr/lib64/php/modules/imagick.so

اگر این فایل وجود ندارد، باید پکیج مربوط نصب شود.

4.بررسی وابستگی‌ها
بررسی کنید که کتابخانه‌های ImageMagick روی سیستم نصب و شناسایی شده باشند:

ldd /opt/alt/phpXX/usr/lib64/php/modules/imagick.so

1. این دستور نشان می‌دهد کدام کتابخانه‌ها پیدا نشده‌اند یا ناسازگار هستند.

راه‌حل‌ها

CloudLinux چندین راهکار برای حل این مشکل ارائه می‌دهد:

1. نصب یا به‌روزرسانی پکیج‌های PECL

برای نسخه Alt‑PHP مورد نظر، پکیج PECL مربوطه را نصب یا به‌روزرسانی کنید:

yum install alt-phpXX-pecl-imagick
yum update alt-phpXX-pecl-imagick

2. نصب یا به‌روزرسانی ImageMagick

مطمئن شوید که پکیج‌های ImageMagick و کتابخانه‌های آن نصب هستند:

yum install alt-ImageMagick alt-ImageMagick-libs
yum update alt-ImageMagick alt-ImageMagick-libs

در صورت نصب ناقص یا وجود مشکل، می‌توانید دوباره نصب کنید:

yum reinstall alt-ImageMagick alt-ImageMagick-libs

3. بررسی ناسازگاری نسخه‌ها

اگر پکیج‌ها از مخازن آزمایشی نصب شده‌اند، بهتر است نسخه پایدار را نصب یا دان‌گرید کنید:

yum downgrade alt-ImageMagick alt-ImageMagick-libs

4. ری‌استارت سرویس PHP / FPM

پس از نصب یا به‌روزرسانی پکیج‌ها، سرویس PHP-FPM یا وب‌سرور را ری‌استارت کنید:

systemctl restart phpXX-php-fpm
systemctl restart httpd   # برای Apache
systemctl restart nginx   # برای Nginx

5. تایید رفع مشکل

برای اطمینان از اینکه ماژول Imagick لود شده است:

php -m | grep imagick
php -i | grep imagick

همچنین می‌توانید یک فایل phpinfo.php بسازید و در مرورگر بررسی کنید.
نکات امنیتی و هشدارها

همچنین می‌توانید یک فایل phpinfo.php بسازید و در مرورگر بررسی کنید.
نکات امنیتی و هشدارها

جمع‌بندی

همچنین می‌توانید یک فایل phpinfo.php بسازید و در مرورگر بررسی کنید.

نکات امنیتی و هشدارها

• همیشه از نسخه‌های پایدار پکیج‌ها استفاده کنید، به ویژه در سرورهای تولید.
• پس از نصب یا بروزرسانی پکیج‌ها، ری‌استارت PHP الزامی است.
• بررسی وابستگی‌های کتابخانه‌ها با دستور ldd کمک می‌کند مشکلات ناشی از مسیرهای گمشده یا ناسازگار برطرف شود.
• در محیط CageFS، دسترسی به مسیرهای سیستم محدود است؛ بنابراین اطمینان حاصل کنید مسیرهای کتابخانه‌ها و ماژول‌ها در لیست مجاز CageFS قرار دارند.

جمع‌بندی

• خطای Unable to load dynamic library ‘imagick.so’ معمولاً به دلیل نصب ناقص یا ناسازگاری نسخه‌های PECL / ImageMagick رخ می‌دهد.
• CloudLinux پیشنهاد می‌کند که پکیج‌های alt-phpXX-pecl-imagick و alt-ImageMagick و کتابخانه‌های آن نصب و به‌روزرسانی شوند.
• پس از اعمال تغییرات، سرویس PHP/FPM ری‌استارت شود و وضعیت با php -m یا phpinfo() بررسی شود.
• این کار باعث می‌شود ماژول Imagick بدون خطا لود شود و ابزارهای پردازش تصویر به درستی کار کنند.