خطای نصب mode_lsapi

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

• mod_lsapi: ماژول بسیار بهینهٔ Apache برای اجرای PHP روی CloudLinux که توسط CloudLinux توسعه داده شده و با PHP Selector سازگار است. جایگزین مدرن و سریع‌تر برای suPHP و mod_ruid2 و حتی در بسیاری موارد از PHP-FPM پایدارتر است.
• mod_ruid2: ماژول Apache برای اجرای پردازه‌های PHP با شناسهٔ کاربر (UID) واقعی، که در گذشته برای افزایش امنیت استفاده می‌شد، اما با LSAPI و PHP Selector سازگار نیست.
• mod_suexec: ماژول Apache که اجازه می‌دهد اسکریپت‌ها با سطح دسترسی کاربر صاحب فایل اجرا شوند. برای کارکرد درست LSAPI در بسیاری از سناریوها مورد نیاز است.
• PHP Selector: ابزار CloudLinux برای انتخاب نسخهٔ PHP و افزونه‌ها در سطح کاربر/دامنه، در محیط‌هایی مانند cPanel.
• liblsapi / liblsapi-devel: کتابخانه و هدرهای توسعه‌ای مورد نیاز برای mod_lsapi تا بتواند به‌درستی روی Apache کار کند.

📝 مقدمه

در سرورهایی که از CloudLinux + cPanel استفاده می‌کنند، معمولاً مدیران سرور تمایل دارند به جای mod_ruid2 از mod_lsapi استفاده کنند؛ چون هم با PHP Selector سازگار است و هم عملکرد و پایداری بهتری دارد.
با این حال، هنگام نصب یا سوئیچ به mod_lsapi ممکن است با خطای conflict (تعارض پکیج) روبه‌رو شوید. این خطا معمولاً به دلیل نصب بودن mod_ruid2 است که با LSAPI و PHP Selector سازگار نیست.

در این مقاله می‌بینی دقیقاً چه اتفاقی می‌افتد و چطور مشکل را قدم‌به‌قدم حل کنی.

❗ Issue (مشکل)

در هنگام نصب Apache mod_lsapi، نصب با خطای زیر شکست می‌خورد:

Apache mod_lsapi install fails with the following error:

Error: ea-apache24-mod_lsapi conflicts with 1:ea-apache24-mod_ruid2-0.9.8-18.el7.cloudlinux.x86_64

یعنی پکیج ea-apache24-mod_lsapi با پکیج ea-apache24-mod_ruid2 در تعارض است و نمی‌توانند هم‌زمان روی سرور فعال باشند.

🌐 Environment (محیط)

• CloudLinux OS 6 / 7 / 8
• cPanel
• Apache با EasyApache 4

🛠 Solution (راه‌حل)

برای رفع مشکل و نصب صحیح mod_lsapi باید ابتدا mod_ruid2 را حذف کنید و سپس LSAPI را نصب و فعال نمایید.

1️⃣ حذف mod_ruid2

yum remove ea-apache24-mod_ruid2

2️⃣ نصب mod_lsapi و پیش‌نیازهای آن

yum install ea-apache24-mod_suexec liblsapi liblsapi-devel ea-apache24-mod_lsapi

در این دستور:

• ea-apache24-mod_suexec برای اجرای صحیح اسکریپت‌ها در حالت suexec لازم است.
• liblsapi و liblsapi-devel کتابخانه و هدرهای مورد نیاز LSAPI هستند.
• ea-apache24-mod_lsapi خود ماژول Apache LSAPI است.

3️⃣ اجرای اسکریپت تنظیم LSAPI

/usr/bin/switch_mod_lsapi --setup

این دستور Apache را برای استفاده از LSAPI تنظیم می‌کند و هندلرهای لازم را ثبت می‌کند.

4️⃣ ری‌استارت Apache

service httpd restart

بعد از این مرحله، Apache باید بدون خطا بالا بیاید و از mod_lsapi استفاده کند.

🔍 Cause (علت)

mod_ruid2 با LSAPI و PHP Selector سازگار نیست.

بنابراین:

• هم‌زمان داشتن ea-apache24-mod_ruid2 و ea-apache24-mod_lsapi باعث تعارض می‌شود.
• CloudLinux صراحتاً اعلام کرده که برای استفاده از PHP Selector و LSAPI، نباید mod_ruid2 فعال باشد.

🔗 Useful links (لینک‌های مفید)

• ماتریس سازگاری (Compatibility Matrix) برای LVE و هندلرهای مختلف PHP:
  https://docs.cloudlinux.com/limits/#compatibility-matrix
• مستندات رسمی Apache mod_lsapi Pro:
  https://docs.cloudlinux.com/cloudlinux_os_components/#apache-mod-lsapi-pro

کیان پور