memcache stats 说明

glcui

Memcache常用方法
Memcache::add &md ash; 添加一个值，如果已经存在，则返回false
Memcache::add Server — 添加一个可供使用的 服务器地址
Memcache::close — 关闭一个Memcache对象
Memcache::connect — 创建一个Memcache对象
Memcache::debug — 控制调试功能
Memcache::decrement — 对保存的某个key中的值进行减法操作
Memcache::delete — 删除一个key值
Memcache::flush — 清除所有缓存的数据
Memcache:: get — 获取一个key值
Memcache::getExtendedStats — 获取进程池中所有进程的运行系统统计
Memcache::getServerStatus — 获取运行服务器的参数
Memcache::getStats — 返回服务器的一些运行统计信息
Memcache::getVersion — 返回运行的Memcache的版本信息
Memcache::increment — 对保存的某个key中的值进行加法操作
Memcache::pconnect — 创建一个Memcache的持久连接对象
Memcache::replace — R对一个已有的key进行覆写操作
Memcache::set — 添加一个值，如果已经存在，则覆写
Memcache::setCompressThreshold — 对大于某一大小的数据进行压缩
Memcache::setServerParams — 在运行时修改服务器的参数
Memcache方法使用


Memcached 简介：

Memcached是一个高性能的、分布式内存对象缓存系统。通常被用于降低数据库加载压力以提高动态web应用的响应速度。

此扩展使用了libmemcached库提供的api与memcached服务端进行交互。它同样提供了一个session处理器（memcached）。 它同时提供了一个session处理器


关于libmemcached的更多信息可以在http://libmemcached.org/libMemcached.html查看。

Memcache 需求：

这个扩展需要libmemcached客户端库。

Memcache 安装：

安装此 PECL 扩展相关的信息可在手册中标题为 PECL 扩展的安装 章节中找到。另外的信息，如新的发行版本、下载、源文件、 Additional information such as new releases,维护人员信息及变更日志等，都在此处：http://pecl.php.net/package/memcached.

如果libmemcached被安装在一个非标准路径，使用--with-libmemcached-dir=DIR 来指定路径，DIR就是libmemcached安装时的prefix参数。这个路径需要包含文件include/libmemcached/memcached.h。

如果要支持压缩就需要zlib。对于非标准安装的zlib库，使用--with-zlib-dir=DIR 来指定zlib安装路径，DIR就是zib安装时的prefix参数。

session处理器的支持默认是开启的。如果要关闭它，使用选项--disable-memcached-session 。

预定义常量：

下列常量由此扩展定义，且仅在此扩展编译入 PHP 或在运行时动态载入时可用。

Memcached::OPT_COMPRESSION
开启或关闭压缩功能。当开启的时候，item的值超过某个阈值（当前是100bytes）时，会首先对值进行压缩然后存储，并 在获取该值时进行解压缩然后返回，使得压缩对应用层透明。

类型: boolean, 默认: TRUE.

Memcached::OPT_SERIALIZER
指定对于非标量值进行序列化的序列化工具。可用的值有Memcached::SERIALIZER_PHP 和Memcached::SERIALIZER_IGBINARY。后者仅在memcached配置时开启 --enable-memcached-igbinary选项并且 igbinary扩展被加载时才有效。

类型: integer, 默认: Memcached::SERIALIZER_PHP.

Memcached::SERIALIZER_PHP
默认的PHP序列化工具（即serialize方法）。

Memcached::SERIALIZER_IGBINARY
» igbinary序列化工具。它将php的数据结构 存储为紧密的二进制形式，在时间和空间上都有所改进。

Memcached::SERIALIZER_JSON
JSON序列化，需要 PHP 5.2.10以上。

Memcached::OPT_PREFIX_KEY
可以用于为key创建“域”。这个值将会被作为每个key的前缀，它不能长于128个字符， 并且将会缩短最大可允许的key的长度。这个前缀仅仅用于被存储的元素的key，而不会用于服务器key。

类型: string, 默认: "".

