Memcached存储命令

Memcached各个存储命令的语法格式都类似，且有相同的参数和参数含义，先将可能出现的各个参数的意义说明如下：

key：    键值 key-value 结构中的 key，用于查找缓存值。

flags：   可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。

exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）

bytes：  在缓存中存储的字节数

noreply（可选）： 该参数告知服务器不需要返回数据

value：   存储的值（始终位于第二行）（可直接理解为key-value结构中的value）

unique_cas_token：通过 gets 命令获取的一个唯一的64位值。

1. Memcached set命令：

Memcached set 命令用于将 value(数据值) 存储在指定的 key(键) 中。

如果set的key已经存在，该命令可以更新该key所对应的原来的数据，也就是实现更新的作用。

语法：

set key flags exptime bytes [noreply]

value

输出信息说明（若设置了noreply参数则没有输出）：

STORED： 保存成功后输出。

ERROR：  在保持失败后输出。

2. Memcached add命令：

Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。

如果 add 的 key 已经存在，则不会更新数据，之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。

语法：

add key flags exptime bytes [noreply]

value

输出信息说明（若设置了noreply参数则没有输出）：

STORED： 保存成功后输出。

NOT_STORED：在保存失败后输出。

注：add命令和set命令的区别在于，当键名已存在时，set会更新键名对应的数据，而add则不会跟新数据。

3. Memcached replace命令：

Memcached replace 命令用于替换已存在的 key(键) 的 value(数据值)。

如果 key 不存在，则替换失败，并且您将获得响应 NOT_STORED。

语法：

replace key flags exptime bytes [noreply]

value

输出信息说明：

STORED：保存成功后输出。

NOT_STORED：执行替换失败后输出。

注：replace命令和set的更新功能一样。

4. Memcached append命令：

Memcached append 命令用于向已存在 key(键) 的 value(数据值) 后面追加数据。

语法：

append key flags exptime bytes [noreply]

value

输出信息说明：

STORED：保存成功后输出。

NOT_STORED：该键在 Memcached 上不存在。

CLIENT_ERROR：执行错误。

5. Memcached prepend命令：

Memcached prepend 命令用于向已存在 key(键) 的 value(数据值) 前面追加数据。

语法：

prepend key flags exptime bytes [noreply]

value

输出信息说明：

STORED：保存成功后输出。

NOT_STORED：该键在 Memcached 上不存在。

CLIENT_ERROR：执行错误。

6. Memcached CAS命令：

Memcached CAS（Check-And-Set 或 Compare-And-Swap） 命令用于执行一个"检查并设置"的操作。它仅在当前客户端最后一次取值后，该key 对应的值没有被其他客户端修改的情况下， 才能够将值写入。检查是通过cas_token参数进行的， 这个参数是Memcach指定给已经存在的元素的一个唯一的64位值。

语法：

cas key flags exptime bytes unique_cas_token [noreply]

value

输出信息说明：

STORED：保存成功后输出。

ERROR：保存出错或语法错误。

EXISTS：在最后一次取值后另外一个用户也在更新该数据。

NOT_FOUND：Memcached 服务上不存在该键值。

注：要在 Memcached 上使用 CAS 命令，你需要从 Memcached 服务商通过 gets 命令获取令牌（token）。

使用示例：