2.9.3.返回值

成功返回 TRUE,失败返回 FALSE。

2.9.4.范例

复制代码
<?php
/* procedural API */
$memcache_obj = memcache_connect(‘memcache_host‘, 11211);
/* after 10 seconds item will be deleted by the server */
memcache_delete(
$memcache_obj, ‘key_to_delete‘, 10);
/* OO API */
$memcache_obj = new Memcache;
$memcache_obj->connect(‘memcache_host‘, 11211);
$memcache_obj->delete(‘key_to_delete‘, 10);
?>
复制代码

2.10.Memcache::flush

2.10.1.说明

bool Memcache::flush ( void )

清空所有缓存内容,不是真的删除缓存的内容,只是使所有变量的缓存过期,使内存中的内容被重写

2.10.2.返回值

成功返回 TRUE,失败返回 FALSE。

2.10.3.范例

复制代码
<?php
/* procedural API */
$memcache_obj = memcache_connect(‘memcache_host‘, 11211);
memcache_flush(
$memcache_obj);
/* OO API */
$memcache_obj = new Memcache;
$memcache_obj->connect(‘memcache_host‘, 11211);
$memcache_obj->flush();
?>
复制代码

2.11.Memcache::getExtendedStats

2.11.1.说明

array Memcache::getExtendedStats ([ string $type [, int $slabid [, int $limit ]]] )

获取所有服务器扩展静态信息 

2.11.2.参数

type       静态信息类型,有效值包括{reset, malloc, maps, cachedump, slabs, items, sizes},依照一定规则协议这个可选参数是为了方便开发人员查看不同类别的信息而输入的标题

slabid   用于按指定类型联合设置 cache 堆为有效的片到堆中。缓存堆被被命令绑定到服务器上并被严格的用于调试用途

limit      用于按指定类型联合设置 cache 堆为输入的数字所限制的大小到堆,默认值为 100 

2.11.3.返回值

返回一个由服务器扩展静态信息二维数组,失败时返回 FALSE 

2.11.4.范例

<?php
$memcache_obj = new Memcache;
$memcache_obj->addServer(‘memcache_host‘, 11211);
$memcache_obj->addServer(‘failed_host‘, 11211);
$stats = $memcache_obj->getExtendedStats(); print_r($stats);
?>


输出结果

