نصب ionCube Loader در دایرکت‌ادمین

در دایرکت‌ادمین دو راه برای نصب ionCube Loader وجود دارد: اگر کاربر عادی هستید، از بخش Select PHP Version پنل خودتان با یک تیک فعالش می‌کنید؛ و اگر مدیر سرور هستید، با ابزار CustomBuild می‌توانید آن را روی همه نسخه‌های PHP نصب کنید. هر دو روش چند دقیقه بیشتر طول نمی‌کشد و نیازی به انکد مجدد فایل ندارد.

این مقاله در یک نگاه

  • کاربر عادی از Select PHP Version پنل خودش لودر را فعال می‌کند.
  • مدیر سرور با دستور build ioncube آن را برای همه نسخه‌ها نصب می‌کند.
  • CustomBuild خودش سرویس PHP را ری‌استارت می‌کند.
  • بعد از نصب حتما با phpinfo نتیجه را بررسی کنید.
  • اگر گزینه در پنل نبود، یعنی هنوز روی سرور نصب نشده است.

روش اول: فعال‌سازی از پنل کاربری

اگر لودر روی سرور نصب شده باشد، هر کاربر می‌تواند آن را برای اکانت خودش فعال کند بدون اینکه به دسترسی root نیاز داشته باشد.

  1. ورود به دایرکت‌ادمین با نام کاربری و رمز هاست وارد شوید.
  2. باز کردن تنظیمات PHP به بخش Select PHP Version یا PHP Extensions بروید.
  3. انتخاب نسخه PHP نسخه‌ای را که سایت با آن اجرا می‌شود انتخاب کنید.
  4. فعال کردن افزونه تیک گزینه ioncube_loader را بزنید و ذخیره کنید.
  5. بررسی با یک فایل phpinfo وجود بخش ionCube را تایید کنید.

روش دوم: نصب با CustomBuild

اگر مدیر سرور هستید و گزینه در پنل کاربران دیده نمی‌شود، باید یک‌بار لودر را روی سرور نصب کنید. دایرکت‌ادمین این کار را با ابزار CustomBuild انجام می‌دهد.

cd /usr/local/directadmin/custombuild ./build set ioncube yes ./build ioncube

این دستور لودر متناسب با هر نسخه PHP نصب‌شده روی سرور را دانلود و فعال می‌کند. پس از اتمام، سرویس PHP-FPM به صورت خودکار ری‌استارت می‌شود و گزینه در پنل کاربران ظاهر می‌شود.

به‌روزرسانی لودر همین دستور برای آپدیت لودر هم کار می‌کند. اگر مشتری خطای needs a newer Loader گرفت، اجرای دوباره ./build ioncube معمولا مشکل را حل می‌کند. جزئیات در به‌روزرسانی نسخه لودر.

بررسی صحت نصب

روشدستورنتیجه مورد انتظار
خط فرمانphp -vخط with the ionCube PHP Loader
فهرست ماژول‌هاphp -mوجود ionCube در فهرست
مرورگرفایل phpinfo()بخش مجزای ionCube با شماره نسخه

عیب‌یابی سریع

مشکلراه‌حل
گزینه ioncube_loader در پنل نیستمدیر سرور باید یک‌بار build ioncube را اجرا کند
بعد از فعال‌سازی هنوز خطا می‌گیریدنسخه PHP دامنه را با نسخه فعال لودر یکی کنید
پیام needs a newer Loaderلودر قدیمی است؛ CustomBuild را دوباره اجرا کنید
تغییری دیده نمی‌شودیک‌بار دستی php-fpm را ری‌استارت کنید

اگر خطایی که می‌بینید «needs to be installed» است، راهنمای کامل رفع خطای لودر همه حالت‌ها را پوشش می‌دهد. برای شناخت نقش لودر هم این مقاله را ببینید. نسخه‌های رسمی در سایت ionCube موجود است.

جمع بندی: در دایرکت‌ادمین اگر لودر روی سرور نصب باشد، فعال کردنش برای هر کاربر فقط یک تیک در Select PHP Version است. اگر گزینه دیده نمی‌شود، مدیر سرور باید یک‌بار با CustomBuild و دستور build ioncube آن را نصب کند. مثل همه محیط‌های دیگر، مهم‌ترین نکته این است که لودر روی همان نسخه PHP فعال باشد که دامنه واقعا با آن اجرا می‌شود.

سوالات متداول

آیا برای فعال‌سازی به دسترسی root نیاز دارم؟

خیر. اگر گزینه در Select PHP Version موجود باشد از پنل کاربری فعال می‌شود. فقط اگر گزینه نبود، مدیر سرور باید CustomBuild را اجرا کند.

بعد از build ioncube باید سرور را ری‌استارت کنم؟

CustomBuild خودش سرویس PHP را ری‌استارت می‌کند؛ اما اگر تغییری دیده نشد یک‌بار دستی php-fpm را ری‌استارت کنید.

روی همه نسخه‌های PHP فعال می‌شود؟

بله. دستور build ioncube لودر مناسب هر نسخه نصب‌شده را فعال می‌کند.

در AlmaLinux هم همین دستورها کار می‌کند؟

بله. CustomBuild روی AlmaLinux و Rocky به همین شکل کار می‌کند و نسخه سیستم‌عامل تفاوتی در دستورات ایجاد نمی‌کند.

چطور بفهمم نصب موفق بوده؟

با php -v یا فایل phpinfo؛ باید بخش ionCube و شماره نسخه‌اش را ببینید.

مطالب مرتبط: نصب در سی‌پنل · ionCube Loader چیست؟ · نصب روی سرور لینوکس