PHP中真正可靠的分布式锁只能基于Redis的SET原子命令(NX+EX)加唯一value标识,并配合Lua脚本校验释放;ZooKeeper因PHP生态支持弱、扩展过时而基本不可用,flock等仅为本地锁。

PHP里真能用的分布式锁,只有基于 Redis 的 SET 原子命令 + Lua 释放脚本这一条路走得稳;ZooKeeper 在 PHP 中基本不可用,flock 或文件写入纯属本地锁,跨机器就失效。
为什么不能只用 SETNX + EXPIRE
两步操作非原子:SETNX 成功后若网络中断或进程崩溃,EXPIRE 没执行,锁就永远卡住,其他服务全被堵死。这不是锁,是“幽灵占位符”。
-
SETNX只管“设值不覆盖”,不带过期逻辑,必须搭配EX才算完整 - 老式写法
$redis->setnx($key, $val); $redis->expire($key, 30);存在竞态窗口,PHP 7.0+ 应直接弃用 - Redis 6.0+ 支持
SET key val NX EX 30原子命令,PHP Redis 扩展 5.0+ 的set()方法才支持数组参数写法
SET 加锁时三个参数缺一不可
键($lockKey)、值($lockValue)、选项(['NX', 'EX' => 30])必须同时传入,否则无法保障互斥 + 自动过期 + 持有者标识三位一体。
-
$lockKey必须带业务上下文,例如"stock:sku_1001",而非固定字符串"stock_lock" -
$lockValue必须全局唯一且可追溯,推荐sprintf('%s:%d', uniqid('', true), getmypid()),禁用时间戳或纯随机数 - 过期时间别拍脑袋定 10 秒,应按业务 P99 耗时 × 1.5~2 预估;若临界区可能超时,宁可加冗余(如设 60 秒),也别在 PHP-FPM 下硬搞“看门狗”续期——它根本不可靠
解锁必须用 Lua 脚本,DEL 直删就是事故
直接 $redis->del($key) 是最常见误删来源:A 拿到锁但慢了 2 秒,锁自动过期;B 立即获取新锁;A 接着调 DEL,就把 B 的锁干掉了。
- 正确释放脚本:
"if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end" - PHP 调用时注意参数顺序:
$redis->eval($script, [$lockKey], 1, $lockValue),第三个参数是 KEYS 数量,写错成 0 就永远返回 0 - 脚本返回 0 不代表失败,要检查是否已被他人处理完毕——比如支付回调场景,锁删不掉,可能说明订单已支付成功,直接退出即可
主从延迟、Redis 单点故障、时钟漂移这些深层问题,在中小业务里通常先靠“锁粒度收窄 + 过期时间冗余 + 幂等兜底”扛住;真要上 Redlock 或多节点共识,得先确认 PHP 团队有没有人能 debug Lua 脚本在集群脑裂时的行为。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