复制代码
Array(
[memcache_host
:11211=> Array(
[pid] 
=> 3756
[uptime] 
=> 603011
[
time=> 1133810435
[version] 
=> 1.1.12
[rusage_user] 
=> 0.451931
[rusage_system] 
=> 0.634903
[curr_items] 
=> 2483
[total_items] 
=> 3079
[bytes] 
=> 2718136
[curr_connections] 
=> 2
[total_connections] 
=> 807
[connection_structures] 
=> 13
[cmd_get] 
=> 9748
[cmd_set] 
=> 3096
[get_hits] 
=> 5976
[get_misses] 
=> 3772
[bytes_read] 
=> 3448968
[bytes_written] 
=> 2318883
[limit_maxbytes] 
=> 33554432
)
,
[failed_host
:11211=>
)
复制代码


2.12.Memcache::getStats

2.12.1.说明

array Memcache::getStats ([ string $type [, int $slabid [, int $limit ]]] )

获取最后添加服务器静态信息 

2.12.2.参数

type       静态信息类型,有效值包括{reset, malloc, maps, cachedump, slabs, items, sizes},依照一定规则协议这个可选参数是为了方便开发人员查看不同类别的信息而输入的标题

slabid   用于按指定类型联合设置 cache 堆为有效的片到堆中。缓存堆被被命令绑定到服务器上并被严格的用于调试用途

limit      用于按指定类型联合设置 cache 堆为输入的数字所限制的大小到堆,默认值为 100 

2.12.3.返回值

返回一个服务器静态信息数组,失败时返回 FALSE 

2.13.Memcache::getServerStatus

2.13.1.说明

int Memcache::getServerStatus ( string $host [, int $port ] )

通过输入的 host 及 port 来获取相应的服务器信息

2.13.2.参数

host 服务器域名或 IP

port 端口号,默认为 11211

2.13.3.返回值

返回服务器状态,0 为失败,其他情况返回非 0 数字 

2.13.4.范例

复制代码
<?php
/* OO API */
$memcache = new Memcache;
$memcache->addServer(‘memcache_host‘, 11211);
echo $memcache->getServerStatus(‘memcache_host‘, 11211);
/* procedural API */
$memcache = memcache_connect(‘memcache_host‘, 11211);
echo memcache_get_server_status($memcache, ‘memcache_host‘, 11211);
?>
复制代码

2.14.Memcache::getVersion

2.14.1.说明

string Memcache::getVersion ( void )

获取服务器的版本号信息 

2.14.2.返回值

成功返回服务器的版本号字符串,失败返回 FALSE 

2.14.3.范例

复制代码
<?php
/* OO API */
$memcache = new Memcache;
$memcache->connect(‘memcache_host‘, 11211);
echo $memcache->getVersion();
/* procedural API */
$memcache = memcache_connect(‘memcache_host‘, 11211);
echo memcache_get_version($memcache);
?>
复制代码

2.15.Memcache::setCompressThreshold

bool Memcache::setCompressThreshold ( int $threshold [, float $min_savings ] )

设置压缩极限

2.15.2.参数

threshold 设置控制自动压缩的变量长度的最小值

min_saving 指定的最低压缩比率,值必须介于 0 - 1 之间,默认为 0.2 代表 20% 的压缩比率 

2.15.3.返回值

成功返回 TRUE,失败返回 FALSE。 

2.15.4.范例

复制代码
<?php
/* OO API */
$memcache_obj = new Memcache;
$memcache_obj->addServer(‘memcache_host‘, 11211);
$memcache_obj->setCompressThreshold(20000, 0.2);
/* procedural API */
$memcache_obj = memcache_connect(‘memcache_host‘, 11211);
memcache_set_compress_threshold(
$memcache_obj, 20000, 0.2);
?>
复制代码

2.16.Memcache::setServerParams

2.16.1.说明

bool Memcache::setServerParams ( string $host [, int $port [, int $timeout [, int $retry_interval [, bool $status [, callback $failure_callback ]]]]] )

Memcache version 2.1.0 后增加的函数,运行时设置服务器参数

2.16.2.参数

host           服务器域名或 IP

port 端口号,默认为 11211

timeout     超时连接失效的秒数,修改默认值 1 时要三思,有可能失去所有缓存方面的优势导致连接变得很慢

retry_interval     服务器连接失败时的重试频率,默认是 15 秒一次,如果设置为 -1 将禁止自动重试,当扩展中加载了 dynamically via dl() 时,无论本参数还是常连接设置参数都会失效。 每一个失败的服务器在失效前都有独自的生存期,选择后端请求时会被跳过而不服务于请求。一个过期的连接将成功的重新连接或者被标记为失败的连接等待下一次 重试。这种效果就是说每一个 web server 的子进程在服务于页面时的重试连接都跟他们自己的重试频率有关。

status    控制服务器是否被标记为 online,设置这个参数为 FALSE 并设置 retry_interval 为 -1 可以使连接失败的服务器被放到一个描述不响应请求的服务器池子中,对这个服务器的请求将失败,接受设置为失败服务器的设置,默认参数为 TRUE,代表该服务器可以被定义为 online。

failure_callback    失败时的回调函数,函数的两个参数为失败服务器的 hostname 和 port 

2.16.3.返回值

成功返回 TRUE,失败返回 FALSE。 

2.16.4.范例

复制代码
<?php
function _callback_memcache_failure($host, $port)
{
print "memcache ‘$host:$port‘ failed";
}
/* OO API */
$memcache = new Memcache;
// Add the server in offline mode
$memcache->addServer(‘memcache_host‘, 11211, FALSE, 1, 1, -1, FALSE);
// Bring the server back online
$memcache->setServerParams(‘memcache_host‘, 11211, 1, 15, TRUE, ‘_callback_memcache_failure‘);
/* procedural API */
$memcache_obj = memcache_connect(‘memcache_host‘, 11211);
memcache_set_server_params(
$memcache_obj, ‘memcache_host‘, 11211, 1, 15, TRUE, ‘_callback_memcache_failure‘);
?>
复制代码

2.17.Memcache::increment

2.17.1.说明

int Memcache::increment ( string $key [, int $value ] )

给指定 key 的缓存变量一个增值,如果该变量不是数字时不会被转化为数字,这个增值将会加到该变量原有的数字之上,变量不存在不会新增变量,对于压缩存储的变量不要使用本函数因为相应的取值方法会失败。 

2.17.2.参数

key 缓存值的键

var 值,整型将直接存储,其他类型将被序列化存储 

2.17.3.返回值

成功返回新的变量值,失败返回 FALSE。

2.17.4.范例

复制代码
<?php
/* procedural API */
$memcache_obj = memcache_connect(‘memcache_host‘, 11211);
/* increment counter by 2 */
$current_value = memcache_increment($memcache_obj, ‘counter‘, 2);
/* OO API */
$memcache_obj = new Memcache;
$memcache_obj->connect(‘memcache_host‘, 11211);
/* increment counter by 3 */
$current_value = $memcache_obj->increment(‘counter‘, 3);
?>
复制代码

2.18.Memcache::decrement

2.18.2.说明

int Memcache::decrement ( string $key [, int $value ] )

给指定 key 的缓存变量一个递减值,与 increment 操作类似,将在原有变量基础上减去这个值,该项的值将会在转化为数字后减去,新项的值不会小于 0,对于压缩存储的变量不要使用本函数因为相应的取值方法会失败。 

2.18.2.参数

key 缓存值的键

var 值,整型将直接存储,其他类型将被序列化存储 

2.18.3.返回值

成功返回新的变量值,失败返回 FALSE。 

2.18.4.范例

复制代码
<?php
/* procedural API */
$memcache_obj = memcache_connect(‘memcache_host‘, 11211);
/* decrement item by 2 */
$new_value = memcache_decrement($memcache_obj, ‘test_item‘, 2);
/* OO API */
$memcache_obj = new Memcache;
$memcache_obj->connect(‘memcache_host‘, 11211);
/* decrement item by 3 */
$new_value = $memcache_obj->decrement(‘test_item‘, 3);
?>
复制代码

2.19.memcache_debug

2.19.1.说明

bool memcache_debug ( bool $on_off )

设置 memcache 的调试器是否开启,值为 TRUE 或 FALSE。 受影响于 php 安装时是否使用了 --enable-debug 选项,如果使用了该函数才会返回 TRUE,其他情况将始终返回 FALSE。 

2.19.2.参数

on_off 设置调试模式是否开启,TRUE 为开启,FALSE 为关闭

2.19.3.返回值

php 安装时如果使使用了 --enable-debug 选项返回 TRUE,否则将返回 FALSE。

http://www.cnblogs.com/qiantuwuliang/archive/2011/03/07/1974499.html