萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP "Module already loaded" 警告解決方案:兩大原因與排查步驟

錯誤訊息

PHP Warning: Module 'modulename' already loaded in Unknown on line 0

原因一:模組重複載入(php.ini + conf.d 雙重載入)

現象

PHP 讀取主設定檔 php.ini 時載入模組,又從 conf.d/ 目錄下的 *.ini 重複載入同一模組。

排查步驟

# 1. 查看 PHP 載入的設定檔
php --ini

# 輸出範例:
Configuration File (php.ini) Path: /etc/php/8.2/cli
Loaded Configuration File:         /etc/php/8.2/cli/php.ini
Scan for additional .ini files in: /etc/php/8.2/cli/conf.d
Additional .ini files parsed:      /etc/php/8.2/cli/conf.d/10-opcache.ini
                                   /etc/php/8.2/cli/conf.d/20-redis.ini
                                   /etc/php/8.2/cli/conf.d/20-mongodb.ini

檢查重複載入

# 2. 檢查 php.ini 是否有 extension=xxx
grep -n "extension=" /etc/php/8.2/cli/php.ini

# 3. 檢查 conf.d 下所有 ini
grep -r "extension=" /etc/php/8.2/cli/conf.d/

# 4. 找出重複的模組名稱
# 例:php.ini 有 extension=redis,conf.d/20-redis.ini 也有 extension=redis

解決方法

  • 刪除 php.ini 中的重複行,統一由 conf.d 管理(推薦)
  • 或刪除 conf.d 中對應的 .ini 檔
  • 建議:php.ini 只保留核心設定,擴展模組全放 conf.d/ 目錄

原因二:extension_dir 指向目錄包含 .so,且 php.ini 又明確載入

現象

extension_dir 目錄下有 redis.so,php.ini 中又寫 extension=redis,PHP 啟動時會自動掃描 extension_dir 載入所有 .so,再加上明確指定載入一次,導致重複。

排查步驟

# 1. 查看 extension_dir
php -i | grep extension_dir
# extension_dir => /usr/lib/php/20220829

# 2. 查看該目錄下的 .so 檔
ls /usr/lib/php/20220829/*.so

# 3. 對比 php.ini/conf.d 中的 extension 指令
# 若 extension_dir 下有 redis.so,且設定檔又有 extension=redis → 重複載入

解決方法

  • 方法 A:php.ini 只寫 extension=redis,確認 extension_dir 正確,不要 在 extension_dir 放入額外 .so(或移除設定檔中的指令)
  • 方法 B:php.ini 不寫 extension=redis,讓 PHP 自動掃描 extension_dir 載入(不推薦,難控制順序)
  • 最佳實務:明確在 conf.d/xx-modulename.ini 指定 extension=modulename,extension_dir 保持預設

完整排查腳本

<?php
// check_module_duplicates.php
// 執行:php check_module_duplicates.php

$loaded = get_loaded_extensions();
$counts = array_count_values($loaded);
$duplicates = array_filter($counts, fn($c) => $c > 1);

if ($duplicates) {
    echo "發現重複載入模組:\n";
    foreach ($duplicates as $mod => $count) {
        echo "  $mod: 載入 $count 次\n";
    }
    exit(1);
} else {
    echo "無重複載入模組 ✅\n";
    exit(0);
}
?>

驗證修復

# 重啟 PHP-FPM / Apache
sudo systemctl restart php8.2-fpm
# 或
sudo systemctl restart apache2

# 再次檢查警告
php -v
# 應無 "Module already loaded" 警告

常見受影響模組

  • opcache:常在 php.ini 和 10-opcache.ini 重複
  • redis、mongodb、memcached:PECL 安裝產生 conf.d,手動又加入 php.ini
  • xdebug:開發環境常重複
  • pdo_mysql、mysqli:核心模組通常不會重複

預防清單

  1. 安裝擴展時只用一種方式:PECL 安裝會自動建立 conf.d,勿手動改 php.ini
  2. 使用套件管理器安裝:apt install php8.2-redis 自動處理設定
  3. 定期執行 php -m 檢查模組清單是否有重複
  4. 版本升級後檢查:舊版 conf.d 殘留可能導致衝突

總結

  • 原因 1:php.ini + conf.d/*.ini 重複指定 extension=
  • 原因 2:extension_dir 自動掃描 + 明確 extension= 雙重載入
  • 核心解決:統一由 conf.d/ 目錄管理擴展載入,php.ini 不寫 extension=
  • 驗證:php -v 無警告、get_loaded_extensions() 無重複
copyright © 萬盛學電腦網 all rights reserved