Laravel10x怎样使用phpredisLua脚本-php教程-PHP中文网

phpredis中调用lua脚本需用eval($script, $numkeys, ...$args)直接执行，或先script load获取sha1再用evalsha($sha1, $numkeys, ...$args)高效复用；脚本内必须通过redis.call()调用redis命令，keys和argv下标从1开始，且所有key须属同一哈希槽。

laravel10x怎样使用phpredislua脚本

php redis 的 `eval` 和 `evalsha` 怎么调用 Lua 脚本

Laravel 10 默认用的是 Predis，但如果你已切换到 phpredis（通过配置 REDIS_CLIENT=phpredis），那底层就是 Redis 扩展实例，直接支持 eval 和 evalsha 方法。关键不是 Laravel 封装了什么，而是你拿到的 Redis 连接对象是否是 Redis 类型。

验证方式很简单：

dd(app('redis')->connection()->client());

如果输出是 Redis 实例（不是 Predis\Client），就可以直接调用原生方法。

eval($script, $numKeys, ...$args)：第一个参数是 Lua 脚本字符串，第二个是 key 的数量（用于区分 KEYS 和 ARGV），后续参数依次为 key 列表 + arg 列表
evalsha($sha1, $numKeys, ...$args)：先用 script:load 加载脚本得到 SHA1，再执行；避免重复传输脚本内容，适合高频调用
注意：Lua 脚本里用 KEYS[1] 访问第一个 key，ARGV[1] 访问第一个参数，下标从 1 开始

Lua 脚本里访问 Redis 命令要加 `redis.call()`

不能直接写 get key 或 incr counter —— Lua 环境不识别这些命令。所有 Redis 操作必须显式通过 redis.call() 或 redis.pcall() 发起。

例如一个原子计数器加锁逻辑：

local current = redis.call('get', KEYS[1])
if current == false then
  redis.call('set', KEYS[1], ARGV[1])
  redis.call('expire', KEYS[1], ARGV[2])
  return 1
else
  return 0
end

redis.call() 抛异常时整个 eval 失败；redis.pcall() 捕获错误并返回状态表，更安全
脚本里不能用 PHP 变量，所有数据都得靠 KEYS 和 ARGV 传入
避免在脚本里做耗时计算或循环过多（Redis 是单线程，会阻塞）

怎么在 Laravel 中安全复用 Lua 脚本（避免每次传字符串）

每次都传大段 Lua 字符串既难维护又浪费带宽。推荐做法：预加载脚本，缓存 SHA1，运行时只传 SHA 和参数。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

可以在服务提供者里提前加载：

// app/Providers/AppServiceProvider.php
public function boot()
{
    $redis = app('redis')->connection();
    $script = 'return redis.call("incr", KEYS[1])';
    $sha = $redis->script('load', $script);
    Cache::put('lua:incr_sha', $sha, 3600);
}

使用时：

$sha = Cache::get('lua:incr_sha');
$result = app('redis')->connection()->evalsha($sha, 1, 'counter');

第一次 script:load 返回 SHA1，之后用 evalsha 即可；若脚本未加载过，evalsha 会报错 NOSCRIPT No matching script
不要把脚本硬编码在控制器里；建议单独建 resources/lua/ 目录存放 .lua 文件，用 file_get_contents() 读取
SHA1 不跨 Redis 实例共享，集群模式下每个节点需单独 load（Laravel 默认不支持集群下的 lua 共享，得自己处理）