PHP5中文手册·Changes server parameters and status at runtime -- 追寻梦想＞编程乐园＞PHP 编程

说明

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

Memcache::setServerParams() changes server parameters at runtime. You can also use the memcache_set_server_params() function.

Note: This function has been added to Memcache version 2.1.0.

参数

host: Point to the host where memcached is listening for connections.
port: Point to the port where memcached is listening for connections. This parameter is optional and its default value is 11211.
timeout: Value in seconds which will be used for connecting to the daemon. Think twice before changing the default value of 1 second - you can lose all the advantages of caching if your connection is too slow.
retry_interval: Controls how often a failed server will be retried, the default value is 15 seconds. Setting this parameter to -1 disables automatic retry. Neither this nor the persistent parameter has any effect when the extension is loaded dynamically via dl().
status: Controls if the server should be flagged as online. Setting this parameter to FALSE and retry_interval to -1 allows a failed server to be kept in the pool so as not to affect the key distribution algoritm. Requests for this server will then failover or fail immediatly depending on the memcache.allow_failover setting. Default to TRUE, meaning the server should be considered online.
failure_callback: Allows the user to specify a callback function to run upon encountering an error. The callback is run before failover is attemped. The function takes two parameters, the hostname and port of the failed server.

返回值

如果成功则返回 TRUE，失败则返回 FALSE。

范例

Example#1 Memcache::setServerParams() example


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

?>

参见

Memcache::addServer()
Memcache::getServerStatus()


	PHP5中文手册 Memcache mhash Memcache PHP Manual Memcache::setServerParams (No version information available, might be only in CVS) Memcache::setServerParams — Changes server parameters and status at runtime 说明 bool Memcache::setServerParams ( string `$host` [, int `$port` [, int `$timeout` [, int `$retry_interval` [, bool `$status` [, callback `$failure_callback` ]]]]] ) Memcache::setServerParams() changes server parameters at runtime. You can also use the memcache_set_server_params() function. Note: This function has been added to Memcache version 2.1.0. 参数 `host` Point to the host where memcached is listening for connections. `port` Point to the port where memcached is listening for connections. This parameter is optional and its default value is 11211. `timeout` Value in seconds which will be used for connecting to the daemon. Think twice before changing the default value of 1 second - you can lose all the advantages of caching if your connection is too slow. `retry_interval` Controls how often a failed server will be retried, the default value is 15 seconds. Setting this parameter to -1 disables automatic retry. Neither this nor the `persistent` parameter has any effect when the extension is loaded dynamically via dl(). `status` Controls if the server should be flagged as online. Setting this parameter to `FALSE` and `retry_interval` to -1 allows a failed server to be kept in the pool so as not to affect the key distribution algoritm. Requests for this server will then failover or fail immediatly depending on the `memcache.allow_failover` setting. Default to `TRUE`, meaning the server should be considered online. `failure_callback` Allows the user to specify a callback function to run upon encountering an error. The callback is run before failover is attemped. The function takes two parameters, the hostname and port of the failed server. 返回值如果成功则返回 `TRUE`，失败则返回 `FALSE`。范例 Example#1 Memcache::setServerParams() example <?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'); ?> 参见 Memcache::addServer()* Memcache::getServerStatus() Memcache mhash Memcache PHP Manual