PHP缓存技术：memcache函数详解之一

转自www.5iphp.com

Memcache函数库是在PECL(PHP Extension Community Library)中，主要作用是搭建大容量的内存数据的临时存放区域，在分布式的时候作用体现的非常明显，否则不建议使用。

 

memcache函数所有的方法列表如下：

参考http://www.php.net/manual/zh/function.Memcache-add.php

 

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 - 在运行时修改服务器的参数

 

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);

/*面向过程API*/
memcache_add($memcache_obj,'var_key','testvariable',false,30);

/*面向对象API*/
$memcache_obj->add('var_key','testvariable',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

/*面向对象API*/

$memcache=newMemcache;
$memcache->addServer('memcache_host',11211);
$memcache->addServer('memcache_host2',11211);

/*面向过程API*/

$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

/*面向过程API*/
$memcache_obj=memcache_connect('memcache_host',11211);
/*

执行一些代码..
*/
memcache_close($memcache_obj);

/*面向对象API*/
$memcache_obj=newMemcache;
$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

/*面向过程API*/

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

/*面向对象API*/

$memcache=newMemcache;
$memcache->connect('memcache_host',11211);

?>