memcache

                                           memcache 学习笔记

一、Memcache概述
出现的原因:随着数据量的增大,访问的集中,使得数据库服务器的负担加重,数据库响应恶化,网站显示延迟等

memcache:是高性能的分布式内存缓存服务器.通过缓存数据库的查询结果,减少数据库的访问次数,以提高web应用的速度,提高可扩展性.缓存方式是将缓存结果存储在内存中,通过内存来维护一个hash表.
Memcache是一个c/s软件,默认间通过端口为11211
二、Memcache工作原理
memcached是以守护程序方式运行于一个或多个服务器中,随时会接收客户端的连接和操作。

原理:
第一次:web应用访问数据库,将查询的结果显示到应用的页面,并将其查询结果放入memcache中缓存
第二次:web访问mecache服务器,如果有数据,直接显示到web应用,否则查询数据库,显示,在进行缓存到memcahe 

三、为什么要在WEB中使用Memcache
原因:数据量的增大,访问的集中,使得数据库服务器的负担加重,数据库响应恶化,网站显示延迟等,
解决方法:这时就需要减少服务器的压力,减少数据库检索次数,可以建立数据库和web应用的中间缓存层来处理
memcache作为高速运行的分布式内存缓存服务器,具有以下几点,完全满足需求:
1 本身是开源的,占用资源小,协议简单的软件,将数据库和web之间的数据缓存,减少数据库的检索次数,减少数据库的i/o
2 基于livevent的时间处理,因为libevent库将linux,bsd,solaris等这些操作系统上的kqueue等时间处理功能功能封装成统一接口,面对连接数增加,也能在linux,bsd,solaris等操作系统上发挥其高性能(i/o).
3 存储方式:内置于内存存储方式,存取的效率高,执行的速度快
4 memcache不互相通信的分布式:同个客户端使得key有规律的封装,实现memcache实现分布式,采用多台cached服务器,增加缓存的横向延伸
四、安装Memcache服务器(Linux和Window上分别安装)
Linux下
1 安装libevent时
./configure –with-libevent=/usr
Make && make install
2 安装memcached
./configure –with-libevent=/usr
Make && make install
3 启动Memcahced –d –m 128 –l 192.168.1.111 –p 11211 –u root
停止: kill `cat /tmp/memcached.pid`;
Killall memcached
Windows下
Memcahced.exe -d install [uninstall] 
Memcached.exe –d -m 50 –l 127.0.0.1 -p 11211 start
五、Memcached服务器的管理(启动)
Linux下启动memcached 
# /usr/local/bin/memcached -d -m 2048 -u root -l 192.168.1.20 -p 12111 -c 1024 -P /tmp/memcached.pid 
参数说明: 
-d 启动为守护进程 
-m <num> 分配给Memcached使用的内存数量,单位是MB,默认为64MB 
-u <username> 运行Memcached的用户,仅当作为root运行时 
-l <ip_addr> 监听的服务器IP地址,默认为环境变量INDRR_ANY的值 
-p <num> 设置Memcached监听的端口,最好是1024以上的端口 
-c <num> 设置最大并发连接数,默认为1024 
-P <file> 设置保存Memcached的pid文件,与-d选择同时使用 
Windows下安装. 然后开始 memcached -d start
memcached的基本设置:
-p 监听的端口 
-l 连接的IP地址, 默认是本机 
-d start 启动memcached服务 
-d restart 重起memcached服务 
-d stop|shutdown 关闭正在运行的memcached服务 
-d install 安装memcached服务 
-d uninstall 卸载memcached服务 
-u 以的身份运行 (仅在以root运行的时候有效) 
-m 最大内存使用,单位MB。默认64MB ,最大好像2G
-M 内存耗尽时返回错误,而不是删除项 
-c 最大同时连接数,默认是1024 
-f 块大小增长因子,默认是1.25 
-n 最小分配空间,key+value+flags默认是48 
-h 显示帮助

