راهنمای نصب IonCube Loader در دایرکت ادمین



اگر پس از آپلود یک قالب، پلاگین یا اسکریپت PHP جدید با خطای Site error: the ionCube PHP Loader needs to be installed مواجه شده‌اید، این یک مشکل رایج و راه‌حل آن بسیار ساده است. برخی از توسعه‌دهندگان برای محافظت از کدهای خود، آن‌ها را با IonCube Encoder کدگذاری می‌کنند و برای اجرای این کدها، وب‌سرور شما نیاز به یک افزونه به نام IonCube Loader دارد.

 

خوشبختانه، در کنترل پنل قدرتمند دایرکت ادمین، نصب این افزونه به لطف ابزار CustomBuild بسیار آسان است. در این راهنما، ما هر دو روش نصب از طریق خط فرمان (SSH) و رابط گرافیکی (GUI) را به شما آموزش می‌دهیم.

 

پیش‌نیازها

  • دسترسی به سرور با دسترسی root (برای روش SSH) یا دسترسی Admin (برای فعالسازی از محیط گرافیکی دایرکت ادمین).
  • کنترل پنل دایرکت ادمین به همراه CustomBuild 2.0 (که روی اکثر نصب‌های جدید به صورت پیش‌فرض موجود است).

روش اول: نصب از طریق خط فرمان (SSH)

این روش سریع‌ترین و قدرتمندترین راه برای نصب IonCube است و به شما کنترل کامل بر فرآیند می‌دهد.

 

قدم ۱: ورود به دایرکتوری CustomBuild

ابتدا از طریق یک نرم‌افزار SSH مانند PuTTY به سرور خود متصل شوید و با دستور زیر وارد دایرکتوری اسکریپت‌های CustomBuild شوید:

cd /usr/local/directadmin/custombuild

 

قدم ۲: فعال‌سازی IonCube در تنظیمات

حالا باید به CustomBuild بگویید که قصد نصب IonCube را دارید. این دستور فایل تنظیمات options.conf را ویرایش می‌کند.

./build set ioncube yes

 

قدم ۳: به‌روزرسانی و نصب IonCube

این دستورات ابتدا لیست نرم‌افزارها را آپدیت کرده و سپس IonCube را متناسب با نسخه PHP شما نصب می‌کنند.

# 1. به‌روزرسانی اسکریپت‌ها
./build update

# 2. نصب خودکار IonCube Loader
./build ioncube

 

قدم ۴: بازنویسی کانفیگ‌ها و ری‌استارت وب‌سرور (مهم‌ترین قدم)

این قدم نهایی، تنظیمات جدید را روی وب‌سرور اعمال کرده و آن را ری‌استارت می‌کند.

./build rewrite_confs

 

روش دوم: نصب از طریق رابط گرافیکی وب دایرکت ادمین (GUI) – روش آسان

برای کاربرانی که ترجیح می‌دهند با محیط گرافیکی کار کنند یا با خط فرمان راحت نیستند، دایرکت ادمین یک رابط کاربری ساده برای CustomBuild فراهم کرده است.

قدم ۱: ورود به بخش CustomBuild

وارد کنترل پنل دایرکت ادمین با دسترسی ادمین (Admin) شوید. در بخش Extra Features، روی گزینه CustomBuild 2.0 کلیک کنید.

قدم ۲: تغییر تنظیمات IonCube

در صفحه CustomBuild، روی تب Edit Options کلیک کنید. در لیست تنظیمات، ردیف مربوط به ionCube PHP Loader را پیدا کنید. منوی کشویی مقابل آن را از “no” به “yes” تغییر دهید و سپس روی دکمه Save کلیک کنید.

قدم ۳: نصب نرم‌افزار

حالا به تب Build Software برگردید. در لیست نرم‌افزارها، “ioncube” را پیدا کرده و روی دکمه Build در مقابل آن کلیک کنید. صبر کنید تا فرآیند نصب در پنجره‌ای که باز می‌شود، به پایان برسد.

قدم ۴: بازنویسی تنظیمات

پس از نصب، در همان تب Build Software، به پایین صفحه اسکرول کنید تا به بخش “Rewrite Configurations” برسید. روی دکمه “Rewrite Configurations” کلیک کنید تا تنظیمات جدید اعمال شده و وب‌سرور ری‌استارت شود.

این روش تمام کارهای گفته شده در متد SSH را به صورت خودکار و در پشت صحنه برای شما انجام می‌دهد.

چگونه از نصب صحیح مطمئن شویم؟

پس از انجام یکی از دو روش بالا، برای اطمینان از نصب موفقیت‌آمیز، می‌توانید از این راه‌ها استفاده کنید:

  1. از طریق خط فرمان (SSH):
    دستور php -v را وارد کنید. در خروجی آن باید عبارتی شبیه به with the ionCube PHP Loader را مشاهده کنید. مانند نمونه زیر:

    PHP 8.1.27 (cli) (built: Apr  5 2024 08:31:22) (NTS)
    Copyright (c) The PHP Group
    Zend Engine v4.1.27, Copyright (c) Zend Technologies
        with the ionCube PHP Loader v12.0.5, Copyright (c) 2002-2022, by ionCube Ltd.
  2. از طریق phpinfo():
    یک فایل با نام info.php در پوشه public_html سایت خود ایجاد کرده و کد <?php phpinfo(); ?> را در آن قرار دهید. سپس این فایل را در مرورگر (مثلا yourdomain.com/info.php) باز کنید. باید بخشی مربوط به ionCube PHP Loader را در صفحه مشاهده نمایید.
    نکته امنیتی بسیار مهم: فراموش نکنید پس از بررسی، این فایل را حتما حذف کنید.

شما با استفاده از قدرت ابزار CustomBuild، چه از طریق خط فرمان و چه از طریق رابط کاربری، توانستید یکی از نیازمندی‌های مهم برای اجرای اسکریپت‌های تجاری PHP را روی سرور دایرکت ادمین خود فراهم کنید.

 

مدیریت و کانفیگ صحیح سرور، کلید پایداری و امنیت کسب‌وکار آنلاین شماست. سرورهای مجازی بلوسرور با ارائه کنترل پنل قدرتمند دایرکت ادمین و زیرساخت پایدار، به شما این امکان را می‌دهند که با خیال راحت بر روی رشد پروژه خود تمرکز کنید.

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