رفع خطای PHP Warning: Module ‘mysqli’ is already loaded

این خطا زمانی رخ می‌دهد که افزونه (ماژول) mysqli در PHP بیش از یک بار بارگذاری شود. این اتفاق معمولاً به دلیل تکرار در فایل‌های پیکربندی PHP یا تنظیمات اشتباه PHP Selector در CloudLinux به وجود می‌آید. در این مقاله، روش دقیق شناسایی و رفع این خطا را به صورت گام‌به‌گام بررسی می‌کنیم.

مفهوم خطا

در فایل خطای PHP یا هنگام اجرای دستورات مربوط به PHP ممکن است با هشدار زیر مواجه شوید:

PHP Warning:  Module "mysqli" is already loaded in Unknown on line 0

این پیام به معنای آن است که PHP در تلاش است ماژول mysqli را دوبار بارگذاری کند. در حالت عادی هر افزونه باید فقط یک‌بار Load شود. زمانی که در فایل‌های تنظیماتی مختلف بیش از یک بار تعریف شود، PHP هشدار بالا را نمایش می‌دهد.

دلایل بروز خطا

خطای فوق معمولاً در یکی از شرایط زیر رخ می‌دهد:

1. ماژول mysqli هم از طریق PHP Selector فعال شده و هم به‌صورت دستی در فایل php.ini تعریف شده است.
2. فایل تنظیمات افزونه mysqli.ini در مسیرهای مختلف PHP وجود دارد.
3. فایل‌های تنظیماتی از نسخه‌های قدیمی PHP باقی مانده‌اند و باعث بارگذاری تکراری می‌شوند.
4. در فایل اصلی php.ini دستور زیر به‌صورت مستقیم درج شده است:

extension=mysqli.so

1. در حالی‌که همین افزونه در مسیر /php.d/ نیز از طریق CloudLinux فعال شده است.

مراحل رفع خطا در CloudLinux

1. بررسی نسخه PHP فعال

ابتدا باید نسخه PHP فعال روی سرور یا دامنه را مشخص کنید.
اگر از cPanel استفاده می‌کنید، مسیر زیر را باز کنید:

cPanel → Software → Select PHP Version

نسخه فعال را یادداشت کنید، برای مثال:
PHP 7.4, PHP 8.0, یا PHP 8.1

در محیط SSH نیز می‌توانید با دستور زیر نسخه PHP را مشاهده کنید:

php -v

. پیدا کردن فایل‌های تنظیمات افزونه

در CloudLinux تمام تنظیمات PHP در مسیر /opt/alt/phpXX/ قرار دارد.
به‌جای XX نسخه PHP را جایگزین کنید، برای مثال:

/opt/alt/php81/etc/php.d.all/

در این مسیر فایل mysqli.ini را پیدا کنید.
سپس بررسی کنید آیا همین فایل در مسیر زیر نیز وجود دارد یا خیر:

/opt/alt/php81/etc/php.d/

اگر فایل mysqli.ini در هر دو مسیر موجود بود، یکی از آن‌ها باید غیرفعال شود.

3. غیرفعال کردن بارگذاری تکراری

در فایل‌هایی که افزونه دوبار بارگذاری شده است، معمولاً خط زیر وجود دارد:

extension=mysqli.so

برای جلوگیری از بارگذاری مجدد، در ابتدای این خط یک علامت ; قرار دهید تا غیرفعال شود:

;extension=mysqli.so

سپس فایل را ذخیره کنید.

4. تنظیم از طریق PHP Selector

اگر از CloudLinux PHP Selector استفاده می‌کنید، روش ساده‌تر این است که از طریق رابط کاربری کنترل‌پنل اقدام کنید.

1. وارد مسیر Select PHP Version شوید.
2. نسخه PHP مربوطه را انتخاب کنید.
3. تیک گزینه mysqli را بردارید و دوباره فعال کنید.
4. روی دکمه Save کلیک کنید تا تنظیمات بازسازی شود.

این کار باعث می‌شود فایل‌های پیکربندی افزونه مجدداً ایجاد شده و خطا برطرف شود.

5. بررسی نتیجه

پس از اعمال تغییرات، سرویس PHP یا وب‌سرور را ریستارت کنید تا تنظیمات جدید اعمال شوند.

برای LiteSpeed:

service lsws restart

برای Apache:

service httpd restart

سپس دستور زیر را در SSH اجرا کنید تا مطمئن شوید افزونه فقط یک بار بارگذاری شده است:

php -m | grep mysqli

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

افزونه‌هایی مانند mysqlnd و pdo_mysql ممکن است همزمان با mysqli فعال باشند، اما این موضوع باعث بروز خطا نمی‌شود.

برای جلوگیری از بروز مجدد این خطا، توصیه می‌شود فقط از PHP Selector برای فعال‌سازی افزونه‌ها استفاده کنید و از ویرایش دستی فایل‌های .ini خودداری نمایید.

پس از اعمال تغییرات، حتماً فایل خطا (error_log) را بررسی کنید تا مطمئن شوید پیغام تکراری حذف شده است.

نتیجه‌گیری

خطای
PHP Warning: Module ‘mysqli’ is already loaded
به‌معنای بارگذاری دوباره افزونه mysqli در تنظیمات PHP است. با بررسی فایل‌های پیکربندی و حذف تعریف تکراری، یا بازسازی تنظیمات از طریق PHP Selector در CloudLinux، می‌توان به‌راحتی این مشکل را برطرف کرد.