1 Memcache的协议的错误部分主要是三个错误提示之提示指令:
  普通错误信息:ERROR\r\n
  客户端错误:CLIENT_ERROR <错误信息>\r\n
  服务器端错误:SERVER_ERROR <错误信息>\r\n
2 [ 数据保存指令]
  数据保存是基本的功能,就是客户端通过命令把数据返回过来,服务器端接收后进行处理。
  A 指令格式:<命令> <键> <标记> <有效期> <数据长度>\r\n
<键key> :就是保存在服务器上唯一的一个表示符
<标记flag> 一个16位的无符号整形,用来设置服务器端跟客户端一些交互的操作
<有效期>是数据在服务器上的有效期限,如果是0,则数据永远有效,单位是秒,Memcache服务器端会把一个数据的有效期设置为当前Unix时间+设置的有效时间
<数据长度>块数据的长度,一般在这个个长度结束以后下一行跟着block data数据内容,发送完数据以后,客户端一般等待服务器端的返回,服务器端的返回:数据保存成功(STORED\r\n),数据保存失败(NOT_STORED\r\n),一般是因为服务器端这个数据key已经存在了
B 主要是三个储存数据的三个命令, set, add, replace
  set 命令是保存一个叫做key的数据到服务器上
  add 命令是添加一个数据到服务器,但是服务器必须这个key是不存在的,能够保证数据不会被覆盖
  replace 命令是替换一个已经存在的数据,如果数据不存在,就是类似set功能
  
3 [ 数据提取命令]
get指令,格式是:get <键>*\r\n 
<键>key是是一个不为空的字符串组合,发送这个指令以后,等待服务器的返回。如果服务器端没有任何数据,则是返回:END\r\n,证明没有不存在这个key,没有任何数据,如果存在数据,则返回指定格式:
 VALUE <键> <标记> <数据长度>\r\n
 
 4 [ 数据删除指令]
  delete <键> <超时时间>\r\n
  <超时时间> - timeout
  按照秒为单位,这个是个可选项,如果你没有指定这个值,那么服务器上key数据将马上被删除,如果设置了这个值,那么数据将在超时时间后把数据清除,该项缺省值是0,就是马上被删除,删除数据后,服务器端会返
  DELETED\r\n:删除数据成功
  NOT_FOUND\r\n:这个key没有在服务器上找到
  
  flush_all指令
这个指令执行后,服务器上所有缓存的数据都被删除,并且返回

九、Memcache的安全(不让别人访问)

