PHP操作Redis缓存代码示例

本文深入解析了PHP高效、稳定操作Redis缓存的核心实践，涵盖Redis扩展的正确安装与检测、推荐使用原生扩展而非Predis以提升性能、通过set()数组参数灵活设置过期时间、利用pipeline批量减少网络开销、以及针对缓存穿透精心设计的空值随机过期防护策略——每一步都直击生产环境中的真实痛点，帮你避开看似微小却极易引发雪崩的陷阱，真正实现“写完能跑”到“长期稳跑”的跃升。

PHP 操作 Redis 缓存，核心是用 Predis 或 Redis 扩展连接并调用方法；直接用原生 Redis 扩展更轻量、性能更好，但需确保扩展已启用。

确认 Redis 扩展是否可用

运行 php -m | grep redis 或在代码中检查：

if (!extension_loaded('redis')) {
    throw new RuntimeException('Redis extension is not loaded');
}

• 没输出或报错？说明没装扩展——Linux 下用 sudo apt install php-redis（Debian/Ubuntu）或 pecl install redis + 修改 php.ini 加 extension=redis.so
• Windows 用户注意：必须匹配 PHP 版本（TS/NTS、x64/x86），不能只复制 php_redis.dll 就完事
• phpinfo() 里搜 “redis” 能看到版本和已启用的指令列表，才是真就绪

连接 Redis 并设置/获取字符串值

最常用场景：缓存单个变量、配置、计数器。别用 setex() 硬写过期时间，优先用 set() 的第三个参数传 ['EX' => 3600] 数组形式，可读性高且兼容未来参数扩展：

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
// 设置带过期时间的键
$redis->set('user:1001:profile', json_encode(['name' => 'Alice']), ['EX' => 3600]);
// 获取并解码
$data = json_decode($redis->get('user:1001:profile'), true);

• 连接后建议加 $redis->ping() 验证连通性，尤其在容器或远程环境中
• set() 第三个参数是数组时，EX（秒）、PX（毫秒）、NX（仅当 key 不存在时设）等可组合，比 setex() setnx() 更灵活
• 如果值是数组或对象，务必序列化（json_encode 或 serialize），Redis 只存字符串

用 pipeline 批量操作避免网络往返开销

一次查 100 个用户缓存？别写 100 次 get()。用 pipeline() 把命令攒起来发一次：

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$pipeline = $redis->pipeline();
$userIds = [1001, 1002, 1003];
foreach ($userIds as $id) {
    $pipeline->get("user:{$id}:profile");
}
$results = $pipeline->exec(); // 返回索引数组，顺序与发送一致

• pipeline() 不是事务，不保证原子性；若需回滚或条件执行，改用 multi() + exec()
• 大量数据时，exec() 返回结果是纯数组，没有 key 关联，靠下标对应原始请求顺序
• 超大批量（如 >5000 条）仍可能触发 Redis 单次请求大小限制，建议分批

缓存穿透/击穿常见防护写法

查一个根本不存在的用户 ID，每次穿透到 DB？用空值缓存 + 随机过期时间防雪崩：

$key = "user:999999:profile";
$data = $redis->get($key);
if ($data === false) {
    $data = getUserFromDb(999999); // 假设这是查库函数
    if ($data === null) {
        // 缓存空值，过期时间加随机偏移（如 1–5 分钟），避免大量空请求同时失效
        $expire = 300 + rand(0, 300);
        $redis->set($key, 'null', ['EX' => $expire]);
        return null;
    }
    $redis->set($key, json_encode($data), ['EX' => 3600]);
}
return json_decode($data, true);

• 别用固定过期时间缓存空值，否则所有空请求会在同一秒集体涌向 DB
• 判断 $data === false 而非 empty()，因为 Redis 返回 false 表示 key 不存在，而空字符串、0、null 是合法缓存值
• 生产环境建议加布隆过滤器（Bloom Filter）前置拦截非法 ID，但 PHP 原生不支持，需用扩展或外部服务

Redis 连接复用、异常重试、序列化策略、空值处理——这些不是“写完能跑就行”的部分，而是缓存真正稳不稳的关键。尤其在高并发下，少一次 connect()、多一个 === false 判断，都可能让问题从日志里消失，或者突然炸出来。

好了，本文到此结束，带大家了解了《PHP操作Redis缓存代码示例》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！