Redis 在 PHP 中并发锁的使用说明

二、关键特性与实现原则

1. 原子性：锁的 “获取” 和 “设置过期时间” 需一步完成，避免进程崩溃导致死锁。
2. 过期自动释放：为锁设置合理过期时间，防止持锁进程异常时锁无法释放。
3. 唯一标识：用随机字符串（如 uniqid() 生成）作为锁的值，确保进程只能释放自己持有的锁。
4. 非阻塞（可选）：获取锁失败时可直接返回，避免进程阻塞等待。

三、PHP 实现实例

<?php

namespace common\library\traits\redis;

trait LockTrait
{
    protected $lockKey; // 锁key

    /**
     * 加锁
     *
     * @param mixed $key
     */
    public function lock($key, int $expireIn = 5, int $wait = 0): bool
    {
        $this->lockKey = $key;

        do {
            $lock = $this->setNx($key, time(), $expireIn);
            if ($lock) {
                return true;
            }
            if ($wait > 0) {
                sleep(1);
            }
        } while ($wait--); // 防止偶尔性的获取锁失败的情况

        // 无法正常获取锁 不允许往下进行
        return false;
    }

    /**
     * 释放锁
     */
    public function unlock(): bool
    {
        return $this->delete($this->lockKey);
    }
}