Windows 環境啟用 PHP intl 擴展常遇到「無法載入動態程式庫 php_intl.dll」錯誤。原因是 intl 依賴 ICU 庫,需將相關 DLL 複製到 Apache 執行目錄。
從 PHP 安裝目錄複製以下檔案到 Apache 的 bin 目錄:
icudt##.dll
icuin##.dll
icuio##.dll
icule##.dll
iculx##.dll
icutest##.dll
icutu##.dll
icuuc##.dll
## 為版本號 (如 70, 71, 72...),視 PHP 版本而定。必須複製到 Apache bin 目錄,而非 PHP 目錄,因為 Apache 進程載入 PHP 時搜尋 DLL 路徑包含自身 bin 目錄。
; php.ini
extension=intl
; 或舊版
; extension=php_intl.dll
# 命令列
httpd -k restart
# 或服務管理器重啟 Apache 服務
<?php
phpinfo();
// 搜尋 "intl" 區塊,應顯示:
// intl support => enabled
// ICU version => 70.1 (或其他版本)
?>
將 PHP 安裝目錄加入系統環境變數 PATH:
Path → 編輯 → 新增 C:\php (你的 PHP 目錄)此法讓系統全域可找到 PHP DLL,但可能造成版本衝突,優先推薦複製到 Apache bin。
| 錯誤現象 | 原因與解決 |
|---|---|
| PHP Warning: Unable to load dynamic library 'intl' | ICU DLL 未在搜尋路徑。複製到 Apache bin 或加 PATH |
| Class 'NumberFormatter' not found | intl 未啟用。檢查 phpinfo() 確認 intl 區塊 |
| 版本不匹配 | PHP 8.1 需 ICU 70+,PHP 8.2 需 ICU 71+。確認 DLL 版本對應 |
| Thread Safe vs Non Thread Safe | Apache 用 TS 版 PHP,確認下載正確版本 |
# Debian/Ubuntu
apt-get update && apt-get install -y libicu-dev
docker-php-ext-install intl
# Alpine
apk add --no-cache icu-dev
docker-php-ext-install intl