Redis 是高效能鍵值存儲,支援字串、雜湊、列表、集合、有序集合、位圖、HyperLogLog、地理空間、流等豐富資料結構。PHP phpredis 擴展提供原生 C 級效能,是高併發系統的首選。本文系統整理核心命令、進階特性、連線管理、集群支援與最佳實踐。
<?php
$redis = new Redis();
// 短連線 (請求結束自動關閉)
$redis->connect('127.0.0.1', 6379, 2.5); // host, port, timeout(秒)
// 長連線 (跨請求復用,需 php.ini 設定 redis.persistent=1)
$redis->pconnect('127.0.0.1', 6379, 2.5, 'persistent_id');
// Unix Socket (本機極速)
$redis->connect('/var/run/redis/redis.sock');
// 認證
$redis->auth('password'); // 或 connect 時第 4 參數
// 選擇資料庫 (0-15)
$redis->select(1);
// 連線狀態檢查
var_dump($redis->ping()); // +PONG
var_dump($redis->getLastError()); // 最後錯誤訊息
// 設值 (可選 EX/PX/EXAT/PXAT/NX/XX/KEEP/GET)
$redis->set('key', 'value');
$redis->setex('key', 3600, 'value'); // 1 小時過期
$redis->psetex('key', 5000, 'value'); // 毫秒過期
$redis->setnx('key', 'value'); // 僅不存在時設定 (分散式鎖核心)
$redis->set('key', 'value', ['nx', 'ex' => 10]); // Redis 2.6.12+ 陣列選項
// 取值
$val = $redis->get('key');
$vals = $redis->mGet(['key1', 'key2', 'key3']); // 批次獲取
// 計數器 (原子遞增/遞減)
$redis->incr('counter');
$redis->incrBy('counter', 10);
$redis->decr('counter');
$redis->decrBy('counter', 5);
// 字串操作
$redis->append('key', ' suffix');
$redis->strlen('key');
$redis->getRange('key', 0, -1); // 子字串
$redis->setRange('key', 0, 'new'); // 覆寫部分
// 位操作 (Bitmap)
$redis->setBit('bitmap', 100, 1);
$redis->getBit('bitmap', 100);
$redis->bitCount('bitmap');
$redis->bitOp('AND', 'dest', 'key1', 'key2'); // AND/OR/XOR/NOT
$redis->hSet('user:1001', 'name', 'John');
$redis->hSet('user:1001', ['email' => 'john@example.com', 'age' => 30]); // 批次
$redis->hGet('user:1001', 'name');
$redis->hGetAll('user:1001'); // 返回關聯陣列
$redis->hMGet('user:1001', ['name', 'email']);
$redis->hDel('user:1001', 'age');
$redis->hExists('user:1001', 'email');
$redis->hLen('user:1001');
$redis->hIncrBy('user:1001', 'login_count', 1); // 原子遞增欄位
$redis->hKeys('user:1001');
$redis->hVals('user:1001');
$redis->hGetAll('user:1001'); // 全部欄位值
// 推入/彈出 (左/右)
$redis->lPush('queue', 'job1');
$redis->rPush('queue', 'job2');
$redis->lPop('queue'); // 移除並返回左端
$redis->rPop('queue'); // 移除並返回右端
// 阻塞彈出 (BRPOP/BLPOP) - 佇列消費者核心
$job = $redis->bPop('queue', 5); // 等待 5 秒,返回 ['queue', 'job_data']
// 多佇列輪詢
$job = $redis->bPop(['queue:high', 'queue:low'], 10);
// 索引存取
$redis->lIndex('queue', 0); // 第 0 個
$redis->lSet('queue', 0, 'new_job'); // 修改指定索引
$redis->lRange('queue', 0, -1); // 獲取範圍 (0=-1 為全部)
$redis->lTrim('queue', 0, 99); // 只保留前 100 個
// 移除/插入
$redis->lRem('queue', 0, 'job1'); // 移除 0=全部, >0 從左, <0 從右
$redis->lInsert('queue', Redis::AFTER, 'pivot_job', 'new_job');
// 進階:原子移動 (RPOPLPUSH)
$moved = $redis->rPopLPush('source_queue', 'dest_queue'); // 尾移到頭,原子操作
$redis->sAdd('tags:post:1', 'php', 'redis', 'performance');
$redis->sRem('tags:post:1', 'redis');
$redis->sIsMember('tags:post:1', 'php'); // true
$redis->sMembers('tags:post:1'); // 所有成員
$redis->sCard('tags:post:1'); // 基數
$redis->sPop('tags:post:1'); // 隨機移除並返回
// 集合運算 (極快)
$redis->sInter('tags:post:1', 'tags:post:2'); // 交集
$redis->sUnion('tags:post:1', 'tags:post:2'); // 聯集
$redis->sDiff('tags:post:1', 'tags:post:2'); // 差集 (1-2)
$redis->sInterStore('dest', 'tags:post:1', 'tags:post:2'); // 交集存新鍵
$redis->sUnionStore('dest', 'tags:post:1', 'tags:post:2');
$redis->sDiffStore('dest', 'tags:post:1', 'tags:post:2');
// 隨機成員
$redis->sRandMember('tags:post:1', 3); // 3 個不重複隨機成員
// 分數即排序依據 (雙精度浮點數)
$redis->zAdd('leaderboard', 100, 'player1');
$redis->zAdd('leaderboard', [90 => 'player2', 95 => 'player3']);
$redis->zIncrBy('leaderboard', 10, 'player1'); // 原子加分
$redis->zScore('leaderboard', 'player1'); // 獲取分數
$redis->zRank('leaderboard', 'player1'); // 正序排名 (0-based)
$redis->zRevRank('leaderboard', 'player1'); // 逆序排名
// 範圍查詢
$redis->zRange('leaderboard', 0, 9, true); // 前 10 名 (with scores)
$redis->zRevRange('leaderboard', 0, 9, true); // 後 10 名
$redis->zRangeByScore('leaderboard', 80, 100); // 分數區間
$redis->zCount('leaderboard', 80, 100); // 區間計數
// 移除
$redis->zRem('leaderboard', 'player2');
$redis->zRemRangeByRank('leaderboard', 0, 10); // 排名區間刪除
$redis->zRemRangeByScore('leaderboard', 0, 50); // 分數區間刪除
// 聯集/交集 (加權)
$redis->zUnionStore('combined', ['board1', 'board2'], [1.0, 2.0]); // 權重
$redis->zInterStore('combined', ['board1', 'board2'], [1.0, 1.0]);
$pipe = $redis->multi(Redis::PIPELINE); // 或 Redis::MULTI (事務)
for ($i = 0; $i < 10000; $i++) {
$pipe->set("key:$i", "value:$i");
$pipe->get("key:$i");
}
$results = $pipe->exec(); // 一次網路往返返回所有結果
// 非事務管線:指令獨立執行,部分失敗不影響其他
// 事務 (MULTI/EXEC):原子性執行,配合 WATCH 實現樂觀鎖
$luaScript = <<script('LOAD', $luaScript);
// 之後直接用 EVALSHA 執行 (無需重傳腳本)
$val = $redis->evalSha($scriptSha, 1, 'mykey', 'initial_value');
// 等同於 SETNX 但可執行任意邏輯
// 發布者
$redis->publish('channel:news', json_encode(['title' => 'Breaking News', 'time' => time()]));
// 訂閱者 (長連接阻塞)
$redis->subscribe(['channel:news'], function($redis, $chan, $msg) {
echo "Received on $chan: $msg\n";
// 處理訊息...
});
$cluster = new RedisCluster(
null,
['127.0.0.1:7000', '127.0.0.1:7001', '127.0.0.1:7002'], // seed nodes
1.5, // timeout
1.5, // read timeout
true, // lazy connect
0, // retry interval
3 // max retries
);
// 使用方式與單機 Redis 幾乎相同,自動處理 MOVED/ASK 重導向
$cluster->set('key', 'value');
pconnect + persistent_id (如 worker_1) 複用連線,避免頻繁握手Redis::SERIALIZER_IGBINARY (需安裝 igbinary) 比 PHP serialize 快 2-3 倍、體積小 30%CONFIG SET slowlog-log-slower-than 10000 (10ms) + 定期分析maxmemory-policy allkeys-lru 通用最佳,特定場景選 volatile-lru/allkeys-lfuused_memory, connected_clients, keyspace_hits/misses, instantaneous_ops_per_sec, replication_lag| 錯誤 | 原因 | 解決 |
|---|---|---|
| READONLY You can't write against a read only replica | 集群模式讀寫分離,寫入請求導向副本 | 使用 RedisCluster 客戶端、或確保連線至主節點 |
| OOM command not allowed when used memory > maxmemory | 記憶體超限,淘汰策略無法釋放足夠空間 | 調整 maxmemory、優化資料結構、啟用 LFU/LRU |
| MISCONF Redis is configured to save RDB snapshots, but currently not able to persist on disk | 磁碟滿、權限不足、RDB/AOF 寫入失敗 | 檢查磁碟空間、權限、sysctl vm.overcommit_memory=1 |
| php_network_getaddresses: getaddrinfo failed | 主機名解析失敗 | 檢查 /etc/hosts、DNS、防火牆、Security Group |
掌握 phpredis 核心命令與進階特性,是構建高效能 PHP 系統 (快取、Session、佇列、排行榜、分散式鎖、限流器) 的基石。建議:
Redis 官方命令文檔:redis.io/commands | phpredis GitHub:github.com/phpredis/phpredis