解決 PHP mcrypt 擴展未安裝：Windows 下啟用 mcrypt.so 完整步驟

解決 PHP mcrypt 擴展未安裝問題

安裝 ShopEx 等舊版 PHP 系統時常報錯：「服務器 Mcrypt.so 加密庫未安裝」。mcrypt 是 PHP 早期常用的加密擴展，**PHP 7.2 已棄用，7.4 移除**，現代專案應遷移至 openssl 或 sodium。本文針對必須維護舊系統的場景，提供 Windows 環境下啟用 mcrypt 步驟。

檢查現狀

php -m | findstr mcrypt
# 或建立 phpinfo.php 頁面檢視

若無輸出，則未載入。

Windows 環境啟用步驟 (PHP 5.x / 7.0 / 7.1)

1. 確認 DLL 文件存在：PHP 安裝目錄下應有 php_mcrypt.dll、libmcrypt.dll、libmhash.dll。若無，從官方對應版本 ZIP 包獲取。
2. 複製依賴庫至系統路徑：將 libmcrypt.dll、libmhash.dll 複製到 C:\Windows\System32 (64位系統) 或 C:\Windows\SysWOW64 (32位 PHP 運行於 64位系統)。
3. 修改 php.ini：搜尋並取消註釋以下兩行 (移除前面分號 ;)：

extension=php_mcrypt.dll
extension=php_mhash.dll

4. 重啟 Web 服務：

• Apache：httpd -k restart 或服務管理器重啟
• IIS：iisreset 或應用程式池回收
• PHP-FPM (Nginx)：重啟 php-fpm 服務

5. 驗證：重新執行 php -m | findstr mcrypt 或刷新 phpinfo，應顯示 mcrypt support => enabled。

常見問題排查

現代替代方案 (PHP 7.2+ 必讀)

mcrypt 已從 PHP 核心移除**，PECL 仍提供 pecl install mcrypt 但不再維護。請遷移至：