🧩 تعاریف کلیدی مقاله

• mod_lsapi: ماژول Apache ارائه‌شده توسط CloudLinux برای اجرای PHP با کارایی بالا و سازگاری قوی، جایگزین suPHP و PHP-FPM.
• CRIU: مکانیزم Linux برای ذخیره و بازیابی وضعیت پردازش‌ها که mod_lsapi ممکن است به آن وابستگی داشته باشد.
• DirectAdmin CustomBuild: سیستم ساخت و نصب بسته‌ها و ماژول‌ها در کنترل‌پنل DirectAdmin.
• undefined symbol: خطای مربوط به بارگذاری یک ماژول وقتی که توابع لازم در کتابخانه یا نسخه فعلی برنامه پیدا نمی‌شود.

📝 مقدمه

در برخی سرورها هنگام اجرای دستور بررسی پیکربندی Apache با httpd -t، ممکن است با خطای مرتبط با mod_lsapi مواجه شوید.
این خطا معمولاً به دلیل ناسازگاری نسخه mod_lsapi با سیستم یا خرابی فایل‌های کش CustomBuild در DirectAdmin رخ می‌دهد.
این مقاله به شما کمک می‌کند تا مشکل را سریعاً رفع کنید.

❗ مشکل (Issue)

اجرای دستور:

httpd -t

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

httpd: Syntax error ...
Cannot load /usr/lib/apache/mod_lsapi.so into server:
/usr/lib/apache/mod_lsapi.so: undefined symbol: lscapi_set_criu_socket_path

🌐 محیط (Environment)

• CloudLinux 9.5
• DirectAdmin
• mod_lsapi-1.1-81

🛠️ راه‌حل (Solution)

1️⃣ حذف فایل cache مربوط به mod_lsapi

این فایل ممکن است خراب شده باشد و باعث نصب ناقص ماژول گردد:

rm -rf /usr/local/directadmin/custombuild/cache/mod_lsapi-1.1-81.tar.gz

2️⃣ اگر فقط در حال ارتقای mod_lsapi هستید

نیازی به نصب مجدد کامل نیست، فقط:

cd /usr/local/directadmin/custombuild
da build mod_lsapi
systemctl restart httpd

این کار نسخه سالم را دانلود و کامپایل کرده و خطا را رفع می‌کند.

3️⃣ اگر مشکل عمومی‌تر است یا mod_lsapi قبلاً نصب نشده

دستورالعمل کامل نصب CloudLinux mod_lsapi برای DirectAdmin را دنبال کنید:

🔗 Installing on DirectAdmin servers:
https://docs.cloudlinux.com/cloudlinuxos/cloudlinux_os_components/#installing-on-directadmin-servers

🔍 علت (Cause)

• نسخه mod_lsapi دارای خطا یا ناقص است.
• فایل cache مربوط به بسته خراب شده و منجر به نصب ناقص می‌شود.
• Apache قادر به پیدا کردن تابع lscapi_set_criu_socket_path در کتابخانه داخلی LsAPI نیست، بنابراین ماژول بارگذاری نمی‌شود.

کیان پور