Windows 下安裝 PHP 5.5 Redis 擴展完整步驟圖解

Windows 下安裝 PHP 5.5 Redis 擴展完整步驟圖解

在 Windows 開發環境（如 WAMP、XAMPP）中啟用 Redis 擴展，需注意 PHP 版本、執行緒安全性（TS/NTS）、VC 編譯版本（VC11/VC14）匹配。本文以 PHP 5.5 為例，記錄完整安裝流程。

一、確認 PHP 環境資訊

建立 phpinfo.php 查看關鍵項：

• PHP Version：5.5.x
• Thread Safety：enabled → 需 TS (Thread Safe) 版本
• Compiler：VC11 (Visual Studio 2012)
• Architecture：x86 (32位) 或 x64
• extension_dir：擴展目錄路徑，如 D:\php\ext

二、下載對應 DLL 檔案

官方 PECL 快照頁面：https://windows.php.net/downloads/pecl/snaps/redis/

選擇版本 2.2.5（PHP 5.5 相容），下載：

• php_redis-2.2.5-5.5-ts-vc11-x86.zip (TS, VC11, x86)
• php_igbinary-2.0.1-5.5-ts-vc11-x86.zip (Redis 依賴 igbinary 序列化)

⚠️ 必須同時安裝 php_igbinary.dll，否則 Redis 擴展無法載入。

三、安裝步驟

1. 解壓縮，將 php_redis.dll、php_igbinary.dll 複製到 PHP ext 目錄（如 D:\php\ext）。
2. 編輯 php.ini，在 [ExtensionList] 區段或檔案末尾添加：

   extension=php_igbinary.dll
   extension=php_redis.dll

   順序重要：igbinary 必須在 redis 之前載入。
3. 重啟 Apache / Nginx (FastCGI) 服務。
4. 再次檢視 phpinfo()，搜尋 "redis" 區塊，出現版本資訊即安裝成功。

四、驗證測試

<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$redis->set('test_key', 'Hello Windows Redis!');
echo $redis->get('test_key'); // 輸出: Hello Windows Redis!
?>

五、常見問題排查

六、參考資源

• Redis PHP 客戶端文檔：github.com/phpredis/phpredis
• 中文手冊：ikodota 部落格

遵循「版本、執行緒、編譯器、架構」四要素匹配原則，Windows 下安裝 PHP 擴展不再踩坑。