PHPنصب و فعالسازی ionCube Loader در سیپنل
فعالسازی ionCube Loader در سیپنل سادهترین حالت ممکن است: وارد بخش Select PHP Version میشوید، نسخه PHP سایت را انتخاب میکنید و تیک گزینه ioncube_loader را میزنید. کل کار کمتر از دو دقیقه طول میکشد و نیازی به دسترسی root یا ویرایش دستی php.ini ندارد. در ادامه هم روش پنل کاربری و هم روش نصب سمت سرور با WHM را میبینید.
این مقاله در یک نگاه
- در پنل کاربری از مسیر Select PHP Version با یک تیک فعال میشود.
- اگر گزینه در فهرست نبود، مدیر سرور باید آن را از WHM و EasyApache نصب کند.
- بعد از فعالسازی حتما با phpinfo صحت نصب را بررسی کنید.
- لودر باید روی همان نسخه PHP فعال شود که سایت با آن اجرا میشود.
- برای رفع خطای نسخه، آپدیت لودر معمولا کافی است و نیازی به انکد مجدد نیست.
روش اول: فعالسازی از پنل کاربری
در اکثر هاستهای اشتراکی امروزی، ionCube از قبل روی سرور نصب است و شما فقط باید آن را برای اکانت خودتان فعال کنید. این کار از خود سیپنل و بدون نیاز به پشتیبانی هاست انجام میشود.
- ورود به سیپنل با نام کاربری و رمز هاست وارد حساب سیپنل خود شوید.
- باز کردن Select PHP Version در بخش Software روی گزینه Select PHP Version کلیک کنید. در برخی قالبهای سیپنل نام آن MultiPHP INI Editor یا PHP Selector است.
- انتخاب نسخه PHP نسخهای را انتخاب کنید که سایت شما با آن اجرا میشود. اگر مطمئن نیستید، نسخه فعلی همان است که به صورت پیشفرض انتخاب شده.
- فعال کردن افزونه در فهرست Extensions دنبال
ioncube_loaderبگردید، تیک آن را بزنید و تغییرات را ذخیره کنید. - بررسی نتیجه یک فایل با محتوای
<?php phpinfo();بسازید و در مرورگر باز کنید تا بخش ionCube را ببینید.
روش دوم: نصب از WHM
اگر مدیر سرور هستید و به WHM دسترسی دارید، میتوانید لودر را برای همه اکانتها و همه نسخههای PHP نصب کنید. مسیر استاندارد از طریق EasyApache است.
در WHM وارد بخش EasyApache 4 شوید، روی Customize پروفایل فعلی کلیک کنید و در تب PHP Extensions دنبال ioncube بگردید. افزونه مربوط به هر نسخه PHP جداگانه فهرست میشود (مثلا ea-php82-php-ioncube)، پس برای هر نسخهای که کاربران استفاده میکنند آن را انتخاب کنید و در پایان Provision را بزنید.
روش سریعتر برای مدیران سرور، نصب مستقیم بسته از خط فرمان است:
بعد از نصب، سرویس PHP-FPM را ریاستارت کنید تا تغییرات اعمال شود. اگر سرور شما کنترلپنل ندارد، روش کار متفاوت است و در مقاله نصب ionCube روی سرور اوبونتو و AlmaLinux توضیح داده شده است.
بررسی صحت نصب
هیچوقت به فعال شدن تیک در پنل اکتفا نکنید؛ همیشه نتیجه را عملا بررسی کنید. دو راه سریع وجود دارد.
| روش | دستور یا مسیر | چه چیزی باید ببینید |
|---|---|---|
| فایل phpinfo | ساخت فایل با phpinfo() | یک بخش مجزا با عنوان ionCube و شماره نسخه |
| خط فرمان | php -v در ترمینال | خط «with the ionCube PHP Loader» |
| فهرست ماژولها | php -m | وجود ionCube در فهرست |
چند نسخه PHP روی یک هاست
رایجترین علت اینکه کاربران بعد از فعالسازی باز هم خطا میگیرند همین موضوع است. سیپنل اجازه میدهد هر دامنه یا حتی هر زیرپوشه نسخه متفاوتی از PHP داشته باشد. اگر لودر را روی نسخه ۸.۱ فعال کردهاید ولی سایت با ۸.۲ اجرا میشود، عملا هیچ اتفاقی نیفتاده است.
برای اطمینان، در همان خروجی phpinfo به مقدار PHP Version در بالای صفحه نگاه کنید و مطمئن شوید همان نسخهای است که لودر را رویش فعال کردهاید. اگر از MultiPHP Manager استفاده میکنید، نسخه اختصاصدادهشده به دامنه را هم بررسی کنید.
خطاهای رایج سیپنل
| خطا یا نشانه | علت | راهحل |
|---|---|---|
| گزینه ioncube_loader وجود ندارد | روی سرور نصب نشده | تیکت به پشتیبانی یا نصب از WHM |
| تیک زدم ولی ionCube در phpinfo نیست | نسخه PHP دامنه متفاوت است | نسخه دامنه را با MultiPHP Manager یکی کنید |
| needs a newer Loader | لودر قدیمیتر از نسل انکدر | لودر را آپدیت کنید |
| خطا فقط در بخشی از سایت | پوشهای php.ini اختصاصی دارد | فایل php.ini آن پوشه را بررسی کنید |
اگر پیام خطای دقیقی که میبینید «The ionCube PHP Loader needs to be installed» است، راهنمای اختصاصی رفع این خطا همه حالتها را پوشش میدهد. برای درک نقش لودر هم ionCube Loader چیست را ببینید. آخرین نسخههای رسمی در سایت ionCube در دسترس است.
سوالات متداول
بدون دسترسی root هم میتوانم ionCube را فعال کنم؟
بله. اگر لودر روی سرور نصب شده باشد، از بخش Select PHP Version پنل کاربری با یک تیک فعال میشود و نیازی به دسترسی root نیست.
چرا بعد از فعالسازی هنوز خطا میگیرم؟
به احتمال زیاد نسخه PHP دامنه شما با نسخهای که لودر رویش فعال شده فرق دارد. با phpinfo نسخه واقعی را بررسی و هماهنگ کنید.
آیا فعال کردن ionCube به سایت آسیب میزند؟
خیر. لودر فقط اجازه اجرای فایلهای انکدشده را میدهد و روی کدهای معمولی PHP هیچ اثری ندارد.
گزینه ioncube_loader در فهرست نیست، چه کنم؟
یعنی روی سرور نصب نشده است. یک تیکت به پشتیبانی هاست بزنید و نصب آن را برای نسخه PHP خود درخواست کنید.
بعد از فعالسازی باید سرور را ریاستارت کنم؟
در پنل کاربری خیر؛ تغییرات بلافاصله اعمال میشود. در نصب سمت سرور از طریق WHM معمولا ریاستارت PHP-FPM لازم است.
مطالب مرتبط: ionCube Loader چیست؟ · رفع خطای نبود لودر · نصب در دایرکتادمین