خطای ساپورت نشدن php-handler در کلودلینوکس

🧩 تعاریف کلیدی

• CloudLinux PHP Selector: ابزار مخصوص CloudLinux برای انتخاب نسخه‌های مختلف PHP برای هر کاربر هاست اشتراکی.
• mod_suexec: ماژولی برای Apache که اجرای اسکریپت‌ها را با سطح دسترسی کاربران انجام می‌دهد تا امنیت افزایش یابد.
• mod_ruid2: ماژولی مشابه suexec است، اما گاهی با PHP Selector سازگاری کامل ندارد.
• ea-apache24: نسخه بهینه‌شده از Apache 2.4 است که توسط cPanel ارائه می‌شود.
• CageFS: محیط مجزای کاربران در CloudLinux برای ایزوله‌سازی و افزایش امنیت.
• cagefsctl –force-update: دستور برای بروزرسانی یا بازسازی فایل‌های اسکلت (skeleton) در CageFS جهت همگام‌سازی تنظیمات جدید.

🧠 مقدمه

در برخی سرورهایی که از CloudLinux همراه با PHP Selector استفاده می‌کنند، ممکن است هنگام باز کردن داشبورد CloudLinux خطایی مبنی بر ناسازگاری PHP Selector مشاهده شود.
این خطا معمولاً به‌دلیل نبود ماژول‌های لازم مانند mod_suexec در Apache یا وجود mod_ruid2 است که باعث تداخل با PHP Selector می‌شود.

⚙️ شرح خطا

در داشبورد CloudLinux خطای زیر نمایش داده می‌شود:

Check compatibility for PHP Selector

Looks like your PHP handler doesn't support CloudLinux PHP Selector
and as a result does not work 
http://docs.cloudlinux.com/index.html?compatiblity_matrix.html 

[It looks like you do not have mod_suphp or mod_suexec installed. 
CloudLinux PHP Selector doesn't work properly without it] 
Please, see: https://docs.cloudlinux.com/command-line_tools/#check-phpselector 
and try to fix issue to have working selector

در بسیاری از موارد، این خطا در سرورهایی با Apache نسخه‌ی ea-apache24 رخ می‌دهد.

🌍 محیط اجرا

• سیستم‌عامل: CloudLinux
• وب‌سرور: ea-apache24 (cPanel Apache 2.4)
• ابزار: PHP Selector

🔍 علت بروز خطا

دلیل اصلی بروز این خطا، نصب نبودن ماژول mod_suexec در Apache است.
PHP Selector برای عملکرد صحیح به یکی از این دو ماژول نیاز دارد:

• mod_suexec
• یا mod_suphp

اگر در سرور mod_ruid2 نصب باشد، PHP Selector به درستی کار نمی‌کند زیرا این ماژول با CageFS و LVE در CloudLinux سازگاری کامل ندارد.

🧰 روش رفع مشکل

🔹 ۱. نصب ماژول mod_suexec

برای نصب ماژول موردنیاز، دستور زیر را اجرا کنید:

yum install ea-apache24-mod_suexec

🔹 ۲. حذف mod_ruid2 در صورت نصب بودن

اگر سرور شما دارای mod_ruid2 است، ابتدا باید آن را حذف کرده و سپس suexec را نصب کنید:

yum remove ea-apache24-mod_ruid2
yum install ea-apache24-mod_suexec

🔹 ۳. راه‌اندازی مجدد Apache

پس از نصب، برای اعمال تغییرات Apache را ریستارت کنید:

service httpd restart

🔹 ۴. بروزرسانی CageFS (در صورت استفاده)

اگر از CageFS + PHP Selector استفاده می‌کنید، پس از انجام تغییرات حتماً اسکلت CageFS را بروزرسانی کنید:

cagefsctl --force-update

⚠️ نکته مهم

در صورت استفاده از mod_ruid2، CloudLinux PHP Selector قادر به مدیریت نسخه‌های PHP کاربران نخواهد بود.
بنابراین، توصیه می‌شود فقط از mod_suexec یا mod_suphp استفاده شود تا سازگاری کامل با سیستم LVE و CageFS حفظ گردد.

✅ نتیجه‌گیری

اگر در CloudLinux هنگام باز کردن داشبورد با خطای

“Looks like your PHP handler doesn’t support CloudLinux PHP Selector”

روبه‌رو شدید، مشکل به احتمال زیاد ناشی از نبود mod_suexec در Apache است.
با نصب این ماژول و حذف mod_ruid2 (در صورت وجود)، عملکرد PHP Selector به حالت عادی بازمی‌گردد.
در نهایت، برای اطمینان از سازگاری کامل تنظیمات، دستور
cagefsctl --force-update
را اجرا کنید.

کیان پور