PHP 無法載入 mcrypt 擴展？終極排查與解決方案大全

前言

在使用 phpMyAdmin 或其他 PHP 應用時，經常會遇到「無法載入 mcrypt 擴展，請檢查 PHP 配置」的錯誤提示。這個問題在 Windows 環境下尤為常見，尤其是早期 PHP 5.x 版本。本文將系統梳理導致此錯誤的常見原因，並提供徹底的解決方案，幫助你快速恢復開發環境。

常見原因與對應解決方案

1. MySQL 服務未正確安裝或未啟動

雖然 mcrypt 是加密擴展，但部分整合環境（如早期的 AppServ、XAMPP）會將 MySQL 服務狀態與 PHP 擴展載入綁定檢查。請確認：

• MySQL 已正確安裝並註冊為系統服務
• 在「服務」管理器中，MySQL 相關服務處於「運行中」狀態
• 若服務啟動失敗，請檢查錯誤日誌（通常在 MySQL 安裝目錄下的 .err 文件）

2. 系統目錄缺少 libmcrypt.dll

PHP 的 mcrypt 擴展依賴 libmcrypt.dll 動態鏈接庫。在 Windows 系統中，PHP 會在以下路徑搜尋該文件：

• PHP 安裝目錄
• 系統目錄 C:\Windows\System32（64 位系統為 C:\Windows\SysWOW64）
• 當前工作目錄
• PATH 環境變量包含的目錄

解決方法： 從 PHP 安裝目錄（如 D:\php）複製 libmcrypt.dll 到 C:\Windows\System32，然後重啟 Web 服務（Apache/IIS/Nginx）。

3. php.ini 中未啟用 mcrypt 擴展

打開 PHP 配置文件 php.ini（通常位於 PHP 安裝目錄或 C:\Windows），搜尋：

;extension=php_mcrypt.dll

將行首分號 ; 移除以啟用擴展：

extension=php_mcrypt.dll

修改後務必重啟 Web 服務使配置生效。

4. MySQL 目錄權限設置不當

權限問題可能導致 PHP 無法讀取 MySQL 相關文件，間接觸發擴展載入失敗。建議設置如下權限：

• Administrators：完全控制
• SYSTEM：完全控制
• Users：讀取與執行
• 移除其他非必要用戶權限（提升安全性）

修改權限後，重啟 MySQL 服務與 Web 服務，建議直接重啟伺服器確保生效。

5. 環境變量缺少 PHP 配置路徑（隱藏殺手）

這是網上較少提及但極其關鍵的一步。在 Windows XP/2003 等舊系統中，PHP 可能無法正確定位 php.ini。需手動添加系統環境變量：

• 右鍵「我的電腦」→「屬性」→「高級」→「環境變量」
• 在「系統變量」區域點擊「新建」
• 變量名：phprc
• 變量值：PHP 安裝目錄（如 D:\php）

設置完成後重啟伺服器，PHP 即能正確讀取配置文件並載入擴展。

驗證方案

依次執行以下步驟確認問題解決：

1. 在命令行執行 php -m | findstr mcrypt，若輸出 mcrypt 則擴展已載入
2. 建立 phpinfo.php 文件，內容為 ，瀏覽器訪問搜尋「mcrypt」區塊
3. 重新訪問 phpMyAdmin，錯誤提示應消失

現代環境提示

注意： mcrypt 擴展自 PHP 7.1 起被棄用，PHP 7.2 移除內建支持。現代項目建議改用 OpenSSL 或 Sodium（PHP 7.2+ 內建）進行加密操作。若維護舊專案，可考慮使用 PECL 安裝 mcrypt 兼容包，但長遠規劃應遷移至現代加密庫。