رفع خطای invalid literal for int در PHP Selector سیستم CloudLinux

اگر در محیط هاستینگ مبتنی بر CloudLinux OS با خطایی شبیه به “invalid literal for int() with base 10: ‘0rc2” مواجه شده‌اید، احتمالاً نسخه‌ی PHP شما دارای پسوند آزمایشی (مانند rc یا beta) است. این خطا به‌دلیل عدم توانایی سیستم در تبدیل رشته به عدد رخ می‌دهد و باعث می‌شود PHP Selector از کار بیفتد یا تنظیمات نسخه‌ی PHP به‌درستی بارگذاری نشود. در ادامه، دلایل دقیق بروز این خطا و روش‌های رفع آن را مرور می‌کنیم.

علت بروز خطای invalid literal for int

خطای invalid literal for int زمانی در PHP Selector رخ می‌دهد که در فایل تنظیمات CloudLinux نسخه‌ای از PHP معرفی شده باشد که دارای پسوندی مانند rc2 یا beta است. به‌طور مثال، وقتی نسخه‌ی alt-php8.3.0rc2 در سیستم ثبت می‌شود، تابع داخلی که وظیفه‌ی تبدیل نسخه به عدد را دارد، نمی‌تواند رشته‌ی «0rc2» را به عدد صحیح تبدیل کند و در نتیجه، خطای invalid literal for int نمایش داده می‌شود.

این مسئله معمولاً در فایل زیر قابل مشاهده است:

/etc/cl.selector/selector.conf

/etc/cl.selector/selector.conf

در این فایل نسخه‌های مختلف PHP تعریف می‌شوند و در صورت وجود پسوند آزمایشی، خطا ظاهر می‌شود.

روش‌های رفع خطا

۱. به‌روزرسانی نسخه PHP

ساده‌ترین و مطمئن‌ترین روش برای رفع خطای invalid literal for int، به‌روزرسانی نسخه‌ی PHP است. کافی است نسخه‌ی PHP خود را به یک نسخه‌ی پایدار (Stable) تغییر دهید. به عنوان مثال، در صورتی که از alt-php83.0rc2 استفاده می‌کنید، آن را به نسخه‌ی alt-php83.0 یا جدیدتر به‌روزرسانی کنید.

با انجام این کار، رشته‌های غیرعددی حذف می‌شوند و PHP Selector می‌تواند نسخه را به‌درستی شناسایی کند.

۲. حذف پسوند آزمایشی از فایل تنظیمات

اگر در حال حاضر امکان به‌روزرسانی ندارید، می‌توانید به‌صورت موقت پسوند آزمایشی را از فایل تنظیمات حذف کنید. برای این کار وارد سرور شوید و دستور زیر را اجرا کنید:

sed -i.bak 's/rc2//g' /etc/cl.selector/selector.conf

sed -i.bak 's/rc2//g' /etc/cl.selector/selector.conf

این دستور تمام موارد حاوی “rc2” را حذف کرده و نسخه‌ها را به قالب استاندارد تبدیل می‌کند. پس از انجام این تغییر، فایل ذخیره و سرویس PHP Selector را مجدداً راه‌اندازی کنید. در این حالت، خطای invalid literal for int دیگر نمایش داده نمی‌شود.

۳. بررسی صحت نسخه‌های نصب‌شده

گاهی اوقات نسخه‌های مختلف PHP به‌صورت ناقص یا ترکیبی از چند نسخه نصب می‌شوند. بهتر است با استفاده از ابزار alt-php یا *yum list alt-php بررسی کنید که تمام نسخه‌ها به‌درستی نصب شده‌اند و نسخه‌ی ناپایدار وجود ندارد. وجود نسخه‌های ناقص یا آزمایشی می‌تواند عامل بروز خطای invalid literal for int باشد.

توصیه‌های مهم

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

خطای invalid literal for int یکی از مشکلات رایج در PHP Selector سیستم CloudLinux است که معمولاً در اثر وجود پسوندهای آزمایشی در نسخه‌های PHP به وجود می‌آید. با حذف پسوند rc یا به‌روزرسانی نسخه‌ی PHP به حالت پایدار، می‌توان این خطا را به‌سادگی برطرف کرد. رعایت این نکات باعث می‌شود عملکرد PHP Selector پایدارتر شده و از خطاهای مشابه در آینده جلوگیری شود.