مدیریت ماژول‌های PHP در PHP Selector برای نسخه‌های متفاوت PHP به ازای هر دامنه

مقدمه

در سرورهایی که از سیستم‌عامل CloudLinux استفاده می‌شود، ابزار PHP Selector این امکان را فراهم می‌کند که کاربران یا مدیران بتوانند نسخهٔ PHP متفاوتی برای هر دامنه، زیر‌دامنه یا حتی پوشه مشخص تنظیم کنند. با این قابلیت، دامنه‌های مختلف می‌توانند نیازمندی‌های متفاوتی از لحاظ نسخهٔ PHP و افزونه‌ها داشته باشند.

اما یکی از موضوعات مهم در این زمینه، ماژول‌ها (Extensions)، یعنی افزونه‌های PHP‌ مانند mysqli، gd، intl، etc است. وقتی نسخهٔ PHP تغییر می‌کند، گاهی نیاز است که ماژول‌های فعال‌شده نیز برای آن نسخهٔ جدید یا متفاوت تنظیم شوند. این مقاله به شما نشان می‌دهد چگونه ماژول‌های PHP را مدیریت کنید وقتی از نسخه‌های مختلف PHP برای هر دامنه استفاده می‌کنید، همراه با نکات عملی و خطاهای رایج.

چرا این مدیریت مهم است؟

• هر نسخهٔ PHP می‌تواند ماژول‌ها و تنظیمات خاص خود را داشته باشد؛ اگر دامنه‌ای روی نسخهٔ قدیمی‌تر باشد ولی ماژول‌های آن نسخه غیرفعال باشند، ممکن است سایت با خطا مواجه شود.
• اگر چند نسخهٔ PHP روی یک سرور فعال باشند و دامنه‌ای به نسخهٔ متفاوتی سوئیچ کند، تنظیمات ماژول‌ها باید هماهنگ شوند تا سایت بدون مشکل اجرا شود.
• قابلیت انتخاب نسخهٔ PHP به ازای هر دامنه (feature of PHP Selector) یکی از مزایای کلیدی CloudLinux است. features.cloudlinux.com+1
• در واقع، اگر فقط نسخهٔ PHP تغییر کند اما ماژول‌های مورد نیاز فعال نشوند، عملکرد سایت ممکن است ناقص شود یا افزونه‌ها کار نکنند.

مراحل انجام کار

در ادامه، گام‌به‌گام نحوهٔ تغییر ماژول‌های PHP هنگام استفاده از نسخه‌های مختلف PHP برای هر دامنه توضیح داده شده است:

۱. انتخاب نسخهٔ PHP برای دامنه یا زیر‌دامنه

• وارد پنل مدیریت (مثلاً cPanel/WHM یا پنل مشابه) شوید.
• به بخش PHP Selector بروید.
• نسخهٔ مورد نظر PHP را برای دامنه یا زیر‌دامنه تنظیم کنید (مثلاً PHP 7.4، PHP 8.0 یا نسخهٔ alt‑PHP) Liquid Web
• تأکید: این فقط تعیین نسخه است؛ ماژول‌ها پس از آن باید تنظیم شوند.

۲. انتخاب یا فعال‌سازی ماژول‌های PHP برای آن نسخه

• پس از انتخاب نسخهٔ PHP، باید به ماژول‌های آن نسخه دسترسی داشته باشید. در PHP Selector گزینه‌ای مانند «Extensions» یا «Modules» وجود دارد که ماژول‌های فعال‌شده را نمایش می‌دهد.
• مثال: فرض کنید دامنه‌ای روی PHP 8.0 قرار گرفته، ولی ماژول mysqli یا gd برای نسخه ۸.۰ فعال نشده است — باید وارد بخش ماژول‌ها شده و آن‌ها را فعال کنید.
• اگر ماژولی در نسخهٔ موردنظر وجود ندارد، ممکن است بستهٔ مرتبط آن روی سرور نصب نشده باشد یا ماژول برای آن نسخه PHP ساخته نشده باشد.

۳. بررسی تنظیمات اختصاصی ماژول‌ها (در صورت نیاز)

