Redis如何使用lua脚本实例教程

前言

在redis的官网上洋洋洒洒的大概提供了200多个命令，貌似看起来很多，但是这些都是别人预先给你定义好的，但你却不能按照自己的意图进行定制，

所以是不是感觉自己还是有一种被束缚的感觉，有这个感觉就对了。。。

说来也巧，redis的大老板给了你解决这种问题的方法，那就是Lua脚本，而且redis的最新版本也支持Lua Script debug，这应该也是未来Redis的一

个发展趋势，要想学好Redis，必会Lua Script。。。

下面话不多说了，来一起看看详细的介绍吧

版本：自2.6.0起可用。

时间复杂度：取决于执行的脚本。

使用Lua脚本的好处：

• 减少网络开销。可以将多个请求通过脚本的形式一次发送，减少网络时延。
• 原子操作。redis会将整个脚本作为一个整体执行，中间不会被其他命令插入。因此在编写脚本的过程中无需担心会出现竞态条件，无需使用事务。
• 复用。客户端发送的脚步会永久存在redis中，这样，其他客户端可以复用这一脚本而不需要使用代码完成相同的逻辑。

如何使用

基本使用

命令格式：

EVAL script numkeys key [key ...] arg [arg ...]

说明：

• script是第一个参数，为Lua 5.1脚本。该脚本不需要定义Lua函数（也不应该）。
• 第二个参数numkeys指定后续参数有几个key。
• key [key ...]，是要操作的键，可以指定多个，在lua脚本中通过KEYS[1], KEYS[2]获取
• arg [arg ...]，参数，在lua脚本中通过ARGV[1], ARGV[2]获取。

简单实例：

127.0.0.1:6379> eval "return ARGV[1]" 0 100
"100"
127.0.0.1:6379> eval "return {ARGV[1],ARGV[2]}" 0 100 101
1) "100"
2) "101"
127.0.0.1:6379> eval "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 2 key1 key2 first second
1) "key1"
2) "key2"
3) "first"
4) "second"

127.0.0.1:6379> eval "redis.call('SET', KEYS[1], ARGV[1]);redis.call('EXPIRE', KEYS[1], ARGV[2]); return 1;" 1 test 10 60
(integer) 1
127.0.0.1:6379> ttl test
(integer) 59
127.0.0.1:6379> get test
"10"

注：

• {}在lua里是指数据类型table，类似数组。
• redis.call()可以调用redis命令。

命令行里使用

如果直接使用redis-cli命令，格式会有点不一样：

redis-cli --eval lua_file key1 key2 , arg1 arg2 arg3

注意的地方：

• eval 后面参数是lua脚本文件,.lua后缀
• 不用写numkeys，而是使用,隔开。注意,前后有空格。

示例：

incrbymul.lua

local num = redis.call('GET', KEYS[1]); 

if not num then
 return 0;
else
 local res = num * ARGV[1];
 redis.call('SET',KEYS[1], res);
 return res;
end

命令行运行：

$ redis-cli --eval incrbymul.lua lua:incrbymul , 8
(integer) 0
$ redis-cli incr lua:incrbymul
(integer) 1
$ redis-cli --eval incrbymul.lua lua:incrbymul , 8
(integer) 8
$ redis-cli --eval incrbymul.lua lua:incrbymul , 8
(integer) 64
$ redis-cli --eval incrbymul.lua lua:incrbymul , 2
(integer) 128

由于redis没有提供命令可以实现将一个数原子性的乘以N倍，这里我们就用Lua脚本实现了，运行过程中确保不会被其它客户端打断。

phpredis里使用

接着上面的例子：

incrbymul.php

<?php 

$lua = <<<EOF
local num = redis.call('GET', KEYS[1]); 

if not num then
 return 0;
else
 local res = num * ARGV[1];
 redis.call('SET',KEYS[1], res);
 return res;
end

EOF;

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$ret = $redis->eval($lua, array("lua:incrbymul", 2), 1);
echo $ret;

运行：

$ redis-cli set lua:incrbymul 0
OK
$ redis-cli incr lua:incrbymul
(integer) 1
$ php incrbymul.php
2
$ php incrbymul.php
4

eval原型：

Redis::eval(string script, [array keys, long num_keys])

eval函数的第3个参数为KEYS个数，phpredis依据此值将KEYS和ARGV做区分。

参考

1、在redis中使用lua脚本让你的灵活性提高5个逼格 - 一线码农

https://www.jb51.net/article/148830.htm

2、Redis执行Lua脚本示例 - yanghuahui

https://www.jb51.net/article/148833.htm

3、EVAL - Redis

https://redis.io/commands/eval

4、phpredis 执行LUA脚本的例子 - jingtan的专栏

https://www.jb51.net/article/148838.htm

5、lua-book

http://me.52fhy.com/lua-book/

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对我们的支持。