Windows 環境下啟用 PHP Mcrypt 擴展完整步驟

ShopEx 等舊版 PHP 應用安裝時常提示「Mcrypt.so 加密庫未安裝」。在 Windows 平台，PHP 套件已內建 libmcrypt.dll 與 libmhash.dll，僅需啟用對應擴展即可。本文提供標準化啟用流程。

前置檢查

1. 確認 PHP 安裝目錄 (如 C:\php) 下存在 libmcrypt.dll、libmhash.dll。
2. 確認 ext 目錄下有 php_mcrypt.dll、php_mhash.dll。

啟用步驟

1. 複製依賴庫至系統路徑
   將 libmcrypt.dll、libmhash.dll 複製至 C:\Windows\System32 (64 位系統亦放此處，或依 PHP 進程位數放入 SysWOW64)。
2. 編輯 php.ini 啟用擴展
   搜尋並取消註解以下兩行：
   extension=php_mcrypt.dll
extension=php_mhash.dll
3. 重啟 Web 伺服器生效
   Apache: 重啟服務或執行 httpd -k restart
   IIS: 執行 iisreset 或回收應用程式集區。
4. 驗證安裝
   建立 phpinfo.php，搜尋 mcrypt、mhash 區塊，確認 mcrypt support => enabled。

常見問題排查

• 錯誤： Unable to load dynamic library 'php_mcrypt.dll'
  原因： 依賴 DLL 未放入系統 PATH 目錄。
  解決： 重新執行步驟 1，確保 DLL 在 System32 或 PHP 目錄 (已在 PATH 中)。
• 版本提示： PHP 7.2+ 已棄用 Mcrypt，改用 OpenSSL/Sodium。
  建議： 升級應用程式代碼，移除對 Mcrypt 依賴；若必須維護舊系統，請停留在 PHP 7.1 或更早版本。

完成上述步驟即可解決「Mcrypt 加密庫未安裝」錯誤，讓舊版 PHP 電商系統順利運行。