رفع مشکل فعال‌ سازی افزونه JSON در CloudLinux PHP Selector

فعال‌ سازی افزونه JSON یکی از نیازهای رایج مدیران سرور هنگام کار با CloudLinux PHP Selector است. گاهی کاربران متوجه می‌شوند که این افزونه در لیست افزونه‌ها وجود دارد اما با وجود فعال‌سازی، همچنان عملکرد JSON در اسکریپت‌های PHP غیرفعال باقی می‌ماند. این مشکل معمولاً به دلیل تغییرات دستی در فایل‌های پیکربندی PHP یا ناسازگاری در نسخه‌های PHP ایجاد می‌شود.

علت اصلی بروز خطا فعال‌ سازی افزونه JSON

در بیشتر موارد، فایل پیکربندی افزونه JSON که در مسیر
/opt/alt/php7x/etc/php.d.all/json.ini
قرار دارد، دچار تغییرات ناخواسته یا ویرایش دستی شده است. CloudLinux از ساختار بسته‌های alt-php برای مدیریت افزونه‌ها استفاده می‌کند و هرگونه ویرایش مستقیم در فایل‌های .ini می‌تواند موجب غیرفعال شدن افزونه JSON شود.

برای بررسی وضعیت فایل، می‌توانید دستور زیر را اجرا کنید:

rpm -V alt-php74-common

rpm -V alt-php74-common

در صورتی که خروجی نشان‌دهنده تغییر در فایل json.ini باشد، لازم است آن را به حالت اصلی برگردانید.

روش صحیح فعال‌ سازی افزونه JSON

برای اطمینان از فعال بودن افزونه JSON، مراحل زیر را دنبال کنید:

۱. بازرسی فایل پیکربندی:

فایل json.ini را باز کرده و مطمئن شوید شامل خط زیر است:

extension=json.so

extension=json.so

نبود این خط یا وجود علائم اضافی ممکن است مانع از بارگذاری افزونه شود.

۲. بازنشانی تنظیمات PHP Selector:

پس از ویرایش فایل، PHP Selector را باز کنید و نسخه مربوط به PHP را انتخاب کرده، سپس گزینه JSON را دوباره فعال نمایید.

۳. بررسی محیط CageFS:

در سیستم‌هایی که از CageFS استفاده می‌کنند، گاهی تغییرات PHP برای کاربر اعمال نمی‌شود. با اجرای دستورات زیر می‌توان فایل‌های پیکربندی کاربر را بازنشانی کرد:

cagefsctl --disable username  
cagefsctl --enable username

cagefsctl --disable username  
cagefsctl --enable username

۴. ری‌استارت وب‌سرور:

پس از اطمینان از صحت فایل‌ها، سرویس Apache یا LiteSpeed را ری‌استارت کنید تا تغییرات اعمال شوند.

نکات مهم درباره فعال‌ سازی افزونه JSON

• بررسی کنید نسخه PHP انتخابی در PHP Selector با مسیر فایل‌های پیکربندی مطابقت داشته باشد.
• از ویرایش مستقیم فایل‌های پکیج‌شده PHP خودداری کنید؛ تغییرات باید از طریق PHP Selector انجام شوند.
• در صورت بروز خطا، با اجرای دستور php -m می‌توانید بررسی کنید آیا افزونه JSON در لیست افزونه‌های فعال وجود دارد یا خیر.
• اگر همچنان مشکل پابرجاست، بهتر است بسته PHP مربوطه را دوباره نصب کنید تا فایل‌های .ini به‌صورت پیش‌فرض بازسازی شوند.

فعال‌ سازی افزونه JSON در CloudLinux PHP Selector زمانی دچار خطا می‌شود که فایل پیکربندی آن به‌صورت دستی ویرایش شده باشد یا نسخه PHP نادرست انتخاب شود. با بررسی محتویات فایل json.ini، بازنشانی محیط CageFS و اجرای مجدد PHP Selector می‌توان این مشکل را به‌راحتی برطرف کرد. رعایت اصول صحیح در مدیریت افزونه‌های PHP نه‌تنها از بروز خطا جلوگیری می‌کند، بلکه باعث پایداری و کارایی بیشتر محیط CloudLinux نیز می‌شود.