萬盛學電腦網

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

PHP Windows 官方擴展庫下載大全:PECL 釋出版本索引與安裝指南

前言

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.3https://windows.php.net/downloads/pecl/releases/官方 PECL 釋出版本庫,按擴展名分類,每個擴展含多版本 ZIP 包
PHP 官方完整包含擴展的發布頁https://windows.php.net/download/PHP 本體下載,附帶核心擴展 (pdo_mysql, gd, curl, mbstring 等)

關鍵版本選擇規則 (必讀)

下載 ZIP 文件名格式:php_<擴展名>-<版本>----<架構>.zip

  • TS (Thread Safe) / NTS (Non-Thread Safe):
    • Apache + mod_php (php_apache.dll) → TS
    • Nginx + PHP-FPM / IIS FastCGI / CLI → NTS
  • VC 版本 (Visual C++ Runtime):
    • PHP 7.0-7.1 → VC14 (VS 2015)
    • PHP 7.2-7.4 → VC15 (VS 2017)
    • PHP 8.0+ → VS16 (VS 2019) / VS17 (VS 2022)
    • 必須與 `phpinfo()` 顯示的 Compiler 一致。
  • 架構: x86 (32位) / x64 (64位) —— 必須與 PHP 進程位數一致 (查看 `phpinfo()` → Architecture)。
  • PHP 版本: 必須完全匹配 (如 8.2.12 不能用 8.2.11 的 DLL)。

安裝步驟

  1. 執行 `php -i` 或瀏覽 `phpinfo()` 記錄:PHP Version、Thread Safety、Compiler、Architecture、extension_dir。
  2. 進入 https://windows.php.net/downloads/pecl/releases/,找到目標擴展目錄 (如 redis)。
  3. 進入對應版本子目錄 (如 5.3.7),下載匹配的 ZIP (如 php_redis-5.3.7-8.2-nts-vs16-x64.zip)。
  4. 解壓,將 php_redis.dll 複製到 `extension_dir` 目錄。
  5. 編輯 `php.ini`,添加 extension=redis (PHP 7.2+ 可省略 `php_` 前綴和 `.dll` 後綴)。
  6. 重啟 Web 服務器 / PHP-FPM,用 `php -m | findstr redis` 或 `phpinfo()` 驗證。

常用擴展快速索引 (部分熱門)

擴展名功能PECL 目錄名備註
redisRedis 客戶端redis高性能,支援集群、Sentinel
memcachedMemcached 客戶端memcached需 libmemcached,比舊 memcache 更強
mongodbMongoDB 驅動mongodb官方推薦,替代舊 mongo 擴展
swoole協程高性能網絡框架swoole僅支援 NTS、Linux 生產環境為主,Windows 僅開發測試
xdebug調試與性能分析xdebug版本 3.x 配置方式變更,注意模式設置
imagickImageMagick 綁定imagick需額外安裝 ImageMagick 運行時 DLL
grpcgRPC 支援grpc需 protobuf 擴展配合
yamlYAML 解析yaml基於 libyaml
ds高效數據結構dsPHP 7+,替代原生陣列/物件
uuidUUID 生成uuidRFC 4122 兼容
apcu用戶緩存 (APC 替代)apcu本地緩存,極快
sqlsrv / pdo_sqlsrvSQL Server 驅動sqlsrv微軟官方維護,需 ODBC Driver 17/18
oci8 / pdo_ociOracle 驅動oci8需 Oracle Instant Client
ssh2SSH2 協議ssh2需 libssh2
zstd / lzf / snappy壓縮算法zstd, lzf, snappy高壓縮比/速度

常見問題 FAQ

Q: 啟用擴展後 PHP 啟動報錯 "Unable to load dynamic library"
A: 1) 檢查 DLL 是否放對 `extension_dir`;2) 依賴 DLL 缺失 (如 `libssh2.dll`, `libsasl.dll`) —— 用 Dependency Walker 或 `php -m` 觀察錯誤,將依賴 DLL 放入 PHP 目錄或系統 PATH;3) TS/NTS、VC、x86/x64 不匹配 —— 重新下載正確版本。
Q: 找不到某擴展在 PECL releases 目錄下
A: 可能尚未發布 Windows 版、或已棄用 (如 `mongo` 被 `mongodb` 取代)、或屬於 PHP 核心內建 (如 `pdo_mysql`, `gd`, `curl` 無需單獨下載)。
Q: 如何批量安裝多個擴展?
A: 使用 docker-php-extension-installer 構建自定義 Docker 映像,或編寫 PowerShell 腳本自動化下載匹配版本。

結語

掌握「查 phpinfo → 對版本/TS/VC/架構 → 官網下載 → 放入 extension_dir → 改 php.ini → 重啟驗證」這套標準流程,Windows 下 PHP 擴展安裝不再是黑盒。建議收藏 PECL 釋出版本庫,遇到缺擴展直接按圖索驥。

copyright © 萬盛學電腦網 all rights reserved