Memcache::setServerParams
(PECL memcache >= 2.1.0)
Memcache::setServerParams — Changes server parameters and status at runtime
Description
$host
[, int $port
= 11211
[, int $timeout
[, int $retry_interval
= false
[, bool $status
[, callable $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.
Parameters
-
host
-
Point to the host where memcached is listening for connections.
-
port
-
Point to the port where memcached is listening for connections.
-
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
andretry_interval
to -1 allows a failed server to be kept in the pool so as not to affect the key distribution algorithm. Requests for this server will then failover or fail immediately depending on thememcache.allow_failover
setting. Default toTRUE
, 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 attempted. The function takes two parameters, the hostname and port of the failed server.
Return Values
Returns TRUE
on success or FALSE
on failure.
Examples
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');
?>
See Also
- Memcache::addServer() - Add a memcached server to connection pool
- Memcache::getServerStatus() - Returns server status
- Функция Memcache::add() - Add an item to the server
- Функция Memcache::addServer() - Add a memcached server to connection pool
- Функция Memcache::close() - Close memcached server connection
- Функция Memcache::connect() - Open memcached server connection
- Функция Memcache::decrement() - Decrement item's value
- Функция Memcache::delete() - Delete item from the server
- Функция Memcache::flush() - Flush all existing items at the server
- Функция Memcache::get() - Retrieve item from the server
- Функция Memcache::getExtendedStats() - Get statistics from all servers in pool
- Функция Memcache::getServerStatus() - Returns server status
- Функция Memcache::getStats() - Get statistics of the server
- Функция Memcache::getVersion() - Return version of the server
- Функция Memcache::increment() - Increment item's value
- Функция Memcache::pconnect() - Open memcached server persistent connection
- Функция Memcache::replace() - Replace value of the existing item
- Функция Memcache::set() - Store data at the server
- Функция Memcache::setCompressThreshold() - Enable automatic compression of large values
- Функция Memcache::setServerParams() - Changes server parameters and status at runtime
Коментарии
404 Not Found