Memcache::getVersion
string Memcache::getVersion ( void )
说明:
返回运行的Memcache的版本信息。相同函数memcache_get_version()
返回值:
成功返回服务器的版本信息,失败的时候返回false。
例子:
<?php
/* 面向对象 API */
$memcache = new Memcache;
$memcache->connect('memcache_host', 11211);
echo $memcache->getVersion();
/* 面向过程 API */
$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
/* 面向过程 API */
$memcache_obj = memcache_pconnect('memcache_host', 11211);
/* 面向对象 API */
$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);
/* 面向过程 API */
memcache_replace($memcache_obj, "test_key", "some variable", false, 30);
/* 面向对象 API */
$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。
例子:
/*
面向对象
API */
$memcache_obj
= new
Memcache
;
/*
连接到
memcached
服务器
*/
$memcache_obj
->
connect
(
'memcache_host'
,
11211
);
/*
给键
'var_key'
设置值
,
使用压缩方式,延时是
50
秒
*/
$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
/* 面向对象 API */
$memcache_obj = new Memcache;
$memcache_obj->addServer('memcache_host', 11211);
$memcache_obj->setCompressThreshold(20000, 0.2);
/* 面向过程 API */
$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";
}
/* 面向对象 API */
$memcache = new Memcache;
// 离线模式增加一个服务器
$memcache->addServer('memcache_host', 11211, false, 1, 1, -1, false);
// 把服务器设成在线
$memcache->setServerParams('memcache_host', 11211, 1, 15, true, '_callback_memcache_failure');
/* 面向过程 API */
$memcache_obj = memcache_connect('memcache_host', 11211);
memcache_set_server_params($memcache_obj, 'memcache_host', 11211, 1, 15, true, '_callback_memcache_failure');
?>