萬盛學電腦網

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

PHP 使用 Redis 完整入門範例

前言

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
?>

進階資料結構

Hash(雜湊表) - 適合物件儲存

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

List(列表) - 隊列、棧、訊息佇列

$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 個

Set(集合) - 去重、標籤、共同好友

$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']

Sorted Set(有序集合) - 排行榜、延遲佇列

$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

Pipeline 批次操作(大幅提升效能)

$pipe = $redis->multi(Redis::PIPELINE);
for ($i = 0; $i < 1000; $i++) {
    $pipe->set("key:$i", "value$i");
}
$pipe->exec(); // 一次網路往返完成 1000 指令

Lua 腳本(原子性操作)

$luaScript = <<script('LOAD', $luaScript);
// 原子性「若不存在則設定」
$result = $redis->evalSha($scriptSha, 1, 'lock:key', 'locked_value');

連線池與長連線(Swoole/Workerman 環境)


// 傳統 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。

copyright © 萬盛學電腦網 all rights reserved