در برخی از پروژههای PHP، فایلها بهصورت رمزگذاریشده ارائه میشوند و بدون ionCube Loader قابل اجرا نیستند. در این آموزش، نحوه نصب و فعالسازی ionCube Loader در لوکال هاست WAMP را بهصورت گامبهگام بررسی میکنیم.
در این مقاله چی قراره یاد بگیریم؟
ionCube Loader چیست؟
امروزه بسیاری از اسکریپتهای تجاری PHP برای محافظت از کدهای خود از فناوری ionCube استفاده میکنند. این فناوری باعث میشود فایلهای PHP بهصورت رمزگذاریشده اجرا شوند و کاربران به کد منبع دسترسی نداشته باشند. به همین دلیل، برای اجرای این نوع اسکریپتها باید ionCube Loader روی سرور یا محیط لوکال نصب و فعال باشد.
در صورتی که ionCube Loader روی سرور یا لوکال هاست نصب نباشد، این اسکریپتها اجرا نشده و با خطاهای مربوط به ionCube مواجه خواهید شد. به همین دلیل، نصب و فعالسازی ionCube Loader برای اجرای بسیاری از اسکریپتهای PHP ضروری است.
نصب و فعالسازی ionCube Loader در لوکال هاست
اگر هنگام اجرای یک پروژه PHP با خطاهایی مانند “Site error: the file requires the ionCube PHP Loader” مواجه شدهاید، به احتمال زیاد ionCube Loader روی نسخه PHP شما نصب نشده یا به درستی پیکربندی نشده است.
در این آموزش قصد داریم نحوه دانلود، نصب و فعالسازی ionCube Loader در لوکال هاست را بهصورت گامبهگام بررسی کنیم تا بتوانید بدون مشکل اسکریپتهای رمزگذاریشده PHP را اجرا کنید.
مرحله 1: دانلود ionCube Loader Wizard
پس از مشاهده خطای ionCube Loader برای نصب و فعالسازی ionCube Loader در لوکال هاست، روی لینک ionCube Loader Wizard کلیک کنید تا وارد صفحه راهنمای نصب شوید. در این صفحه فایل موردنیاز برای راهاندازی Wizard در اختیار شما قرار میگیرد.
در بخش Installing with the Loader Wizard روی گزینه ZIP archive کلیک کنید تا فایل Wizard دانلود شود. این فایل در ادامه برای شناسایی تنظیمات موردنیاز و نصب صحیح ionCube Loader مورد استفاده قرار میگیرد.
مرحله 2: اجرای ionCube Loader Wizard
پس از دانلود فایل ZIP، آن را از حالت فشرده خارج کنید. سپس در پوشه استخراجشده، فایل loader-wizard.php را در مسیر لوکال هاست (پوشه www در WAMP یا پوشه htdocs در XAMPP) قرار دهید.
مرحله 3: دانلود فایلهای ionCube Loader
اکنون آدرس فایل loader-wizard.php را در مرورگر وارد کرده و آن را اجرا کنید. پس از قرار دادن این فولدر در ریشه لوکال هاست، آدرس آن برای اجرا در مرورگر به شکل زیر خواهد بود:
http://localhost/loader-wizard.phpپس از اجرا، ionCube Loader Wizard محیط PHP را بررسی کرده و راهنمای لازم برای نصب و فعالسازی ionCube Loader در لوکال هاست را نمایش میدهد. همچنین در صورت نیاز، مسیر فایلها و تنظیمات موردنیاز برای ادامه نصب در اختیار شما قرار خواهد گرفت.
مطابق با تصویر زیر رو لینک zip کلیک کنید تا فایلهای ionCube Loader متناسب با ورژن PHP لوکال هاست شما دانلود شوند.
اکنون فایل zip دانلود شده را در محل مشخصی در کامپیوتر خود استخراج کنید. قرار است در مرحله بعد از فایلهای dll موجود در آن استفاده کنید.
مرحله 4: قرار دادن فایلهای Loader دانلود شده در لوکالهاست
در مرورگر خود به فایل loader-wizard.php بازگردید. در متن راهنما به صورت خودکار تشخیص داده شده که باید فایلهایی که مرحله قبل دانلود کردید را در چه مسیری قرار دهید. بنابراین وارد آن مسیر شوید.
پس از وارد شدن به مسیر مشخص شده، نیاز است که از بین فایلهای dll که در مرحله قابل آنها را دانلود و استخراج کردید، نسخه متناسب با نسخه PHP مورد استفاده لوکال هاست خود را در آنجا قرار دهید.
برای مثال، اگر از PHP 8.3 استفاده میکنید و وارد پوشه این نسخه شده اید، باید فایل مربوط به همین نسخه را قرار دهید. انتخاب صحیح فایل Loader اهمیت زیادی دارد، زیرا در صورت عدم تطابق نسخه PHP و Loader، افزونه به درستی بارگذاری نخواهد شد.
مرحله 5: ویرایش فایل php.ini و افزودن ionCube Loader
اکنون باید PHP را طوری تنظیم کنید که هنگام اجرا، فایل ionCube Loader را بارگذاری کند. برای این کار فایل phpForApache.ini یا php.ini مربوط به نسخه PHP فعال خود را باز کنید.
در صفحه فایل loader-wizard.php که قبلا آن را در مرورگر باز کردهاید، مسیر دقیق فایل ini و همچنین دستوری که باید اضافه شود نمایش داده شده است. این دستور را قبل از سایر خطوط zend_extension در فایل قرار دهید. پیشنهاد میشود پس از باز کردن فایل ini، دستور را در ابتدای آن قرار دهید. (این دستور با توجه به نسخه php مورد استفاده شما متغیر است.)
پس از اضافه کردن این خط، فایل را ذخیره کنید. این تنظیم باعث میشود PHP هنگام راهاندازی، ionCube Loader را بارگذاری کرده و بتواند فایلهای رمزگذاریشده را اجرا کند.
مرحله 6: راهاندازی مجدد WAMP یا XAMPP
پس از اعمال تغییرات در فایل پیکربندی PHP، باید سرویس Apache را مجدداً راهاندازی کنید تا تنظیمات جدید بارگذاری شوند. در غیر این صورت، ionCube Loader فعال نخواهد شد و PHP همچنان از تنظیمات قبلی استفاده میکند. به عنوان مثال اگر از WAMP استفاده میکنید، در نوار وظیفه ویندوز روی گزینه آن کلیک کرده و گزینه Restart All Services را انتخاب کنید.
چند لحظه صبر کنید تا تمامی سرویسها مجدداً راهاندازی شوند.
مرحله 7: بررسی فعال بودن ionCube Loader
پس از ذخیره تغییرات و راهاندازی مجدد سرویسها، در صفحه Wizard روی لینک click here to test the Loader کلیک کنید تا وضعیت نصب ionCube Loader بررسی شود.
اگر تمامی مراحل را بهدرستی انجام داده باشید، با صفحهای مشابه تصویر زیر مواجه خواهید شد که پیام Loader Installed Successfully را نمایش میدهد. این پیام نشان میدهد که نصب و فعالسازی ionCube Loader در لوکال هاست با موفقیت انجام شده و PHP اکنون قادر به اجرای فایلهای رمزگذاریشده با ionCube است.
پس از اطمینان از نصب موفق ionCube Loader، توصیه میشود فایل loader-wizard.php را از پوشه www یا htdocs حذف کنید. این فایل فقط برای راهاندازی و بررسی نصب استفاده میشود و نگهداری آن پس از اتمام فرآیند نصب ضرورتی ندارد.
سوالات متداول در مورد ionCube
ionCube Loader چیست؟
ionCube Loader افزونهای برای PHP است که امکان اجرای فایلهای رمزگذاریشده با ionCube را فراهم میکند.
چرا به نصب ionCube Loader نیاز داریم؟
بسیاری از اسکریپتهای تجاری PHP برای محافظت از سورس کد رمزگذاری شدهاند و بدون ionCube Loader اجرا نمیشوند.
از کجا بفهمیم ionCube Loader نصب شده است؟
پس از انجام مراحل نصب، روی گزینه click here to test the Loader در Wizard کلیک کنید. اگر پیام Loader Installed Successfully نمایش داده شود، نصب با موفقیت انجام شده است.
فایل تنظیمات ionCube Loader در WAMP کجاست؟
معمولاً باید فایل phpForApache.ini را در مسیر نسخه PHP فعال ویرایش کنید.
چرا پس از نصب همچنان خطای ionCube Loader نمایش داده میشود؟
این مشکل معمولاً به دلیل انتخاب فایل Loader اشتباه، وارد کردن نادرست مسیر در php.ini یا عدم ریاستارت WAMP پس از اعمال تغییرات رخ میدهد.
آیا پس از نصب میتوان فایل loader-wizard.php را حذف کرد؟
بله، پس از اطمینان از نصب موفق ionCube Loader بهتر است فایل loader-wizard.php را از پوشه www یا htdocs حذف کنید.
آیا ionCube Loader روی XAMPP هم قابل نصب است؟
بله، مراحل نصب در XAMPP نیز مشابه است و تنها مسیر فایلهای PHP و php.ini متفاوت خواهد بود.
آیا نصب ionCube Loader در XAMPP با WAMP تفاوت دارد؟
خیر، مراحل کلی نصب در هر دو محیط مشابه است. تنها تفاوت در مسیر فایلهای PHP و فایل پیکربندی php.ini است که در XAMPP و WAMP متفاوت هستند.
فایل ionCube Loader را در XAMPP کجا باید قرار دهیم؟
در XAMPP باید فایل Loader را در پوشه php/ext کپی کرده و سپس مسیر آن را در فایل php.ini وارد کنید. پس از ذخیره تغییرات، سرویس Apache را ریاستارت نمایید تا ionCube Loader فعال شود.
جمعبندی و صحبت پایانی
با انجام مراحل گفتهشده، ionCube Loader با موفقیت روی لوکال هاست فعال میشود و میتوانید فایلها و اسکریپتهای رمزگذاریشده PHP را بدون مشکل اجرا کنید. همچنین در صورتی که هنگام اجرای پروژه با خطاهای مربوط به ionCube مواجه شوید، با استفاده از Loader Wizard و تنظیمات معرفیشده در این آموزش میتوانید بهراحتی مشکل را برطرف کنید.
امیدواریم این آموزش برای شما مفید بوده باشد و بتوانید از آن برای اجرای پروژهها و اسکریپتهای رمزنگاریشده در محیط توسعه خود استفاده کنید.
حسین چناری نویسنده مطلب
پس از چندین سال تجربه خوشایند و چالش برانگیز در حوزه وردپرس که در پروژههای مختلف کسب کردم، تصمیم گرفتم در مهارت وب به آموزش تجربههای کاری خودم بپردازم و اون را با شما به اشتراک بزارم. امیدوارم براتون کاربردی و مفید باشه.