• ممکن است لازم باشد فایل‌های پیکربندی اضافی برای ماژول‌ها مورد بررسی قرار گیرند؛ مانند /opt/alt/php80/etc/php.d/module.ini یا مسیر معادل برای نسخهٔ PHP انتخاب‌شده.
• بعضی ماژول‌ها ممکن است نیاز به نسخهٔ مخصوص یا به‌روز داشته باشند.
• اطمینان یابید که کاربر تحت سیستم CageFS و LVE مجاز به استفاده از ماژول‌ها است، در صورت استفاده از این محدودیت‌ها.

۴. تست دامنه و مشاهده phpinfo

• پس از فعال‌سازی ماژول‌ها، یک فایل phpinfo.php در روت دامنه ایجاد کنید با محتوایی مانند:

<?php phpinfo(); ?>

• در مرورگر دامنه را باز کنید و بررسی کنید که نسخهٔ PHP صحیح نمایش داده شود و ماژول‌های فعال‌شده در لیست افزونه‌ها ظاهر شوند.
• اگر ماژول‌هایی که انتظار دارید حضور ندارند، باید مراحل نصب یا فعال‌سازی آن ماژول‌ها را بررسی کنید.

۵. اگر ماژول برای آن نسخه وجود ندارد

• ممکن است آن ماژول خاص برای آن نسخهٔ PHP ساخته نشده یا نصب نشده باشد. در این صورت باید بستهٔ آن ماژول را نصب یا ارتقاء دهید. برای مثال در سیستم‌های CloudLinux ممکن است نیاز به نصب گروهی از ماژول‌ها برای نسخهٔ خاص داشته باشید.
• اگر پس از نصب ماژول، هنوز ظاهر نشد، ممکن است سرویس PHP-FPM یا وب‌سرور (Apache/Nginx) نیاز به ری‌استارت داشته باشند.

نکات و هشدارهای مهم

• به خاطر داشته باشید که فعال‌سازی ماژول‌ها بر اساس نسخهٔ PHP انجام می‌شود؛ یعنی ماژولی که برای PHP 7.4 فعال شده لزوماً برای PHP 8.0 فعال نیست — باید جداگانه فعال شود.
• در پنل‌های اشتراکی، ممکن است انتخاب نسخه و ماژول‌ها توسط کاربر کنترل شود. در این حالت، مدیر سرور باید مطمئن شود ماژول‌ها برای نسخه‌های مختلف قابل انتخاب و استفاده هستند.
• اگر از نسخه‌های alt‑PHP استفاده می‌کنید (مثلاً alt‑php72، alt‑php80) باید بررسی کنید که ماژول‌ها برای آن نسخه نصب و آماده باشند.
• اگر دامنه‌ای به نسخهٔ متفاوت PHP تغییر یافت و سپس با ارور یا کارکرد نادرست مواجه شد، اولین گام بررسی ماژول‌های فعال‌شده برای آن نسخه است.
• در برخی موارد، اگر نسخهٔ PHP را در فایل .htaccess یا تنظیمات پنل تعیین کرده‌اید، این نسخه ممکن است ماژول‌ها یا تنظیمات متفاوتی نسبت به نسخهٔ پیش‌فرض داشته باشد؛ بنابراین حتماً phpinfo را چک کنید. DirectAdmin Forums

جمع‌بندی

به‌طور خلاصه، اگر در سرور با ابزار PHP Selector و بر روی محیط CloudLinux نسخهٔ PHP را برای هر دامنه یا زیر‌دامنه تنظیم می‌کنید، مراحل زیر را حتماً طی کنید:

• نسخهٔ PHP را برای آن دامنه یا زیر‌دامنه تعیین کنید.
• وارد بخش ماژول‌ها/افزونه‌های PHP آن نسخه شوید و ماژول‌های مورد نیاز را فعال کنید.
• یک فایل phpinfo بسازید و مطمئن شوید نسخه و ماژول‌ها درست نمایش داده می‌شوند.
• اگر ماژول لازم نبود یا نصب نشده بود، آن را نصب یا فعال کنید و در صورت نیاز سرویس‌ها را ری‌استارت کنید.
  با انجام این مراحل، عملکرد سایت‌ها تحت نسخهٔ PHP انتخاب‌شده همراه با ماژول‌های مورد نیاز تضمین خواهد شد.