PHP Warning: Module 'modulename' already loaded in Unknown on line 0
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/ 目錄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 → 重複載入
php.ini 只寫 extension=redis,確認 extension_dir 正確,不要 在 extension_dir 放入額外 .so(或移除設定檔中的指令)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.inixdebug:開發環境常重複pdo_mysql、mysqli:核心模組通常不會重複apt install php8.2-redis 自動處理設定php -m 檢查模組清單是否有重複extension=extension_dir 自動掃描 + 明確 extension= 雙重載入conf.d/ 目錄管理擴展載入,php.ini 不寫 extension=php -v 無警告、get_loaded_extensions() 無重複