萬盛學電腦網

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

PHP Redis 擴展完整命令參考手冊:從基礎操作到高階特性實戰

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]);

進階特性與企業級應用

Pipeline 管線化 (批次指令極速執行)


$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 實現樂觀鎖

Lua 腳本 (原子複雜邏輯)


$luaScript = <<script('LOAD', $luaScript);
// 之後直接用 EVALSHA 執行 (無需重傳腳本)
$val = $redis->evalSha($scriptSha, 1, 'mykey', 'initial_value');
// 等同於 SETNX 但可執行任意邏輯

發布/訂閱 (Pub/Sub)


// 發布者
$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";
    // 處理訊息...
});

Redis Cluster (分叢集模式)


$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');

效能調優與最佳實踐

  1. 連線池:使用 pconnect + persistent_id (如 worker_1) 複用連線,避免頻繁握手
  2. 序列化選擇:Redis::SERIALIZER_IGBINARY (需安裝 igbinary) 比 PHP serialize 快 2-3 倍、體積小 30%
  3. 大 Key 拆分:單 Key 超過 10KB 考慮拆分 (Hash 分片、List 分段),避免阻塞主執行緒
  4. 慢查詢日誌:CONFIG SET slowlog-log-slower-than 10000 (10ms) + 定期分析
  5. 記憶體淘汰策略:maxmemory-policy allkeys-lru 通用最佳,特定場景選 volatile-lru/allkeys-lfu
  6. 監控關鍵指標:used_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、佇列、排行榜、分散式鎖、限流器) 的基石。建議:

  1. 優先使用 Hash 儲存物件、ZSet 做排序/時間序列
  2. 善用 Pipeline/Lua 腳本減少網路往返、保證原子性
  3. 生產環境必須配置持久化 (AOF everysec)、主從備援、Cluster 分片
  4. 引入監控 (Prometheus + Grafana + Redis Exporter) 實現全鏈路可觀測

Redis 官方命令文檔:redis.io/commands | phpredis GitHub:github.com/phpredis/phpredis

copyright © 萬盛學電腦網 all rights reserved