رفع خطای «عدم دریافت فهرست افزونه‌ها برای نسخه PHP» در PHP Selector

مقدمه

در سرورهایی که از سیستم عامل CloudLinux OS و ابزار PHP Selector استفاده می‌کنند، یکی از امکانات مهم و مفید برای کاربران نهایی و مدیر سیستم، امکان مشاهده و فعال/غیرفعال کردن افزونه‌های مختلف PHP برای نسخه‌های متفاوت است. اما ممکن است در هنگام تلاش برای مشاهده یا تغییر لیست افزونه‌ها برای یک نسخهٔ خاص PHP، پیغام خطایی به شرح زیر ظاهر شود:

“Cannot get an extensions list for version $php_version”

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

تشریح مشکل

• این خطا زمانی رخ می‌دهد که PHP Selector نتواند فایل پیکربندی یا لیست افزونه‌ها را برای نسخهٔ مشخص PHP پیدا کند یا تحلیل کند. cloudlinux.zendesk.com+1
• یکی از دلایل مهم این است که فایل اجرایی PHP آن نسخه یا یکی از ماژول‌های وابسته دارای حجم صفر (empty file) باشد یا کرپت شده باشد. مثلاً در مثال ذکر شده:

-rwxr-xr-x 1 root root 0 Jan 12 2021 /usr/local/bin/php

• یعنی فایل php با حجم صفر وجود داشته است. cloudlinux.zendesk.com
• به زبان دیگر، نسخهٔ PHP به درستی نصب نشده است، یا یکی از بسته‌های اصلی آن خراب (corrupted) شده است، یا مسیرهای لازم برای ماژول‌ها به‌درستی تنظیم نشده‌اند.

محیطِ مسئله

• سیستم عامل: CloudLinux OS
• ابزار: PHP Selector (برای مدیریت نسخه‌ها و افزونه‌های PHP)
• پنل‌ها: غالباً همراه با cPanel
• پیغام خطا: «Cannot get an extensions list for version $php_version» cloudlinux.zendesk.com+1

راه‌حل قدم‌به‌قدم

بر اساس مستند CloudLinux، برای حل این مشکل این مراحل پیشنهاد شده‌اند:

1. بررسی فایل اجرایی PHP آن نسخه
   با دستورات مانند ls -l /usr/local/bin/php یا مسیر مرتبط با نسخه مورد نظر، مطمئن شوید فایل php وجود دارد و حجم آن صفر نیست. اگر فایل حجمی صفر دارد یا به طور کامل خراب است، باید اقدام شود.
2. نصب مجدد بستهٔ مربوطه
   برای مثال، اگر نسخهٔ PHP مورد نظر بسته ea-php-cli دارد، اجرای دستور زیر پیشنهاد شده است:

yum reinstall ea-php-cli

بدین ترتیب فایل‌های اجرایی و بسته‌های اصلی دوباره نصب می‌شوند و ممکن است مشکل برطرف گردد. cloudlinux.zendesk.com

بررسی سایر ماژول‌ها یا بسته‌های وابسته
ممکن است برخی از ماژول‌ها یا کتابخانه‌های وابسته خراب شده باشند. در این حالت لازم است با دستوراتی مانند rpm -qf یا yum reinstall <package> بستهٔ مربوطه را بازیابی کنید. (نمونه مشابه را در نسخهٔ مقالهٔ دیگر نیز دیده شده است) cloudlinux.zendesk.com

اجرای مجدد تنظیمات PHP Selector
گاهی ممکن است لازم شود ابزار PHP Selector را برای آن نسخه اجرا کنید تا مجدداً فهرست‌ها بازسازی شوند. برای مثال در یکی از مقالات:

cloudlinux-selector setup --interpreter=php --json

1. ریستارت سرویس‌ها در صورت نیاز
   پس از نصب یا تعمیر بسته‌ها، ممکن است نیاز باشد که سرویس‌های مرتبط مانند PHP-FPM، Apache یا Nginx ری‌استارت شوند تا تغییرات اجرایی شوند.

نکات مهم و هشدارها

• همیشه قبل از اعمال تغییرات، نسخهٔ پشتیبان از فایل‌های پیکربندی یا مسیرهای مهم تهیه کنید.
• بررسی کنید که نسخهٔ PHP مورد نظر از سوی سرور فعال (enabled) است و مسیر آن به درستی تنظیم شده باشد.
• در محیط اشتراکی یا تولیدی، انجام این کارها را در یک زمان با حداقل ترافیک انجام دهید تا سایت‌های کاربران دچار اختلال نشوند.
• اگر پس از این مراحل مشکل ادامه پیدا کرد، ممکن است لازم باشد با پشتیبانی CloudLinux یا تامین‌کننده میزبان خود تماس بگیرید و خطاهای دقیق موجود در /var/log و سایر لاگ‌ها را بررسی کنید.

جمع‌بندی

اگر با پیغام «Cannot get an extensions list for version $php_version» در PHP Selector مواجه شدید، مراحل زیر را دنبال کنید:

• بررسی کنید فایل اجرایی PHP یا بستهٔ مرتبط خراب یا ناقص نباشد.
• بستهٔ مربوطه را مجدداً نصب یا بازیابی کنید.
• ماژول‌ها و وابستگی‌ها را بررسی نمایید.
• ابزار PHP Selector را مجدداً اجرا یا تنظیم کنید.
• سرویس‌های مرتبط را ری‌استارت کنید.

با تکمیل این مراحل، معمولاً مشکل بازیابی فهرست افزونه‌ها برای نسخهٔ PHP برطرف می‌شود و کاربران می‌توانند بدون خطا نسخه‌ها را انتخاب و افزونه‌ها را مدیریت کنند.