萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Windows PHP 啟用 intl 擴展:解決 php_intl.dll 載入失敗

Windows 環境啟用 PHP intl 擴展常遇到「無法載入動態程式庫 php_intl.dll」錯誤。原因是 intl 依賴 ICU 庫,需將相關 DLL 複製到 Apache 執行目錄。

解決步驟

步驟 1:複製 ICU DLL 到 Apache bin 目錄

從 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 目錄。

步驟 2:啟用 php.ini 擴展

; php.ini
extension=intl
; 或舊版
; extension=php_intl.dll

步驟 3:重啟 Apache

# 命令列
httpd -k restart

# 或服務管理器重啟 Apache 服務

步驟 4:驗證

<?php
phpinfo();
// 搜尋 "intl" 區塊,應顯示:
// intl support => enabled
// ICU version => 70.1 (或其他版本)
?>

替代方案:加入系統 PATH

將 PHP 安裝目錄加入系統環境變數 PATH:

  1. Win+Pause → 進階系統設定 → 環境變數
  2. 系統變數 Path → 編輯 → 新增 C:\php (你的 PHP 目錄)
  3. 重啟命令提示字元 / Apache 服務

此法讓系統全域可找到 PHP DLL,但可能造成版本衝突,優先推薦複製到 Apache bin。

常見問題排查

錯誤現象原因與解決
PHP Warning: Unable to load dynamic library 'intl'ICU DLL 未在搜尋路徑。複製到 Apache bin 或加 PATH
Class 'NumberFormatter' not foundintl 未啟用。檢查 phpinfo() 確認 intl 區塊
版本不匹配PHP 8.1 需 ICU 70+,PHP 8.2 需 ICU 71+。確認 DLL 版本對應
Thread Safe vs Non Thread SafeApache 用 TS 版 PHP,確認下載正確版本

Docker/Linux 環境

# 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
copyright © 萬盛學電腦網 all rights reserved