PHP缓存技术：memcache函数详解之三 | Drupal爱好者

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

• 查看
• links

Memcache::getVersion

string Memcache::getVersion ( void )

说明：

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

返回值：

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

例子：

/* 面向对象 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

/* 面向过程 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。

$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。

例子：

/* 面向对象 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。

例子：

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

?>