Windows 環境下 PHP 擴展安裝常因缺少預編譯 DLL、版本不匹配 (TS/NTS、VC 版本、PHP 版本) 而讓開發者頭疼。PHP 官方提供了權威的 PECL 釋出版本下載站點,涵蓋所有支援 Windows 的擴展。本文整理官方下載入口、版本選擇規則、安裝步驟及常用擴展清單。
| PHP 版本 | 下載地址 | 說明 |
|---|---|---|
| PHP 5.2 / 5.3 (舊版) | https://downloads.php.net/pierre/ | Pierre Joye 維護的歷史構建,含 php_oci8.dll、php_memcache.dll 等經典擴展 |
| PHP 5.3 / 5.4 / 5.5 / 5.6 / 7.0 / 7.1 / 7.2 / 7.3 / 7.4 / 8.0 / 8.1 / 8.2 / 8.3 | https://windows.php.net/downloads/pecl/releases/ | 官方 PECL 釋出版本庫,按擴展名分類,每個擴展含多版本 ZIP 包 |
| PHP 官方完整包含擴展的發布頁 | https://windows.php.net/download/ | PHP 本體下載,附帶核心擴展 (pdo_mysql, gd, curl, mbstring 等) |
下載 ZIP 文件名格式:php_<擴展名>-<版本>-
https://windows.php.net/downloads/pecl/releases/,找到目標擴展目錄 (如 redis)。5.3.7),下載匹配的 ZIP (如 php_redis-5.3.7-8.2-nts-vs16-x64.zip)。php_redis.dll 複製到 `extension_dir` 目錄。extension=redis (PHP 7.2+ 可省略 `php_` 前綴和 `.dll` 後綴)。| 擴展名 | 功能 | PECL 目錄名 | 備註 |
|---|---|---|---|
| redis | Redis 客戶端 | redis | 高性能,支援集群、Sentinel |
| memcached | Memcached 客戶端 | memcached | 需 libmemcached,比舊 memcache 更強 |
| mongodb | MongoDB 驅動 | mongodb | 官方推薦,替代舊 mongo 擴展 |
| swoole | 協程高性能網絡框架 | swoole | 僅支援 NTS、Linux 生產環境為主,Windows 僅開發測試 |
| xdebug | 調試與性能分析 | xdebug | 版本 3.x 配置方式變更,注意模式設置 |
| imagick | ImageMagick 綁定 | imagick | 需額外安裝 ImageMagick 運行時 DLL |
| grpc | gRPC 支援 | grpc | 需 protobuf 擴展配合 |
| yaml | YAML 解析 | yaml | 基於 libyaml |
| ds | 高效數據結構 | ds | PHP 7+,替代原生陣列/物件 |
| uuid | UUID 生成 | uuid | RFC 4122 兼容 |
| apcu | 用戶緩存 (APC 替代) | apcu | 本地緩存,極快 |
| sqlsrv / pdo_sqlsrv | SQL Server 驅動 | sqlsrv | 微軟官方維護,需 ODBC Driver 17/18 |
| oci8 / pdo_oci | Oracle 驅動 | oci8 | 需 Oracle Instant Client |
| ssh2 | SSH2 協議 | ssh2 | 需 libssh2 |
| zstd / lzf / snappy | 壓縮算法 | zstd, lzf, snappy | 高壓縮比/速度 |
Dependency Walker 或 `php -m` 觀察錯誤,將依賴 DLL 放入 PHP 目錄或系統 PATH;3) TS/NTS、VC、x86/x64 不匹配 —— 重新下載正確版本。掌握「查 phpinfo → 對版本/TS/VC/架構 → 官網下載 → 放入 extension_dir → 改 php.ini → 重啟驗證」這套標準流程,Windows 下 PHP 擴展安裝不再是黑盒。建議收藏 PECL 釋出版本庫,遇到缺擴展直接按圖索驥。