PHP操作Redis教程及数据存取示例

本文手把手教你用PHP高效操作Redis，涵盖phpredis扩展安装、带超时与自动重连的安全连接方式，并深入讲解String（适用于缓存、计数器、Token）和Hash（适合用户信息等结构化数据）两大核心数据类型的实用存取技巧，同时强调key统一前缀、合理设置过期时间、批量操作优化及生产环境避坑要点，助你快速写出稳定、健壮、易维护的Redis交互代码。

PHP 通过 Redis 存取数据非常简单，前提是已安装并启用 phpredis 扩展（非 Redis 命令行客户端）。下面以最常用、最实用的方式，带你快速上手。

连接 Redis 服务器

使用 Redis 类实例化连接，支持 TCP 和 Unix Socket。推荐设置超时和自动重连：

• 默认端口是 6379，本地连接可省略 host 和 port
• 建议开启 setOption(REDIS_OPT_READ_TIMEOUT, 3) 避免阻塞
• 连接失败需手动捕获异常，不能依赖返回值判断

示例代码：

$redis = new Redis();
try {
    $redis->connect('127.0.0.1', 6379, 2); // host, port, timeout(秒)
    $redis->setOption(Redis::OPT_READ_TIMEOUT, 3);
} catch (RedisException $e) {
    die("Redis 连接失败: " . $e->getMessage());
}

字符串类型（String）存取

这是最基础也最常用的类型，适合缓存单个值、计数器、Token 等。

• set($key, $value, [$timeout])：第三个参数可为整数（秒）或 \Redis::SETEX（带过期）
• get($key)：不存在返回 false，注意用 === false 判断
• incr($key) / decr($key)：原子自增/自减，键不存在则初始化为 0 再操作

示例：

// 存用户登录态（30分钟过期）
$redis->setex('user:token:abc123', 1800, 'uid:789');

// 取值并判断
$value = $redis->get('user:token:abc123');
if ($value === false) {
    echo "键不存在或已过期";
}

// 计数器（如文章阅读量）
$redis->incr('article:views:1001'); // 自动创建并+1

哈希类型（Hash）结构化存储

适合对象属性存取，比如用户资料、配置项，比存 JSON 字符串更灵活高效。

• hSet($key, $field, $value)：存单个字段；hMset($key, $array) 批量存
• hGet($key, $field) 获取字段值；hGetAll($key) 获取全部字段（返回关联数组）
• hExists($key, $field) 判断字段是否存在，比 hGet + === false 更语义清晰

示例：

// 存用户信息（不序列化，直接字段映射）
$redis->hMset('user:1001', [
    'name' => '张三',
    'email' => 'zhang@example.com',
    'status' => 'active'
]);

// 取邮箱
$email = $redis->hGet('user:1001', 'email');

// 检查是否启用
if ($redis->hExists('user:1001', 'status') && $redis->hGet('user:1001', 'status') === 'active') {
    echo "用户可用";
}

其他常用操作提醒

实际开发中容易忽略但很关键的点：

• 所有 key 建议加统一前缀（如 cache:、user:），便于管理与清理
• 批量操作优先用 mGet / mSet / hMget，减少网络往返
• 删除用 del($key)，清空库用 flushDB()（慎用！）
• 调试时可用 $redis->getKeys('user:*') 查匹配 key（生产环境禁用）

基本上就这些。不复杂但容易忽略细节，连上、存对、取准、加前缀、设过期——跑起来就稳了。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP操作Redis教程及数据存取示例》文章吧，也可关注golang学习网公众号了解相关技术文章。