PHP 7 安裝 Redis 擴展完整教程：Linux 編譯與 Windows DLL 方案

前言

Redis 擴展是 PHP 高性能緩存必備。本文提供 PHP 7 專用安裝指南：Linux 從源碼編譯 phpredis、Windows 下載預編譯 DLL，含驗證與常見錯誤解決。

Linux 編譯安裝（推薦 phpredis 5.x 支援 PHP 7.0-7.4）

# 1. 安裝依賴
yum install -y gcc make php7-devel  # 或 apt install php7.4-dev

# 2. 下載 phpredis PHP 7 兼容版本
cd /usr/local/src
wget -c https://github.com/phpredis/phpredis/archive/5.3.4.tar.gz -O phpredis-5.3.4.tar.gz
tar zxvf phpredis-5.3.4.tar.gz
cd phpredis-5.3.4

# 3. 編譯安裝
/usr/local/php7/bin/phpize
./configure --with-php-config=/usr/local/php7/bin/php-config
make -j$(nproc)
make install

# 4. 啟用擴展
echo "extension=redis.so" > /usr/local/php7/etc/php.d/redis.ini

# 5. 重啟 PHP-FPM
systemctl restart php7-fpm
# 或 service php-fpm restart

Windows 安裝（預編譯 DLL）

1. 確認 PHP 版本、架構、線程安全性：php -i | findstr "Thread Safety" → Thread Safety: enabled → TS，disabled → NTS。
2. 下載對應 DLL：
   PECL 官方發布頁 → 選擇 php_redis-5.3.4-7.4-ts-vc15-x64.zip（示例：PHP 7.4 TS VC15 x64）。
3. 解壓 php_redis.dll 到 PHP ext 目錄（如 C:\php\ext）。
4. 編輯 php.ini，添加：extension=redis（無需 .dll 後綴）。
5. 重啟 Apache/Nginx/IIS。

驗證安裝

# CLI
php -m | grep redis
# redis

# 代碼測試
php -r '$r=new Redis(); $r->connect("127.0.0.1",6379); $r->set("test","hello"); echo $r->get("test");'
# hello

實戰代碼示例：投票計數器（緩存+定時持久化）

connect('127.0.0.1', 6379);

$key = "vote:article:{$aid}";
$current = $r->incr($key); // 原子自增

// 設置過期時間（7 天），防止鍵永久佔用內存
$r->expire($key, 7 * 24 * 3600);

if ($current >= $updateTill) {
    // 達到閾值，異步寫入 MySQL（生產環境建議用隊列）
    if ($current > $updateTill) { // 防止重複寫入
        require_once __DIR__ . '/db.php';
        $pdo->exec("UPDATE articles SET votes = votes + {$updateTill} WHERE id = {$aid}");
        // 重置 Redis 計數器（保留餘數）
        $r->set($key, $current - $updateTill);
    }
}

echo $current; // 返回當前票數供前端顯示

常見問題解決

版本對應表（關鍵）

結語

PHP 7 安裝 Redis 擴展核心在於：版本嚴格對應（phpredis 5.x 對應 PHP 7.x）、Linux 用 phpize 編譯、Windows 嚴格匹配 TS/NTS/VC/架構下載 DLL。生產環境建議升級至 PHP 8.2+ + phpredis 6.x，享受原生 JIT 加速與長期支持。