Memcached::OPT_HASH
指定存储元素key使用的hash算法。可用的值是Memcached::HASH_*系列的常量。 每种hash算法都有它的优势和劣势，在你不了解或不确定哪种算法对你更有利时，请使用默认值。

类型: integer, 默认: Memcached::HASH_DEFAULT

Memcached::HASH_DEFAULT
默认的(Jenkins one-at-a-time)元素key hash算法

Memcached::HASH_MD5
md5元素key hash算法。

Memcached::HASH_CRC
CRC元素key hash算法。

Memcached::HASH_FNV1_64
FNV1_64元素key hash算法。

Memcached::HASH_FNV1A_64
FNV1_64A元素key hash算法。

Memcached::HASH_FNV1_32
FNV1_32元素key hash算法。

Memcached::HASH_FNV1A_32
FNV1_32A元素key hash算法。

Memcached::HASH_HSIEH
Hsieh元素key hash算法。

Memcached::HASH_MURMUR
Murmur元素key hash算法。

Memcached::OPT_DISTRIBUTION
指定元素key分布到各个服务器的方法。当前支持的方法有余数分步法合一致性hash算法两种。一致性hash算法提供 了更好的分配策略并且在添加服务器到集群时可以最小化缓存丢失。

类型: integer, 默认: Memcached::DISTRIBUTION_MODULA.

Memcached::DISTRIBUTION_MODULA
余数分布算法。

Memcached::DISTRIBUTION_CONSISTENT
一致性分布算法(基于libketama).

Memcached::OPT_LIBKETAMA_COMPATIBLE
开启或关闭兼容的libketama类行为。当开启此选项后，元素key的hash算法将会被设置为md5并且分布算法将会 采用带有权重的一致性hash分布。这一点非常有用因为其他基于libketama的客户端（比如python，urby）在同样 的服务端配置下可以透明的访问key。

Note:

如果你要使用一致性hash算法强烈建议开启此选项，并且这个选项可能在未来的发布版中被设置为默认开启。

类型: boolean, 默认: FALSE.

Memcached::OPT_BUFFER_WRITES
开启或关闭I/O缓存。开启I/O缓存会导致存储命令不实际发送而是存储到缓冲区中。任意的检索数据操作都会导致 缓存中的数据被发送到远程服务端。退出连接或关闭连接也会导致缓存数据被发送到远程服务端。

类型: boolean, 默认: FALSE.

Memcached::OPT_BINARY_PROTOCOL
开启使用二进制协议。请注意这个选项不能在一个打开的连接上进行切换。

类型: boolean, 默认: FALSE.

Memcached::OPT_NO_BLOCK
开启或关闭异步I/O。这将使得存储函数传输速度最大化。

类型: boolean, 默认: FALSE.

Memcached::OPT_TCP_NODELAY
开启或关闭已连接socket的无延迟特性（在某些幻境可能会带来速度上的提升）。

类型: boolean, 默认: FALSE.

Memcached::OPT_SOCKET_SEND_SIZE
socket发送缓冲的最大值。

类型: integer, 默认: 根据不同的平台/内核配置不同

Memcached::OPT_SOCKET_RECV_SIZE
socket接收缓冲的最大值。

类型: integer, 默认: 根据不同的平台/内核配置不同

Memcached::OPT_CONNECT_TIMEOUT
在非阻塞模式下这里设置的值就是socket连接的超时时间，单位是毫秒。

类型: integer, 默认: 1000.

Memcached::OPT_RETRY_TIMEOUT
等待失败的连接重试的时间，单位秒。

类型: integer, 默认: 0.

Memcached::OPT_SEND_TIMEOUT
socket发送超时时间，单位毫秒。在这种情况下您不能使用非阻塞I/O，这将使得您仍然有数据会发送超时。

类型: integer, 默认: 0.

Memcached::OPT_RECV_TIMEOUT
socket读取超时时间，单位毫秒。在这种情况下您不能使用非阻塞I/O，这将使得您仍然有数据会读取超时。

