PHP使用Redis缓存列表的批量操作方法

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是文章学习者，那么本文《PHP用Redis缓存列表批量操作方法》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

PHP用Redis批量写入多个独立列表必须用pipeline或Lua脚本，因循环调用lpush会产生多次网络往返，导致性能骤降；pipeline可合并命令降低RTT，Lua则保证多列表操作原子性。

PHP 用 Redis 缓存列表时，lpush/rpush 单次只能推一个或多个元素，但“批量写入多个独立列表”不能靠单个命令完成——得靠管道（pipeline）或 Lua 脚本，否则性能会断崖式下跌。

为什么不能直接用 lpush 循环写多个列表？

每次调用 lpush 都是一次网络往返，100 个列表就要发 100 次请求。实测在局域网延迟 0.2ms 的情况下，耗时轻松破 20ms；上云后更可能到 50–100ms+。Redis 本身支持原子性批量操作，但 PHPRedis 客户端默认不启用管道，得手动开启。

• 循环调用 $redis->lpush($key, $val) 是最常见也最慢的写法
• lpush 和 rpush 本身支持一次推多个值（如 $redis->lpush('list:a', 'a', 'b', 'c')），但这只适用于「往同一个列表塞多个元素」
• 若要「往 list:a、list:b、list:c 各自 push 一条数据」，必须用其他机制

用 pipeline 实现多列表批量写入（推荐）

pipeline 把多个命令攒成一批发出去，服务端顺序执行并一次性返回结果，网络开销降到接近 1 次 RTT。PHPRedis 的 pipeline() 方法返回的是当前实例的代理对象，所有后续命令不会立即执行，直到调用 exec()。

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

// 开启 pipeline
$pipeline = $redis->pipeline();

// 批量写入不同列表
$pipeline->lpush('list:users:1001', json_encode(['name' => 'Alice']));
$pipeline->lpush('list:users:1002', json_encode(['name' => 'Bob']));
$pipeline->lpush('list:users:1003', json_encode(['name' => 'Charlie']));

// 一次性发出全部命令
$results = $pipeline->exec(); // 返回数组，每个元素对应一条命令的返回值

// $results[0] 是第一个 lpush 的返回值（新长度），依此类推

• 务必检查 $results 是否为数组且长度匹配，避免静默失败
• pipeline 不是事务，不保证原子性：某条命令出错（比如 key 类型不对），其余仍会执行
• 不要在 pipeline 中混用读命令（如 lrange），某些 Redis 版本会报错或行为异常

用 Lua 脚本保证多列表操作的原子性

如果「同时更新多个列表」必须全成功或全失败（比如用户积分变动要同步写入主列表 + 归档列表 + 统计列表），就得用 Lua。Redis 保证脚本执行期间无并发干扰，且 eval 是原子的。

// Lua 脚本内容（保存为字符串或外部文件）
$script = eval($script, ['list:a', 'list:b', 'list:c'], ['val1', 'val2', 'val3']);

• KEYS 和 ARGV 必须显式传入，不能硬编码 key 名，否则无法复用
• 脚本里不能用随机函数（math.random）、时间函数（os.time）等非纯函数，否则集群模式下会报错
• Lua 脚本有最大执行时间限制（默认 5 秒），复杂逻辑建议拆分或改用 pipeline

别忽略序列化和类型一致性

PHPRedis 对列表元素不做自动序列化，lpush 传数组会触发 __toString() 或抛错。必须自己处理：

• 统一用 json_encode() 写入，json_decode() 读取（注意第二个参数设为 true 得到数组）
• 避免混用序列化方式：同一列表里既有 serialize() 又有 json_encode()，会导致 json_decode() 失败且无提示
• 如果值是简单字符串（如 ID、状态码），可跳过序列化，但需确保业务层不误写数组进去

批量操作看似只是“多写几行代码”，但网络、原子性、序列化这三关没对齐，缓存就容易变成故障放大器——尤其在高并发写场景下，小疏漏会直接拖垮接口 P99 延迟。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP使用Redis缓存列表的批量操作方法》文章吧，也可关注golang学习网公众号了解相关技术文章。