添加一个可供使用的服务器地址到连接池中,连接用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 = new Memcache;
$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 = 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
/* 面向过程 API */
$memcache_obj = memcache_connect(\'memcache_host\', 11211);
/* 面向对象 API */
$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
/* 面向过程 API */
$memcache_obj = memcache_connect(\'memcache_host\', 11211);
/* 在10秒以后,缓存的值会被服务器删除 */
memcache_delete($memcache_obj, \'key_to_delete\', 10);
/* 面向对象 API */
$memcache_obj = new Memcache;
$memcache_obj->connect(\'memcache_host\', 11211);
$memcache_obj->delete(\'key_to_delete\', 10);
?>
Memcache::flush
bool Memcache::flush ( void )
说明: