Redis 是高效能鍵值存儲,支援豐富資料結構。PHP 透過 phpredis 擴充套件操作。本文提供從連線、認證、基本操作到進階模式的完整範例。
# Ubuntu/Debian
sudo apt-get install php-redis
# CentOS/RHEL
sudo yum install php-pecl-redis
# 或透過 PECL
pecl install redis
# 啟用擴充套件
echo "extension=redis.so" > /etc/php.d/redis.ini
<?php
$host = '127.0.0.1';
$port = 6379;
$password = 'your_password'; // 若有密碼
$dbIndex = 0;
$redis = new Redis();
$redis->connect($host, $port);
if ($password) {
$authResult = $redis->auth($password);
if (!$authResult) {
die('認證失敗: ' . $redis->getLastError());
}
}
$redis->select($dbIndex);
// 基本字串操作
$redis->set('site:name', 'My Website');
$redis->set('site:visits', 0);
echo $redis->get('site:name'); // My Website
// 計數器
$redis->incr('site:visits');
$redis->incrBy('site:visits', 5);
echo $redis->get('site:visits'); // 6
// 過期時間
$redis->set('temp:token', 'abc123', ['ex' => 300]); // 5 分鐘過期
$redis->expire('site:name', 86400); // 設定現有鍵過期
// 判斷存在
var_dump($redis->exists('site:name')); // true
?>
$redis->hSet('user:1001', 'name', 'John');
$redis->hSet('user:1001', 'email', 'john@example.com');
$redis->hSet('user:1001', 'age', 30);
$user = $redis->hGetAll('user:1001');
// ['name' => 'John', 'email' => 'john@example.com', 'age' => '30']
$redis->hIncrBy('user:1001', 'login_count', 1);
$redis->lPush('queue:tasks', 'task1');
$redis->rPush('queue:tasks', 'task2');
$task = $redis->lPop('queue:tasks'); // task1 (FIFO)
// $task = $redis->rPop('queue:tasks'); // task2 (LIFO)
$redis->lTrim('queue:tasks', 0, 99); // 只保留前 100 個
$redis->sAdd('tags:article:1', 'php', 'laravel', 'redis');
$redis->sAdd('tags:article:2', 'php', 'symfony', 'docker');
$common = $redis->sInter('tags:article:1', 'tags:article:2'); // ['php']
$all = $redis->sUnion('tags:article:1', 'tags:article:2'); // ['php','laravel','redis','symfony','docker']
$redis->zAdd('leaderboard', 100, 'player1');
$redis->zAdd('leaderboard', 250, 'player2');
$redis->zAdd('leaderboard', 180, 'player3');
$top = $redis->zRevRange('leaderboard', 0, 9, true); // 分數前 10 名
$rank = $redis->zRevRank('leaderboard', 'player2'); // 排名 (0-based)
$score = $redis->zScore('leaderboard', 'player2'); // 250
$pipe = $redis->multi(Redis::PIPELINE);
for ($i = 0; $i < 1000; $i++) {
$pipe->set("key:$i", "value$i");
}
$pipe->exec(); // 一次網路往返完成 1000 指令
$luaScript = <<script('LOAD', $luaScript);
// 原子性「若不存在則設定」
$result = $redis->evalSha($scriptSha, 1, 'lock:key', 'locked_value');
// 傳統 PHP-FPM:每請求建立連線,請求結束自動關閉
// 長連線框架:建立連線池,Worker 啟動時初始化
class RedisPool {
private static $pool = [];
private static $maxSize = 100;
public static function get(): Redis {
$cid = spl_object_id(\Swoole\Coroutine::getCid());
if (!isset(self::$pool[$cid])) {
$redis = new Redis();
$redis->pconnect('127.0.0.1', 6379); // 永久連線
if ($password) $redis->auth($password);
self::$pool[$cid] = $redis;
}
return self::$pool[$cid];
}
}
Redis 功能遠超簡單快取,善用 Hash、List、Set、Sorted Set、Pipeline、Lua 腳本可解決分散式鎖、排行榜、限流、延遲佇列等高階場景。生產環境請務必啟用密碼、設定 bind 127.0.0.1、配置 maxmemory-policy。