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

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 再操作
示例:
// 存用户登录态(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(生产环境禁用)
基本上就这些。不复杂但容易忽略细节,连上、存对、取准、加前缀、设过期——跑起来就稳了。











