您当前的位置: 首页 » PHP/Perl编程 » PHP缓存技术：memcache函数详解之三
PHP缓存技术：memcache函数详解之三
论坛链接
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');
?>
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');
?>