类型: integer, 默认: 0.

Memcached::OPT_POLL_TIMEOUT
poll连接超时时间，单位毫秒。

类型: integer, 默认: 1000.

Memcached::OPT_CACHE_LOOKUPS
开启或禁用DNS查找缓存。

类型: boolean, 默认: FALSE.

Memcached::OPT_SERVER_FAILURE_LIMIT
指定一个服务器连接的失败重试次数限制。在达到此数量的失败重连后此服务器将被从服务器池中移除。

类型: integer, 默认: 0.

Memcached::HAVE_IGBINARY
指示是否支持igbinary的序列化。

类型: boolean.

Memcached::HAVE_JSON
指示是否支持json的序列化。

类型: boolean.

Memcached::GET_PRESERVE_ORDER
一个用于Memcached::getMulti()和 Memcached::getMultiByKey()的标记用以确保返回的key和请求的key顺序保持一致。 不存在的key将会得到一个NULL值。

Memcached::RES_SUCCESS
操作成功。

Memcached::RES_FAILURE
某种方式的操作失败。

Memcached::RES_HOST_LOOKUP_FAILURE
DNS查找失败。

Memcached::RES_UNKNOWN_READ_FAILURE
读取网络数据失败。

Memcached::RES_PROTOCOL_ERROR
错误的memcached协议命令。

Memcached::RES_CLIENT_ERROR
客户端错误。

Memcached::RES_SERVER_ERROR
服务端错误。

Memcached::RES_WRITE_FAILURE
向网络写数据失败。

Memcached::RES_DATA_EXISTS
比较并交换值操作失败（cas方法）：尝试向服务端存储数据时由于自此连接最后一次取此key对应数据之后被改变导致失败。

Memcached::RES_NOTSTORED
元素没有被存储，但并不是因为一个错误。这通常表明add（元素已存在）或replace（元素不存在）方式存储数据失败或者元素已经在一个删除序列中（延时删除）。

Memcached::RES_NOTFOUND
元素未找到（通过get或cas操作时）。

Memcached::RES_PARTIAL_READ
局部网络数据读错误。

Memcached::RES_SOME_ERRORS
在多key获取的时候发生错误。

Memcached::RES_NO_SERVERS
服务器池空。

Memcached::RES_END
结果集到结尾了。

Memcached::RES_ERRNO
系统错误。

Memcached::RES_BUFFERED
操作被缓存。

Memcached::RES_TIMEOUT
操作超时。

Memcached::RES_BAD_KEY_PROVIDED
提供了无效的key。

Memcached::RES_CONNECTION_SOCKET_CREATE_FAILURE
创建网络socket失败。

Memcached::RES_PAYLOAD_FAILURE
不能压缩/解压缩或序列化/反序列化值。　　
　　
　　
　　memcache的运行状态可以方便的用stats命令显示。
首先用telnet 127.0.0.1 11211这样的命令连接上memcache，然后直接输入stats就可以得到当前memcache的状态。
这些状态的说明如下：
pidmemcache服务器的进程IDuptime服务器已经运行的秒数time服务器当前的unix时间戳versionmemcache版本pointer_size当前操作系统的指针大小（32位系统一般是32bit）rusage_user进程的累计用户时间rusage_system进程的累计系统时间curr_items服务器当前存储的items数量total_items从服务器启动以后存储的items总数量bytes当前服务器存储items占用的字节数curr_connections当前打开着的连接数total_connections从服务器启动以后曾经打开过的连接数connection_structures服务器分配的连接构造数cmd_getget命令（获取）总请求次数cmd_setset命令（保存）总请求次数get_hits总命中次数get_misses总未命中次数evictions为获取空闲内存而删除的items数（分配给memcache的空间用满后需要删除旧的items来得到空间分配给新的items）bytes_read总读取字节数（请求字节数）bytes_written总发送字节数（结果字节数）limit_maxbytes分配给memcache的内存大小（字节）threads当前线程数