رفع خطای ('Unable to load dynamic library 'tidy.so) پس از به‌روزرسانی (ea-libtidy)

در روزهای اخیر، بسیاری از مدیران سرورهای CloudLinux و cPanel با خطای ‘Unable to load dynamic library ‘tidy.so مواجه شده‌اند. این مشکل معمولاً پس از به‌روزرسانی بسته‌ی ea-libtidy رخ می‌دهد و هنگام راه‌اندازی PHP به شکل زیر مشاهده می‌شود:

PHP Startup: Unable to load dynamic library 'tidy.so' (tried: /opt/cpanel/ea-php72/root/usr/lib64/php/modules/tidy.so (libtidy.so.5: cannot open shared object file: No such file or directory), /opt/cpanel/ea-php72/root/usr/lib64/php/modules/tidy.so.so (/opt/cpanel/ea-php72/root/usr/lib64/php/modules/tidy.so.so: cannot open shared object file: No such file or directory)) in Unknown:0

PHP Startup: Unable to load dynamic library 'tidy.so' (tried: /opt/cpanel/ea-php72/root/usr/lib64/php/modules/tidy.so (libtidy.so.5: cannot open shared object file: No such file or directory), /opt/cpanel/ea-php72/root/usr/lib64/php/modules/tidy.so.so (/opt/cpanel/ea-php72/root/usr/lib64/php/modules/tidy.so.so: cannot open shared object file: No such file or directory)) in Unknown:0

این پیام نشان می‌دهد که PHP نمی‌تواند ماژول tidy.so را بارگذاری کند، زیرا فایل کتابخانه‌ی اصلی libtidy در مسیر مورد انتظار وجود ندارد یا با نسخه‌ی جدید سازگار نیست.

دلیل بروز خطا

مشکل ‘Unable to load dynamic library ‘tidy.so ناشی از به‌روزرسانی بسته‌ی ea-libtidy از نسخه‌های قدیمی به نسخه‌های جدیدتر است. تغییر مسیرها یا وابستگی‌های ماژول باعث شده PHP نتواند کتابخانه‌ی مورد نیاز را پیدا کند. این خطا بیشتر روی سرورهایی با EasyApache 4 و CloudLinux دیده می‌شود.

تأثیر بر عملکرد سایت‌ها

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

خطای ‘Unable to load dynamic library ‘tidy.so می‌تواند باعث نمایش هشدارها در لاگ‌ها، اختلال در اجرای برخی اسکریپت‌ها یا کاهش کارایی سرور شود.

روش رفع خطا

۱. به‌روزرسانی بسته‌های مرتبط

ابتدا همه بسته‌های مرتبط با PHP و tidy را به آخرین نسخه ارتقا دهید:

yum update ea-php*php*tidy* ea-libtidy

yum update ea-php*php*tidy* ea-libtidy

این دستور باعث نصب نسخه‌ی جدید کتابخانه‌ی libtidy و ماژول‌های PHP شده و وابستگی‌ها را اصلاح می‌کند.

۲. اطمینان از نصب libtidy

اگر هنوز خطای Unable to load dynamic library ‘tidy.so’ پابرجاست، مطمئن شوید بسته‌ی libtidy نصب شده است:

yum install libtidy

yum install libtidy

این کار فایل کتابخانه‌ی libtidy.so را در مسیرهای لازم ایجاد می‌کند.

۳. ری‌استارت وب سرور

پس از به‌روزرسانی، وب‌سرور را ری‌استارت کنید تا تغییرات اعمال شوند:

service httpd restart

service httpd restart

خطای ‘Unable to load dynamic library ‘tidy.so یکی از مشکلات رایج پس از به‌روزرسانی بسته‌های PHP در CloudLinux است. این مشکل به‌علت ناسازگاری نسخه‌های جدید ea-libtidy با مسیرهای ماژول PHP ایجاد می‌شود.

با اجرای چند دستور ساده و به‌روزرسانی بسته‌های مربوطه، این خطا به‌راحتی رفع می‌شود. مدیران سرور می‌توانند با انجام به‌روزرسانی‌های منظم و پایش لاگ‌های PHP، از بروز مشکلات مشابه جلوگیری کنند.