部分存储命令在发送时会包含一个失效值到服务端。实际发送的值可以是一个Unix时间戳timestamp，或者是一个从现在算起的以秒为单位的数字。对于后一种情况，这个秒数不能超过60×60×24×30（30天时间的秒数），如果失效的值大于这个值，服务端会将其作为一个真实的Unix时间戳来处理而不是自当前时间的偏移。

注意：如果失效值被设置为0（默认），此元素永不过期（但是它可能由于服务端为了给其他新的元素分配空间而被删除）。

sessions支持

memcached提供了一个自定义的session处理器可以被用于存储用户session数据到memcached服务端。一个完全独立的memcached实例将会在内部使用，因此如果需要您可以设置一个不同的服务器池。

session.save_handler string 

;设置为memcached开启memcached的session处理器。 

session.save_path string 

;定义一个逗号分隔的hostname:port样式的session缓存服务器池，例如： "sess1:11211, sess2:11211".

memcached类

Memcached::add — 向一个新的key下面增加一个元素
```
public Memcached::add( string $key, mixed $value[, int $expiration] ) : bool
```
Memcached::add()与Memcached::set()类似，但是如果 key已经在服务端存在，此操作会失败。
Memcached::addByKey — 在指定服务器上的一个新的key下增加一个元素
Memcached::addServer — 向服务器池中增加一个服务器
Memcached::addServers — 向服务器池中增加多台服务器
Memcached::append — 向已存在元素后追加数据
Memcached::appendByKey — 向指定服务器上已存在元素后追加数据
Memcached::cas — 比较并交换值
Memcached::casByKey — 在指定服务器上比较并交换值
Memcached::__construct — 创建一个Memcached实例
Memcached::decrement — 减小数值元素的值

Memcached::decrement()减小一个数值元素的值，减小多少由参数offset决定。如果元素的值不是数值，以0值对待。如果减小后的值小于0,则新的值被设置为0.如果元素不存在，Memcached::decrement() 失败。
Memcached::decrementByKey — Decrement numeric item’s value, stored on a specific server
Memcached::delete — 删除一个元素

Memcached::delete()从服务端删除key对应的元素. 参数time是一个秒为单位的时间(或一个UNIX时间戳表明直到那个时间), 用来表明客户端希望服务端在这段时间拒绝对这个key的add和replace命令. 由于这个时间段的存在, 元素被放入一个删除队列, 表明它不可以通过get命令获取到值, 但是同时 add和replace命令也会失败(无论如何set命令都会成功). 在这段时间过去后, 元素最终被从服务端内存删除.time参数默认0(表明元素会被立即删除并且之后对这个 key的存储命令也会成功).
Memcached::deleteByKey — 从指定的服务器删除一个元素
Memcached::deleteMulti — Delete multiple items
Memcached::deleteMultiByKey — Delete multiple items from a specific server
Memcached::fetch — 抓取下一个结果
Memcached::fetchAll — 抓取所有剩余的结果
Memcached::flush — 作废缓存中的所有元素
Memcached::get — 检索一个元素

返回存储在服务端的元素的值或者在其他情况下返回FALSE。如果key不存在，Memcached::getResultCode()返回Memcached::RES_NOTFOUND。
Memcached::getAllKeys — Gets the keys stored on all the servers

查询每个memcache服务器，并检索当时存储在服务器上的所有键的数组。这不是一个原子操作，因此它不是键在某个时间点上的真正一致的快照。由于memcache不能保证返回所有的键值，所以也不能假设所有的键值都已经返回。
Memcached::getByKey — 从特定的服务器检索元素
Memcached::getDelayed — 请求多个元素

Memcached::getDelayed()向Memcached服务端发出一个检索keys指定的多个 key对应元素的请求。这个方法不会等待响应而是立即返回。当你需要收集元素值时，调用Memcached::fetch()或 Memcached::fetchAll()。如果with_cas设置为true，会同时请求每个元素的CAS标记。

可以通过参数value_cb指定一个result callback来替代明确的抓取结果（fetch或fetchAll为明确抓取方式）。
Memcached::getDelayedByKey — 从指定的服务器上请求多个元素
Memcached::getMulti — 检索多个元素
Memcached::getMultiByKey — 从特定服务器检索多个元素
Memcached::getOption — 获取Memcached的选项值
Memcached::getResultCode — 返回最后一次操作的结果代码
Memcached::getResultMessage — 返回最后一次操作的结果描述消息
Memcached::getServerByKey — 获取一个key所映射的服务器信息
Memcached::getServerList — 获取服务器池中的服务器列表
Memcached::getStats — 获取服务器池的统计信息
Memcached::getVersion — 获取服务器池中所有服务器的版本信息
Memcached::increment — 增加数值元素的值

Memcached::increment() 将一个数值元素增加参数 offset 指定的大小。如果元素的值不是数值类型，将返回错误。如果元素不存在， Memcached::increment() 会将元素设置成 initial_value 指定的值。
Memcached::incrementByKey — Increment numeric item’s value, stored on a specific server
Memcached::isPersistent — 检查memcache服务器的连接是否为持久连接。

检查memcache服务器的连接是否为持久连接。
Memcached::isPristine — Check if the instance was recently created
Memcached::prepend — 向一个已存在的元素前面追加数据
Memcached::prependByKey — Prepend data to an existing item on a specific server
Memcached::quit — 关闭所有打开的链接。

Memcached::quit() 关闭所有memcache服务器的链接。
Memcached::replace — 替换已存在key下的元素

Memcached::replace()和Memcached::set()类似，但是如果服务端不存在key，操作将失败。
Memcached::replaceByKey — Replace the item under an existing key on a specific server
Memcached::resetServerList — Clears all servers from the server list
Memcached::set — 存储一个元素

Memcached::set()将value 存储在一个memcached服务器上的key下。expiration参数用于控制值的过期时间。

值可以是任何有效的非资源型php类型，因为资源类型不能被序列化存储。如果Memcached::OPT_COMPRESSION 选项开启，序列化的值同样会被压缩存储。
Memcached::setByKey — 将元素存储到指定的服务器上
Memcached::setMulti — 存储多个元素

Memcached::setMulti()类似于Memcached::set()，但是使用了参数items指定多个元素来替代单独的key/value设置以便于对多个元素的操作。expiration 参数指定的时候一次应用到所有的元素上。
Memcached::setMultiByKey — Store multiple items on a specific server
Memcached::setOption — 设置一个memcached选项
Memcached::setOptions — Set Memcached options
Memcached::setSaslAuthData — Set the credentials to use for authentication
Memcached::touch — 在给定的键上设置新的过期值。

在给定的键上设置新的过期值。类似于redis的ttl。
Memcached::touchByKey — Set a new expiration on an item on a specific server

PHP函数参考18-memcached扩展

目录

memcached介绍

超时时间

sessions支持

memcached类

TsingChan