PHP Redis操作基础教程_PHP通过Redis存取数据示例-php教程-PHP中文网

PHP Redis操作基础教程_PHP通过Redis存取数据示例

舞夢輝影

发布： 2025-12-17 22:24:37

原创

703人浏览过

PHP通过Redis存取数据需先安装phpredis扩展，连接时推荐设置超时与自动重连，支持String和Hash类型操作，String适用于缓存、计数器，Hash适合结构化存储如用户信息，所有key建议加统一前缀并设过期时间。

php redis操作基础教程_php通过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 等。

立即学习“PHP免费学习笔记（深入）”；

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

示例：

腾讯AI 开放平台

腾讯AI开放平台

381

查看详情

// 存用户登录态（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 "用户可用";
}

登录后复制