[ 内网访问]
最好把两台服务器之间的访问是内网形态的,一般是Web服务器跟Memcache服务器之间。普遍的服务器都是有两块网卡,一块指向互联网,一块指向内网,那么就让Web服务器通过内网的网卡来访问Memcache服务器,我们Memcache的服务器上启动的时候就监听内网的IP地址和端口,内网间的访问能够有效阻止其他非法的访问。
# memcached -d -m 1024 -u root -l 192.168.0.200 -p 11211 -c 1024 -P /tmp/memcached.pid
Memcache服务器端设置监听通过内网的192.168.0.200的ip的11211端口,占用1024MB内存,并且允许最大1024个并发连接
[ 设置防火墙]
防火墙是简单有效的方式,如果却是两台服务器都是挂在网的,并且需要通过外网IP来访问Memcache的话,那么可以考虑使用防火墙或者代理程序来过滤非法访问。
一般我们在Linux下可以使用iptables或者FreeBSD下的ipfw来指定一些规则防止一些非法的访问,比如我们可以设置只允许我们的Web服务器来访问我们Memcache服务器,同时阻止其他的访问。
# iptables -F
# iptables -P INPUT DROP
# iptables -A INPUT -p tcp -s 192.168.0.2 --dport 11211 -j ACCEPT
# iptables -A INPUT -p udp -s 192.168.0.2 --dport 11211 -j ACCEPT
上面的iptables规则就是只允许192.168.0.2这台Web服务器对Memcache服务器的访问,能够有效的阻止一些非法访问,相应的也可以增加一些其他的规则来加强安全性,这个可以根据自己的需要来做。
Session()跨域的解决方案:
1)使用数据库来实现
2)自己写server端,通过改写session处理函数来请求
3)使用nfs等跨机存储来保存session
4)使用memcache来保存
5)使用zend platform提供的解决方案
其中的1-4都是通过改用可以跨机的储存机制,再使用session_set_save_handler()来实现
以下是一些我在使用memcache来实现时的一些记录:
1)使用类来实现时,各回调函数都定义为静态方法,在类的构造中使用session_set_save_handler注册回调函数, 如:
session_set_save_handler(
array('memSession', 'open'),
array('memSession', 'close'), 
array('memSession', 'read'), 
array('memSession', 'write'),
array('memSession', 'destroy'),
array('memSession', 'gc')
);
memSession为类名,要使用session,则先new memSession,再session_start();
2)生存期和垃圾回收
memCache的set命令有生存期,即使用set命令添加值时,可加上lifetime,此时间可以作为session的生存期,用户在此时间内没有动作,则会失效,但有动作则不会失效(因为每一个脚本结束时,都会执行write和close,此时lifetime就会被更新了),当然,如果使用cookie传递SID,则控制SESSION生存期可以用:ini_set('session.cookie_lifetime',time)来设定,这其实是控制cookie的有效时间,如果session赖以生存的cookie消失了,当然session也就活不了,使用cookie_lifetime来控制的话,无论有无动作,都将在指定的时间后过时
gc是指垃圾回收,在session中是指清理过期的session数据,影响的参数有:
session.gc_maxlifetime 被视为垃圾前的生存期,超过此时间没有动作,数据会被清走
注意的是,gc不是每次启动会话都会被执行,而是由session.gc_probability 和 session.gc_divisor的比率决定的
结论:控制SESSION的生存期有几种方法
一是cookie_lifttime,这种方式无论有无动作,都会在指定时间内销毁
二是在read中根椐保存时间控制,此方法在有动作时时间会一直有效
三设定session.gc_probability 和 session.gc_divisor的比率为1(即每次会话都会启用gc),再设定gc.maxlifetime来指定生存期,此方法也是在用户有动作时时间一直有效
3)回调函数的执行时机
open 在运行session_start()时执行
read 在运行session_start()时执行,因为在session_start时,会去read当前session数据并写入$_SESSION变量
destroy 在运行session_destroy()时执行
close 在脚本执行完成或调用session_write_close() 或 session_destroy()时被执行,即在所有session操作完成后被执行
gc 执行概率由session.gc_probability 和 session.gc_divisor的值决定,时机是在open,read之后,即session_start会相继执行open,read和gc
write 此方法在脚本结束和使用session_write_close()强制提交SESSION数据时执行
结论:
session_start //执行open(启动会话),read(读取session数据至$_SESSION),gc(清理垃圾)
脚本中间所有对$_SESSION的操作均不会调用这些回调函数
session_destroy //执行destroy,销毁当前session(一般是删除相应的记录或文件),相应地,此回调函数销毁的只是session的数据,但此时
var_dump一下$_SESSION变量,仍然有值的,但此值不会在close后被write回去
session_write_close() //执行write和close,保存$_SESSION至存储,如不手工使用此方法,则会在脚本结束时被自动执行
清晰了以上信息,将对你清楚了解SESSION的工作原理有很大的帮助...
4)直接使用memcache作session处理
在我写了一系列的memcache来保存session的代码后,无意中发现,可以直接在php.ini中设定使用memcache作为session处理,而无须另外编码,方法是:
修改php.ini中的以下值
session.save_handler = memcache
session.save_path = 'tcp://host1:11211' #有多个时直接用","分隔即可 
如果只想在特定的应用里使用memcache储存session,可以使用ini_set的方法对以上两个参数进行设定
要测试一下是否真正用上了memcache,可以先捕足到使用的PHPSESSID,再作为KEY用memcach去读一下,就清楚了
这几天做某个产品的时候遇到一个小问题,现象比较诡异
产品用了两台分布式的memcached服务器
某一个计数器取回来的数偶尔会不对,最后定位在php memcache client的failover机制上面。
我们知道,在memcached分布式环境下,某一个key是通过hash计算,分配到某一个memcached上面的
如果php.ini里面 memcache.allow_failover = 1的时候,在分布式环境下,某一台memcached出问题的话,会自动到其他的memcached尝试
就会出现上面的问题,原因如下:
这个key是hash到服务器A的,但是服务器A正好一瞬间连不上(网络或者其他问题),PHP就会去另一台服务器B去尝试。
经过很偶然发生的网络问题和很多次increment操作,有可能两台服务器上面都有这个key,而且值不一样……
get的时候有可能取到不同的值
如果对数据一致性要求很严格的话,可以关掉这个参数 memcache.allow_failover = 0,嗯,问题解
memcache.allow_failover 一个布尔值,用于控制当连接出错时 Memcache 扩展是否故障转移到其他服务器上。默认值为 1 (true)。 memcache.max_failover_attempts 一个整型值,用于限制连接到持久性数据或检索数据的服务器数目。如果 memcache.allow_failover 为 false,则将忽略此参数。默认值为 20。 memcache.chunk_size 一个整型值,用于控制数据传输的大小。默认值为 8192 字节 (8 KB),但是如果设置为 32768 (32 KB),则可以获得更好的性能。 memcache.default_port 另一个整型值,用于设置连接到 Memcache 所使用的 TCP 端口。除非您修改它,否则默认值为无特权的高端口 11211。
session.save_handler = memcache
session.save_path = "tcp://host:port?persistent=1&weight=2&timeout=2&retry_interval=15,tcp://host2:port2"

