©
本文檔使用 php中文網手册 發布
INCR key
自1.0.0起可用。
时间复杂度： O（1）
将存储的数字key加1。如果密钥不存在，则0在执行操作之前将其设置为。如果密钥包含错误类型的值或包含无法表示为整数的字符串，则会返回错误。该操作仅限于64位有符号整数。
注意：这是一个字符串操作，因为Redis没有专用的整数类型。存储在密钥中的字符串被解释为一个以10为底的64位有符号整数来执行操作。
Redis 以整数表示形式存储整数，因此对于实际上包含整数的字符串值，不存在用于存储整数的字符串表示形式的开销。
返回值
整数回复：key增量后的值
例子
redis> SET mykey "10" "OK" redis> INCR mykey (integer) 11 redis> GET mykey "11"
模式：计数器
计数器模式是使用 Redis 原子增量操作可以做的最明显的事情。这个想法只是在每次操作发生时发送 INCR 命令给 Redis。例如，在一个 Web 应用程序中，我们可能想知道这个用户一年中每天都做了多少页面浏览。
为此，Web 应用程序可以在每次用户执行页面视图时简单地增加一个键，创建连接用户 ID 的键名和代表当前日期的字符串。
这种简单模式可以通过多种方式进行扩展：
可以在每个页面视图中一起使用 INCR 和 EXPIRE，使计数器只计算最近 N 个分页少于指定秒数的页面视图。
客户端可以使用 GETSET 来自动获取当前计数器值并将其重置为零。
使用其他原子增量/减量命令（如 DECR 或 INCRBY），可以根据用户执行的操作来处理可能变大或变小的值。想象一下在线游戏中不同用户的分数。
模式：限速器
速率限制器模式是一个特殊的计数器，用于限制执行操作的速率。这种模式的经典实现涉及限制可以针对公共 API 执行的请求的数量。
我们使用 INCR 提供了这种模式的两种实现，我们假设要解决的问题是将 API 调用的数量限制为每IP地址每秒最多10个请求。
模式：限速器1
这种模式的更简单直接的实现如下：
FUNCTION LIMIT_API_CALL(ip)ts = CURRENT_UNIX_TIME()keyname = ip+":"+ts current = GET(keyname)IF current != NULL AND current > 10 THEN ERROR "too many requests per second"ELSE MULTI INCR(keyname,1) EXPIRE(keyname,10) EXEC PERFORM_API_CALL()END
基本上我们有每个IP的柜台，每隔一秒钟。但是这个计数器总是递增的，设置10秒过期，以便在当前秒不同时自动将它们由 Redis移除。
请注意使用 MULTI 和 EXEC，以确保我们在每次 API 调用时都会递增并设置到期。
模式：限速器2
另一种实现方法是使用单个计数器，但要在没有竞争条件的情况下进行正确的设置会更复杂一些。我们将研究不同的变体。
FUNCTION LIMIT_API_CALL(ip):current = GET(ip)IF current != NULL AND current > 10 THEN ERROR "too many requests per second"ELSE value = INCR(ip) IF value == 1 THEN EXPIRE(ip,1) END PERFORM_API_CALL()END
计数器的创建方式只能在当前秒的第一次请求开始后才能存活一秒。如果在同一秒内有超过10个请求，则计数器将达到大于10的值，否则将过期并从0开始。
在上面的代码中有一个竞争条件。如果由于某种原因，客户端执行INCR 命令但不执行 EXPIRE，密钥将被泄露，直到我们再次看到相同的IP地址。
这可以很容易地解决，将带有可选 EXPIRE 的 INCR 转换为使用EVAL 命令发送的 Lua 脚本（仅在 Redis 版本2.6以后可用）。
local current
current = redis.call("incr",KEYS[1])if tonumber(current) == 1 then
redis.call("expire",KEYS[1],1)end有一种不使用脚本解决此问题的方法，但使用 Redis 列表而不是计数器。实现更复杂，使用更多高级功能，但具有记住当前正在执行API调用的客户端的IP地址的优点，根据应用程序的不同，该地址可能有用或无用。
FUNCTION LIMIT_API_CALL(ip)current = LLEN(ip)IF current > 10 THEN ERROR "too many requests per second"ELSE IF EXISTS(ip) == FALSE MULTI RPUSH(ip,ip) EXPIRE(ip,1) EXEC ELSE RPUSHX(ip,ip) END PERFORM_API_CALL()END
如果密钥已经存在，RPUSHX 命令只会推送元素。
请注意，我们在这里有一场竞赛，但这不是问题：在我们在MULTI / EXEC 块中创建它之前，EXISTS 可能会返回 false，但可能会由另一个客户端创建密钥。然而，这种竞争只会在极少数情况下错过API调用，所以速率限制仍然可以正常工作。