به‌روزرسانی و تغییر نسخه ionCube Loader

لودر ionCube را زمانی به‌روزرسانی می‌کنید که فایل انکدشده با نسل جدیدتری ساخته شده و سرور خطای needs a newer Loader می‌دهد، یا وقتی نسخه PHP سرور را ارتقا داده‌اید. آپدیت لودر معمولا بدون قطعی سرویس و تنها با جایگزینی فایل و ری‌استارت PHP انجام می‌شود و نیازی به انکد مجدد فایل‌های موجود ندارد.

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

  • آپدیت لودر فایل‌های قدیمی را از کار نمی‌اندازد؛ لودر جدید همه را می‌خواند.
  • روی کنترل‌پنل‌ها معمولا یک دستور یا یک کلیک کافی است.
  • قبل از آپدیت، فایل لودر فعلی را نگه دارید تا در صورت مشکل برگردانید.
  • بعد از هر ارتقای نسخه PHP باید لودر متناسب نصب شود.
  • ترتیب بارگذاری پیش از OPcache باید حفظ شود.

چه زمانی باید آپدیت کرد؟

سه موقعیت مشخص وجود دارد که آپدیت لودر را ضروری می‌کند. شناختن آن‌ها کمک می‌کند بی‌دلیل دست به پیکربندی سرور نزنید.

موقعیتنشانهضرورت
خطای needs a newer Loaderفایل با نسل جدیدتر ساخته شدهضروری
ارتقای نسخه PHP سرورلودر نسخه قبلی دیگر بارگذاری نمی‌شودضروری
استفاده از نسل جدید انکدرمی‌خواهید خروجی نسل بالاتر اجرا شودتوصیه‌شده
همه چیز درست کار می‌کندلازم نیست

تشخیص نسخه فعلی

قبل از هر تغییری بدانید الان چه نسخه‌ای دارید. دو راه سریع وجود دارد و هر دو شماره نسخه دقیق را نشان می‌دهند.

php -v # یا در مرورگر با فایل phpinfo() و جستجوی بخش ionCube

در خروجی php -v دنبال خطی مثل «with the ionCube PHP Loader v13.x» بگردید. اگر روی سرور چند نسخه PHP دارید، این دستور را با مسیر کامل همان نسخه اجرا کنید.

آپدیت روی هاست کنترل‌پنلی

روی هاست‌های سی‌پنل و دایرکت‌ادمین، ابزار سازنده کار را برایتان انجام می‌دهد و نیازی به دانلود دستی فایل نیست.

در دایرکت‌ادمین کافی است دستور CustomBuild را دوباره اجرا کنید که آخرین نسخه را می‌گیرد و جایگزین می‌کند:

cd /usr/local/directadmin/custombuild ./build update ./build ioncube

در سی‌پنل از طریق WHM و EasyApache بسته ionCube مربوط به هر نسخه PHP را به‌روزرسانی کنید. مراحل تفصیلی در نصب در سی‌پنل و نصب در دایرکت‌ادمین آمده است. اگر کاربر هاست اشتراکی هستید و دسترسی ندارید، یک تیکت به پشتیبانی بزنید و آپدیت لودر را درخواست کنید.

آپدیت روی سرور بدون کنترل‌پنل

  1. پشتیبان‌گیری از فایل فعلی فایل so قدیمی را با نام دیگری نگه دارید تا در صورت مشکل برگردانید.
  2. دانلود بسته جدید آخرین بسته لینوکس را از سایت رسمی بگیرید و استخراج کنید.
  3. جایگزینی فایل فایل so جدید متناسب با نسخه PHP را در مسیر extension قرار دهید.
  4. بررسی مسیر در ini اگر نام فایل تغییر کرده، مسیر داخل فایل ini را به‌روز کنید.
  5. ری‌استارت سرویس PHP-FPM را ری‌استارت و با php -v نتیجه را بررسی کنید.

مراحل کامل نصب اولیه که همین ساختار را دارد، در نصب روی سرور اوبونتو و AlmaLinux توضیح داده شده است.

نکات جلوگیری از قطعی

آپدیت لودر عملیات کم‌ریسکی است، اما چند احتیاط ساده می‌تواند جلوی قطعی چند دقیقه‌ای سایت را بگیرد.

اقدامچرا مهم است
ابتدا روی یک نسخه تست اعمال کنیداگر مشکلی بود، سایت اصلی قطع نمی‌شود
فایل قبلی را نگه داریدبازگشت سریع در صورت خطا
ترتیب پیش از OPcache را حفظ کنیدلودر باید زودتر بارگذاری شود
در ساعت کم‌ترافیک انجام دهیدری‌استارت PHP چند ثانیه قطعی دارد
خبر خوب آپدیت لودر هیچ فایلی را از کار نمی‌اندازد. لودر جدید همه خروجی‌های نسل‌های قبلی را هم اجرا می‌کند، پس نیازی به انکد مجدد فایل‌های موجود ندارید.

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

جمع بندی: به‌روزرسانی ionCube Loader فقط در سه حالت لازم است: خطای needs a newer Loader، ارتقای نسخه PHP سرور، یا نیاز به اجرای خروجی نسل جدیدتر. روی کنترل‌پنل‌ها یک دستور کافی است و روی سرور خام باید فایل so را جایگزین کنید. مهم‌ترین نکته این است که آپدیت لودر هیچ فایل قدیمی را خراب نمی‌کند، پس بدون نگرانی از سازگاری قبلی می‌توانید انجامش دهید.

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

آپدیت لودر باعث قطعی سایت می‌شود؟

معمولا نه. جایگزینی فایل و ری‌استارت PHP چند ثانیه است. برای اطمینان ابتدا روی یک نسخه تست اعمال کنید و در ساعت کم‌ترافیک انجام دهید.

بعد از آپدیت باید فایل‌ها را دوباره انکد کنم؟

خیر. لودر جدید فایل‌های نسل‌های قدیمی‌تر را هم اجرا می‌کند. آپدیت لودر دقیقا برای همین است.

نسخه فعلی لودر را چطور ببینم؟

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

روی هاست اشتراکی چطور آپدیت کنم؟

معمولا خودتان دسترسی ندارید. یک تیکت به پشتیبانی هاست بزنید و آپدیت ionCube Loader را برای نسخه PHP خود درخواست کنید.

بعد از ارتقای PHP باید لودر را عوض کنم؟

بله. هر نسخه PHP فایل لودر مخصوص خودش را دارد و باید فایل متناسب با نسخه جدید نصب شود.

مطالب مرتبط: خطای ناسازگاری نسخه · نصب در سی‌پنل · نصب روی سرور لینوکس