Session_保存在memcache中:
class MemSession {
private static $handler=null;
private static $lifetime=null;
private static $time = null;
const NS='session_';

private static function init($handler){
self::$handler=$handler;
self::$lifetime=ini_get('session.gc_maxlifetime');
self::$time=time();
}
public static function start(Memcache $memcache){
self::init($memcache);
session_set_save_handler(
array(__CLASS__, 'open'),
array(__CLASS__, 'close'),
array(__CLASS__, 'read'),
array(__CLASS__, 'write'),
array(__CLASS__, 'destroy'),
array(__CLASS__, 'gc')
);
session_start();
}

public static function open($path, $name){
return true;
}
public static function close(){
return true;
}
public static function read($PHPSESSID){
$out=self::$handler->get(self::session_key($PHPSESSID));
if($out===false || $out == null)
return '';
return $out;
}
public static function write($PHPSESSID, $data){

$method=$data ? 'set' : 'replace';
return self::$handler->$method(self::session_key($PHPSESSID), $data, MEMCACHE_COMPRESSED, self::$lifetime);
}
public static function destroy($PHPSESSID){
return self::$handler->delete(self::session_key($PHPSESSID));
}
public static function gc($lifetime){
return true;
}
private static function session_key($PHPSESSID){
$session_key=self::NS.$PHPSESSID;
return $session_key;

}
$memcache=new Memcache;
$memcache->connect("localhost", 11211) or die("could not connect!");
MemSession::start($memcache);
1 只直接使用session_strat();
2 将session.save_handler=memcache
session.save_path = "tcp://host:port?persistent=1&weight=2&timeout=2&retry_interval=15,tcp://host2:port2"

 

二、Memcache和memcached的区别 

为什么会有Memcache和memcached两种名称?其实Memcache是这个项目的名称,而memcached是它服务器端的主程序文件名,知道我的意思了把~~~~。一个是项目名称,一个是主程序文件名,在网上看到了很多人不明白,于是混用了。 

 

四、PHP的Memcache客户端所有方法总结 

memcache函数所有的方法列表如下: 
Memcache::add – 添加一个值,如果已经存在,则返回false 
Memcache::addServer – 添加一个可供使用的服务器地址 
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 -对一个已有的key进行覆写操作 
Memcache::set – 添加一个值,如果已经存在,则覆写 
Memcache::setCompressThreshold – 对大于某一大小的数据进行压缩 
Memcache::setServerParams – 在运行时修改服务器的参数 

 

五、PHP的Memcache操作方法分解 

Memcache::add用法 

代码如下:
bool Memcache::add ( string $key , mixed $var [, int $flag [, int $expire ]] )


说明: 
如果$key不存在的时候,使用这个函数来存储$var的值。功能相同的函数是memcache_add()。 

参数: 
$key :将要存储的键值。 
$var :存储的值,字符型和整型会按原值保存,其他类型自动序列化以后保存。 
$flag:是否用MEMCACHE_COMPRESSED来压缩存储的值,true表示压缩,false表示不压缩。 
$expire:存储值的过期时间,如果为0表示不会过期,你可以用unix时间戳或者描述来表示从现在开始的时间,但是你在使用秒数表示的时候,不要超过2592000秒 (表示30天)。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。如果$key值已经存在,则会返回FALSE。 其他情况下Memcache::add()的用法类似于Memcache::set()。 
例子: 

代码如下:

<?php 
$memcache_obj = memcache_connect(”localhost”, 11211); 
memcache_add($memcache_obj, 'var_key', 'test variable', false, 30); 
$memcache_obj->add('var_key', 'test variable', false, 30); 
?>


Memcache::addServer用法 

代码如下:
bool Memcache::addServer ( string $host [, int $port [, bool $persistent [, int $weight [, int$timeout [, int $retry_interval [, bool $status [, callback $failure_callback ]]]]]]] )

说明: 
添加一个可供使用的服务器地址到连接池中,连接用Memcache::addServer打开,脚本执行完后自动关闭,或者可以用Memcache::close()手动关闭。相同函数是memcache_add_server()。 
当用这个方法的时候(相对于Memcache::connect()和 Memcache::pconnect()方法),网络连接只有等需要的时候才会建立,因此不会因为增加很多的服务器到连接池而增加系统负担,因为很多服务器可能没有使用。 
故障恢复会发生在这个方法执行的任何阶段,只要其他的服务器是正常的,这些连接请求的失败用户不会注意到。任何一种socket或者memcached服务器级的错误可以触发故障恢复。正常的客户端错误比如增加一个存在的键值不会引发故障恢复。 

参数: 
$host服务器的地址 
$port服务器端口 
$persistent是否是一个持久连接 
$weight这台服务器在所有服务器中所占的权重 
$timeout连接的持续时间 
$retry_interval连接重试的间隔时间,默认为15,设置为-1表示不进行重试 
$status控制服务器的在线状态 
$failure_callback允许设置一个回掉函数来处理错误信息。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 

例子: 

代码如下:
<?php 
$memcache = new Memcache; 
$memcache->addServer('memcache_host', 11211); 
$memcache->addServer('memcache_host2′, 11211); 

$memcache_obj = memcache_connect('memcache_host', 11211); 
memcache_add_server($memcache_obj, 'memcache_host2′, 11211); 
?> 

Memcache::close用法 

bool Memcache::close ( void ) 

说明: 
关闭memcache服务器连接。这个函数不会关闭长连接,长连接只有在web服务器关闭或者重启的时候才会关闭。相同的函数memcache_close() 
返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 
例子: 

代码如下:

<?php 
$memcache_obj = memcache_connect('memcache_host', 11211); 
memcache_close($memcache_obj); 
$memcache_obj = new Memcache; 
$memcache_obj->connect('memcache_host', 11211); 
$memcache_obj->close(); 
?> 



Memcache::connect用法 

代码如下:
bool Memcache::connect ( string $host [, int $port [, int $timeout ]] )

说明: 
打开memcached服务器连接,建立一个到memcached服务器的连接,用Memcache::connect打开的连接会在脚本执行完毕后自动关闭。你也可以用Memcache::close()去关闭连接。相同的函数是memcache_connect()。 
参数: 
$host:指向memcached正在收听的链接的主机,这个参数会有另一种特殊的连接方式unix:///path/to/memcached.sock,即用unix的域名sockets,这种情况下,端口必须设置为0 
$port:指向memcached正在收听的链接的端口,用unix的域名sockets的情况下,端口必须设置为0 
$timeout:用于连接守护进程的秒数,当你改变默认的1秒的值的时候,你需要考虑一下,如果你的连接太慢的话,你可能会失去缓存的优势。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 
例子: 

代码如下:

<?php 

$memcache_obj = memcache_connect('memcache_host', 11211); 
$memcache = new Memcache; 
$memcache->connect('memcache_host', 11211); 

?> 

memcache::debug 

代码如下:
bool memcache_debug ( bool $on_off )

说明: 
控制调试功能,前提是php在编译的时候使用了-enable-debug选项,否则这个函数不会有作用。 
参数: 
$on_off:true表示开启调试,false表示关闭调试 
返回值: 
如果php在编译的时候使用了-enable-debug选项,返回true,否则返回false 

Memcache::decrement用法 

代码如下:
int Memcache::decrement ( string $key [, int $value ] )


说明: 
Memcache::decremen方法的作用是对保存的某个key中的值进行减法操作,用法跟Memcache::increment类似。 
你也可以用memcache_decrement()函数。 
参数: 
Key:想要减少的键的名字 
Value:想要减少的值。 

返回值: 
如果成功,返回被减少后的值,如果失败返回false。 
例子: 

代码如下:

<?php 
$memcache = new Memcache; 
$memcache->connect('localhost', 11211); 
$memcache->set('test_item', 8); 
$memcache->increment('test_item', 4); 
echo $memcache->decrement('test_item', 7); 
// 显示 5 
?> 

这个例子连Memcache::increment函数都一块演示了。 

Memcache::delete用法 

代码如下:
bool Memcache::delete ( string $key [, int $timeout ] )

说明: 
删除一个key值,如果参数$timeout被设置,那么存储的值会在设置的秒数以后过期,你也可以用函数memcache_delete() 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 

例子: 

代码如下:

<?php 

$memcache_obj = memcache_connect('memcache_host', 11211); 
memcache_delete($memcache_obj, 'key_to_delete', 10); 
$memcache_obj = new Memcache; 
$memcache_obj->connect('memcache_host', 11211); 
$memcache_obj->delete('key_to_delete', 10); 

?> 

Memcache::flush 

代码如下:
bool Memcache::flush ( void )

说明: 
清除所有缓存的数据。Memcache::flush实际上没有释放资源,它仅仅将所有的缓存标记为过期,这样可以使新的缓存来覆盖被占的内存空间。一样的函数是memcache_flush() 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 

例子: 

代码如下:

<?php 

$memcache_obj = memcache_connect('memcache_host', 11211); 

memcache_flush($memcache_obj); 

$memcache_obj = new Memcache; 
$memcache_obj->connect('memcache_host', 11211); 

$memcache_obj->flush(); 

?> 

Memcache::get 

代码如下:

string Memcache::get ( string $key [, int &$flags ] ) 

array Memcache::get ( array $keys [, array &$flags ] )

说明: 
方法的作用是获取一个key值,key值可以是一个数组,结果会包含键值对。 
参数: 
$key是键值或者一个键的数组值。 
$flags如果这个参数存在,那么$flags跟写入这个参数的值相关,这些$flags 类似于Memcache::set()函数里的$flags。 

返回值: 
如果成功,则返回key对应的值,如果失败则返回false. 
例子: 

代码如下:

<?php 
$memcache_obj = memcache_connect('memcache_host', 11211); 
$var = memcache_get($memcache_obj, 'some_key'); 
$memcache_obj = new Memcache; 
$memcache_obj->connect('memcache_host', 11211); 
$var = $memcache_obj->get('some_key'); 

$memcache_obj = memcache_connect('memcache_host', 11211); 
$var = memcache_get($memcache_obj, Array('some_key', 'another_key')); 

$memcache_obj = new Memcache; 
$memcache_obj->connect('memcache_host', 11211); 
$var = $memcache_obj->get(Array('some_key', 'second_key')); 

?> 

Memcache::getExtendedStats 

代码如下:
array Memcache::getExtendedStats ([ string $type [, int $slabid [, int $limit ]]] )

说明: 
获取进程池中所有进程的运行系统统计。相同函数是memcache_get_extended_stats() 
参数: 
$type表示要求返回的类型:reset, malloc, maps, cachedump, slabs, items, sizes; 
$slabid第一个参数设置为”cachedump”时使用的。 
$limit第一个参数设置为”cachedump”时使用的。 
返回值: 
如果成功,返回统计信息,失败会返回false 

例子: 

代码如下:

<?php 
$memcache_obj = new Memcache; 
$memcache_obj->addServer('memcache_host', 11211); 
$memcache_obj->addServer('failed_host', 11211); 

$stats = $memcache_obj->getExtendedStats(); 
//slabs机制分配管理内存的情况 
$statsslab = $memcache_obj->getExtendedStats(slabs); 

?> 

Memcache::getServerStatus 

代码如下:
int Memcache::getServerStatus ( string $host [, int $port ] )

说明: 
获取运行服务器的参数。返回一个服务器在线或者离线的状态。相同的函数是memcache_get_server_status()

参数: 
$host:正在收听的连接的主机 
$port正在收听的连接的主机的端口,默认是11211 

返回值: 
成功返回服务器状态,服务器没有启动会返回0,其他数字的时候表示服务器是启动状态的。 

例子: 

代码如下:

<?php 
$memcache = new Memcache; 
$memcache->addServer('memcache_host', 11211); 
echo $memcache->getServerStatus('memcache_host', 11211); 

$memcache = memcache_connect('memcache_host', 11211); 
echo memcache_get_server_status($memcache, 'memcache_host', 11211); 

?> 

Memcache::getStats 

代码如下:
array Memcache::getStats ([ string $type [, int $slabid [, int $limit ]]] )

说明: 
返回服务器的一些运行统计信息。相同的函数是memcache_get_stats() 

参数: 
$type表示要求返回的类型:reset, malloc, maps, cachedump, slabs, items, sizes; 
$slabid第一个参数设置为”cachedump”时使用的。 
$limit第一个参数设置为”cachedump”时使用的。 

Memcache::getVersion 

代码如下:
string Memcache::getVersion ( void )

说明: 
返回运行的Memcache的版本信息。相同函数memcache_get_version() 

返回值: 
成功返回服务器的版本信息,失败的时候返回false。 

例子: 

代码如下:

<?php 
$memcache = new Memcache; 
$memcache->connect('memcache_host', 11211); 
echo $memcache->getVersion(); 

$memcache = memcache_connect('memcache_host', 11211); 
echo memcache_get_version($memcache); 
?> 

Memcache::increment 

代码如下:
int Memcache::increment ( string $key [, int $value ] )

对保存的某个key中的值进行加法操作 
用法参考Memcache::decrement 
Memcache::pconnect 

代码如下:
bool Memcache::pconnect ( string $host [, int $port [, int $timeout ]] )

说明: 
创建一个Memcache的持久连接对象 
用法与Memcache::connect()相似,不同点地方是Memcache::pconnect是建立的持久连接。这个连接在脚本执行完或者Memcache::close()函数运行也不会被关闭。与它相同的函数是memcache_pconnect() 

参数: 
$host:指向memcached正在收听的链接的主机,这个参数会有另一种特殊的连接方式unix:///path/to/memcached.sock,即用unix的域名sockets,这种情况下,端口必须设置为0 
$port:指向memcached正在收听的链接的端口,用unix的域名sockets的情况下,端口必须设置为0 
$timeout:用于连接守护进程的秒数,当你改变默认的1秒的值的时候,你需要考虑一下,如果你的连接太慢的话,你可能会失去缓存的优势。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE 

代码如下:

<?php 

$memcache_obj = memcache_pconnect('memcache_host', 11211); 

$memcache_obj = new Memcache; 
$memcache_obj->pconnect('memcache_host', 11211); 

?> 

Memcache::replace 

代码如下:
bool Memcache::replace ( string $key , mixed $var [, int $flag [, int $expire ]] )

说明: 
对一个已有的key进行覆写操作。相同函数是memcache_replace() 

参数: 
$key :将要存储的键值。 
$var :存储的值,字符型和整型会按原值保存,其他类型自动序列化以后保存。 
$flag:是否用MEMCACHE_COMPRESSED来压缩存储的值,true表示压缩,false表示不压缩。 
$expire:存储值的过期时间,如果为0表示不会过期,你可以用unix时间戳或者描述来表示从现在开始的时间,但是你在使用秒数表示的时候,不要超过2592000秒 (表示30天)。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。如果$key值已经存在,则会返回FALSE。 

代码如下:

<?php 

$memcache_obj = memcache_connect('memcache_host', 11211); 
memcache_replace($memcache_obj, "test_key", "some variable", false, 30); 
$memcache_obj->replace("test_key", "some variable", false, 30); 

?> 

Memcache::set 

代码如下:
bool Memcache::set ( string $key , mixed $var [, int $flag [, int $expire ]] )


说明: 
添加一个值,如果已经存在,则覆写。相同函数是memcache_set() 

参数: 
$key :将要存储的键值。 
$var :存储的值,字符型和整型会按原值保存,其他类型自动序列化以后保存。 
$flag:是否用MEMCACHE_COMPRESSED来压缩存储的值,true表示压缩,false表示不压缩。 
$expire:存储值的过期时间,如果为0表示不会过期,你可以用unix时间戳或者描述来表示从现在开始的时间,但是你在使用秒数表示的时候,不要超过2592000秒 (表示30天)。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 

例子: 

代码如下:

$memcache_obj = new Memcache; 
$memcache_obj->connect('memcache_host', 11211); 
$memcache_obj->set('var_key', 'some really big variable', MEMCACHE_COMPRESSED, 50); 
echo $memcache_obj->get('var_key'); 



Memcache::setCompressThreshold 

代码如下:
bool Memcache::setCompressThreshold ( int $threshold [, float $min_savings ] )



说明: 
对大于某一大小的数据进行压缩。相同的函数是memcache_set_compress_threshold() 

参数: 
setCompressThreshold方法有两个参数,第一个参数表示处理数据大小的临界点,第二个参数表示压缩的比例,默认为0.2。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 

例子: 

代码如下:

<?php 

$memcache_obj = new Memcache; 
$memcache_obj->addServer('memcache_host', 11211); 
$memcache_obj->setCompressThreshold(20000, 0.2); 

$memcache_obj = memcache_connect('memcache_host', 11211); 
memcache_set_compress_threshold($memcache_obj, 20000, 0.2); 

?> 


Memcache::setServerParams 

代码如下:
bool Memcache::setServerParams ( string $host [, int $port [, int $timeout [, int$retry_interval [, bool $status [, callback $failure_callback ]]]]] 


说明: 
在运行时修改服务器的参数。相同函数是memcache_set_server_params()。 

参数: 
$host服务器的地址 
$port服务器端口 
$timeout连接的持续时间 
$retry_interval连接重试的间隔时间,默认为15,设置为-1表示不进行重试 
$status控制服务器的在线状态 
$failure_callback允许设置一个回掉函数来处理错误信息。 

返回值: 
如果成功则返回 TRUE,失败则返回 FALSE。 

例子: 

代码如下:

<?php 

function _callback_memcache_failure($host, $port) { 
print "memcache '$host:$port' failed"; 


$memcache = new Memcache; 

// 离线模式增加一个服务器 
$memcache->addServer('memcache_host', 11211, false, 1, 1, -1, false); 

// 把服务器设成在线 
$memcache->setServerParams('memcache_host', 11211, 1, 15, true, '_callback_memcache_failure'); 

$memcache_obj = memcache_connect('memcache_host', 11211); 
memcache_set_server_params($memcache_obj, 'memcache_host', 11211, 1, 15, true, '_callback_memcache_failure'); 

?> 
 
posted on 2015-09-29 11:06  IsRunning  阅读(308)  评论(0编辑  收藏  举报